Individual skill
agent-development-specification
Bootstraps the Day-0 agent-governance + documentation scaffold for ANY project on ANY stack. Generates the agent rule system (CLAUDE.md, AGENTS.md, SELF_CONSTRAINTS.md, VIBECODING_GUIDE.md) plus upstream docs (PRD, ARCHITECTURE with module cards + dependency DAG, ROADMAP, CONVENTIONS), initializes version control with a zero-point commit, and runs a guided requirements→architecture interview to fill them with real content. Works for greenfield AND retrofitting an existing codebase (reverse-engineers a draft architecture from the code). Use whenever the user runs /ads:init or /agent-development-specification, starts a NEW project, or asks to set up agent rules / governance / project spec / self-constraints, scaffold CLAUDE.md / AGENTS.md / architecture docs, establish module boundaries before coding, or mentions 项目起步 / 起步指南 / Agent规范 / 自我约束 / 架构文档. Trigger even when the user doesn't say "skill" or "ads": laying down a project's rules, docs, and architecture before writing code is this skill's job.
SKILL.md
Source commit 44eec9b88f919fd6684c6429b8a24e4686e31202
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Local scripts
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 149
- Repository last updated
- Jun 1, 2026
- License
- MIT
Observed agent integration: codex
- engineering Derived category
- writing Derived category
- docs Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
LICENSEasset · 1,062 bytesREADME.mddoc · 10,916 bytesSKILL.mdcore · 10,159 bytesSKILL.mdcore · 10,159 bytesSKILL.mdcore · 10,159 bytesSKILL.mdcore · 10,159 bytesSKILL.mdcore · 10,159 bytesassets/templates/AGENTS.mddoc · 3,907 bytesassets/templates/CLAUDE.mddoc · 3,686 bytesassets/templates/SELF_CONSTRAINTS.mddoc · 7,208 bytesassets/templates/VIBECODING_GUIDE.mddoc · 12,449 bytesassets/templates/docs/ARCHITECTURE.mddoc · 3,632 bytesassets/templates/docs/CONVENTIONS.mddoc · 2,619 bytesassets/templates/docs/PRD.mddoc · 2,416 bytesassets/templates/docs/ROADMAP.mddoc · 1,842 bytesassets/templates/docs/UIUX.mddoc · 1,371 bytesassets/templates/gitignore-baseasset · 523 bytesassets/templates/log-README.mddoc · 1,455 bytesassets/templates/settings.jsonasset · 74 bytesdist/agent-development-specification.skillasset · 49,805 bytesevals/evals.jsonasset · 4,471 bytesreferences/interview-flow.mddoc · 4,813 bytesreferences/retrofit.mddoc · 3,434 bytesreferences/spec.mddoc · 29,231 bytesscripts/scaffold.pyruns · 8,622 bytes
Read excerpt
# Agent Development Specification (ADS)
This skill installs a **project-startup governance system**: the agent rules, the upstream
documents, and the architecture that must exist *before* code, so that every later session —
yours or another agent's — works against a stable source of truth instead of free-styling on a
codebase nobody can fully see.
The full rationale lives in `references/spec.md` (the canonical, technology-agnostic spec).
Read it when you need depth on *why* a rule exists; this file tells you *what to do*.
## Prime directive: obey the rules you install
This skill's output is a set of hard constraints (`SELF_CONSTRAINTS.md`) and a practice guide.
You must follow them while running init — installing a rulebook you then violate is worse than