AI Dev Workflow System

简体中文

AI Dev Workflow System is an open-source workflow template for turning AI coding tools into a more reliable software delivery process.

It provides structured roles, phase gates, artifact handoffs, test loops, and adapter files for Codex, Claude Code, Cursor, Gemini CLI, and GitHub Copilot.

Why This Exists

Modern AI coding tools are powerful, but large tasks often fail for predictable reasons:

• requirements are vague;
• architecture decisions are implicit;
• the agent edits before observing the codebase;
• tests are skipped or treated as optional;
• review feedback is not fed back into implementation;
• context is lost between long sessions.

This project turns those problems into an explicit engineering workflow:

requirements -> architecture -> implementation -> testing -> review -> repair loop

Keywords

AI coding workflow, Codex AGENTS.md, Claude Code subagents, Cursor rules, Gemini CLI GEMINI.md, GitHub Copilot custom instructions, multi-agent software development, AI software engineering, test-driven AI coding, AI code review workflow.

Features

• Tool-agnostic workflow: works across Codex, Claude Code, Cursor, Gemini CLI, and GitHub Copilot.
• Role-based agents: requirements analyst, architect, developer, tester, reviewer, and orchestrator.
• Phase gates: each phase must produce artifacts before the next phase starts.
• File-based memory: requirements.md, architecture.md, dev-plan.md, main-log.md, and test-reports/ keep work recoverable.
• Repair loop: failed tests or code reviews are sent back to the developer role for correction.
• Bilingual docs: English and Chinese documentation for wider adoption.
• SEO-ready repo metadata: suggested topics, descriptions, and GitHub templates are included.

Repository Layout

.
├── README.md
├── README.zh-CN.md
├── software-dev-system/
│   ├── README.md
│   ├── README.en.md
│   ├── agents/
│   │   ├── orchestrator.md
│   │   ├── requirements.md
│   │   ├── architect.md
│   │   ├── developer.md
│   │   ├── tester.md
│   │   └── reviewer.md
│   └── adapters/
│       ├── codex/AGENTS.md
│       ├── claude-code/README.md
│       ├── cursor/README.md
│       ├── gemini-cli/GEMINI.md
│       └── github-copilot/copilot-instructions.md
├── docs/
├── scripts/
└── .github/

Supported AI Coding Tools

Tool	Entry File	Notes
Codex	software-dev-system/adapters/codex/AGENTS.md	Recommended for Codex projects using AGENTS.md.
Claude Code	software-dev-system/agents/*.md	Copy into .claude/agents/ to use native subagents.
Cursor	AGENTS.md or .cursor/rules	Use the adapter guidance to convert the workflow into Cursor rules.
Gemini CLI	software-dev-system/adapters/gemini-cli/GEMINI.md	Copy to GEMINI.md in your target project.
GitHub Copilot	software-dev-system/adapters/github-copilot/copilot-instructions.md	Copy into .github/copilot-instructions.md.

Quick Start

Codex

cp software-dev-system/adapters/codex/AGENTS.md /path/to/your-project/AGENTS.md

Then ask Codex:

Follow AGENTS.md and run the AI Dev Workflow System.

Project request: {your project request}
Project type: {web app / API / desktop app / game / mini program / other}
Tech stack: {your stack}
Output directory: {PROJECT_DIR}

Claude Code

Copy the six role files into your target project:

.claude/agents/
├── orchestrator.md
├── requirements.md
├── architect.md
├── developer.md
├── tester.md
└── reviewer.md

Then ask Claude Code to start with the orchestrator role.

How It Works

1. Requirements: convert vague intent into a structured PRD.
2. Architecture: define technical decisions, APIs, data models, and the development plan.
3. Development: implement one task at a time using observe-think-act and TDD when possible.
4. Testing: verify behavior against acceptance criteria.
5. Review: inspect security, maintainability, performance, and architecture consistency.
6. Repair: failed reports go back to the developer role until fixed or blocked.

Recommended GitHub Topics

Use these topics after creating the repository:

ai-coding
agents-md
codex
claude-code
cursor
gemini-cli
github-copilot
multi-agent
software-engineering
developer-tools
ai-code-review
tdd
workflow-automation

Validation

Run the local repository check:

powershell -ExecutionPolicy Bypass -File scripts/validate-repo.ps1

Roadmap

See Roadmap and 路线图.

Contributing

Contributions are welcome. See CONTRIBUTING.md and CONTRIBUTING.zh-CN.md.

License

MIT License. See LICENSE.