SmartSunruiyang/Agent-development-specification

53 stars · Last commit 2026-06-01

一个通用、不绑定技术栈的 Claude Code 技能：在写第一行代码之前，先为项目铺好 Agent 规则、文档与架构，并在项目演进中持续把它们当作"源真相"。

README preview

# Agent Development Specification (ADS)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-d97757)](https://claude.com/claude-code)
[![Agent Skill](https://img.shields.io/badge/Agent-Skill-5436DA)](https://docs.claude.com/en/docs/claude-code)
[![Python 3](https://img.shields.io/badge/Python-3-3776AB?logo=python&logoColor=white)](https://www.python.org/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](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.

View full repository on GitHub →