Atlas

AI-Driven Structured Development Workflow | AI驱动的结构化开发工作流程

---

English Version

Overview

Atlas is an AI-driven development workflow that ensures traceability, reviewability, and high quality through mechanisms like phased execution, mandatory reviews, and TDD-driven implementation.

Core Principles

• Each phase has clear inputs, outputs, and exit criteria
• TDD-driven implementation
• All phases use subagents for context efficiency
• Direct source code reading (no pre-built knowledge base)

Workflow

User submits requirement
         │
         ▼
┌─────────────────────────┐
│ step1. requirement_analysis │  Requirements Analysis
└─────────────────────────┘
         │ User confirms
         ▼
┌─────────────────────────┐
│    step2. write_plan     │  Write Implementation Plan
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│     step3. task_splitter │  Split into Atomic Tasks
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│    step4. coding (TDD)   │  TDD Implementation
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│   step5. code_review    │  Code Review
└─────────────────────────┘
         │
         ▼
   Development Complete

Skills

The Atlas workflow consists of 5 Skills:

Skill	Description
requirement-analysis	Analyze requirements: background, scope, user stories, acceptance criteria
write-plan	Write detailed implementation plans with phases, steps, checkpoints, risk assessment
task-splitter	Split plans into atomic tasks (2-5 minutes/task)
coding	Strict TDD enforcement: Red-Green-Refactor cycle
code-review	Two-stage review: Spec compliance + Code quality

Directory Structure

skills/
├── requirement-analysis/     # Requirements analysis
│   ├── SKILL.md
│   └── templates/
│       └── requirement-template.md
├── write-plan/              # Implementation planning
│   ├── SKILL.md
│   └── templates/
│       └── plan-template.md
├── task-splitter/           # Task splitting
│   ├── SKILL.md
│   └── templates/
│       └── task-template.md
├── coding/                  # TDD coding
│   ├── SKILL.md
│   └── templates/
│       └── tdd-checklist.md
└── code-review/             # Code review
    ├── SKILL.md
    └── templates/
        └── code-review-template.md

Development Data Storage

Atlas stores all development data in .atlas/:

.atlas/
├── requirements/              # Requirements analysis documents
│   └── {requirement-id}.md
├── plans/                     # Implementation plans
│   └── {requirement-id}.md
├── tasks/                     # Split tasks
│   └── {requirement-id}/
│       ├── task-01.md
│       └── ...
└── code-review/               # Code review reports
    └── {requirement-id}.md

TDD Cycle

┌─────────────────────────────────────────────────────────────┐
│                        RED                                   │
│  Write a failing test, clarify what functionality to implement │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                       GREEN                                  │
│  Write minimal code to pass the test, don't overthink      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      REFACTOR                               │
│  Optimize code structure while keeping tests passing         │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
                         Next Test

Iron Law: No production code without a failing test first.

Use Cases

Atlas is suitable for:

• Complex Projects: Large development requiring strict process control
• Team Collaboration: Multi-person parallel development requiring documentation and traceability
• AI-assisted Development: As an AI agent work framework to ensure development quality

Comparison with Other Methodologies

Atlas Step	Similar Methodology	Notes
requirement-analysis	Agile User Story	More structured, mandatory clear boundaries
write-plan	FDD Feature	Specific executable plans
task-splitter	Agile Sprint Planning	2-5 minute granularity
coding	TDD	Iron law: Test first
code-review	Code Review	Two-stage mechanism

License

MIT

---

中文版本

概述

Atlas 是一个 AI 驱动的开发工作流程，通过分阶段执行、强制评审和TDD驱动实现等机制，确保开发的可追溯性、可审查性和高质量。

核心原则

• 每个阶段都有明确的输入、输出和退出标准
• TDD 驱动实现
• 所有阶段使用子代理提高上下文效率
• 直接读取源码（不依赖预建知识库）

工作流程

用户提交需求
         │
         ▼
┌─────────────────────────┐
│ step1. requirement_analysis │  需求分析
└─────────────────────────┘
         │ 用户确认
         ▼
┌─────────────────────────┐
│    step2. write_plan     │  编写实施计划
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│     step3. task_splitter │  任务拆分
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│    step4. coding (TDD)   │  TDD 编码实现
└─────────────────────────┘
         │
         ▼
┌─────────────────────────┐
│   step5. code_review    │  代码评审
└─────────────────────────┘
         │
         ▼
     开发完成

技能

Atlas 工作流程由 5 个技能 组成：

技能	描述
requirement-analysis	分析需求：背景、范围、用户故事、验收标准
write-plan	编写详细的实施计划，包含阶段、步骤、检查点、风险评估
task-splitter	将计划拆分为原子任务（每个任务 2-5 分钟）
coding	严格 TDD 强制执行：红-绿-重构循环
code-review	两阶段评审：规格合规性 + 代码质量

目录结构

skills/
├── requirement-analysis/     # 需求分析
│   ├── SKILL.md
│   └── templates/
│       └── requirement-template.md
├── write-plan/              # 实施计划
│   ├── SKILL.md
│   └── templates/
│       └── plan-template.md
├── task-splitter/           # 任务拆分
│   ├── SKILL.md
│   └── templates/
│       └── task-template.md
├── coding/                  # TDD 编码
│   ├── SKILL.md
│   └── templates/
│       └── tdd-checklist.md
└── code-review/             # 代码评审
    ├── SKILL.md
    └── templates/
        └── code-review-template.md

开发数据存储

Atlas 将所有开发数据存储在 .atlas/ 目录中：

.atlas/
├── requirements/              # 需求分析文档
│   └── {requirement-id}.md
├── plans/                     # 实施计划
│   └── {requirement-id}.md
├── tasks/                     # 拆分的任务
│   └── {requirement-id}/
│       ├── task-01.md
│       └── ...
└── code-review/               # 代码评审报告
    └── {requirement-id}.md

TDD 循环

┌─────────────────────────────────────────────────────────────┐
│                        红色阶段                              │
│  编写一个失败的测试，明确需要实现的功能                        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        绿色阶段                              │
│  编写最少量代码通过测试，不要过度思考                         │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        重构阶段                              │
│  在保持测试通过的前提下优化代码结构                           │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
                         下一个测试

铁律： 在没有失败测试的情况下，绝不编写生产代码。

适用场景

Atlas 适用于：

• 复杂项目：需要严格流程控制的大型开发
• 团队协作：需要文档和可追溯性的多人并行开发
• AI 辅助开发：作为 AI 代理的工作框架，确保开发质量

与其他方法论的对比

Atlas 步骤	类似方法论	说明
requirement-analysis	Agile User Story	更结构化，有明确的强制边界
write-plan	FDD Feature	具体的可执行计划
task-splitter	Agile Sprint Planning	2-5 分钟粒度
coding	TDD	铁律：测试优先
code-review	Code Review	两阶段机制

许可证

MIT