Agent Development Specification

Agent Development Specification (ADS)

[](LICENSE) [](https://claude.com/claude-code) [](https://docs.claude.com/en/docs/claude-code) [](https://www.python.org/) [](https://github.com/SmartSunruiyang/agent-development-specification/pulls)

**Topics:** `claude-code` · `claude-code-skills` · `agent-skills` · `ai-agents` · `project-scaffolding` · `software-architecture` · `documentation` · `vibe-coding`

**Jump to:** [What it generates](#what-it-generates) · [Install](#install) · [Usage](#usage) · [How it works](#how-it-works) · [Evaluation](#evaluation) · [License](LICENSE) · [中文说明](#中文说明)

A universal, tech-stack-agnostic [**Claude Code**](https://claude.com/claude-code) skill that lays down a project's agent-governance rules, documentation, and architecture **before the first line of code** — and keeps them the source of truth as the project grows.

The governing idea, learned the hard way from AI-assisted "vibe coding":

1. Version control from day 0 — initialize the repo before writing any code.
2. Documentation before code — requirements, architecture, roadmap, conventions are decided up front, not back-filled.
3. Architecture > UI > polish — a project where any bug can instantly be pinned to one module outlives a pretty but tangled one by an order of magnitude.

ADS turns those lessons into an executable workflow. Run it in any repo and it scaffolds a complete governance system, then interviews you to fill it with real, project-specific content.

---

important ！！

你应当第一步先单独与 agent沟通 PRD，之后在 Skills 问你你的项目是关于什么的时候，直接把 PRD 提供进去，跳过引导你完成 PRD。UIUX 同理，你也可以自己准备，同样可以跟随引导。 You should first comm