# Playbook: New Project From Scaffold

## Purpose
为全新项目提供一条从 `Setup -> Research -> Spec -> Code -> Alignment` 的标准启动路径，先固化规则，再进入实现。

## When to Use
- 绿地项目
- 现有目录几乎为空，需要从标准脚手架和规范开始
- 团队希望统一技术轨道、模型路由和阶段产物

## Inputs
- 项目目标
- 原始会议纪要
- 初始目录
- 目标交付范围

## Outputs
- `CLAUDE.md`
- `.ralphy/config.yaml`
- `.research/*.md`
- `SPECS/*.md`
- 第一轮实施计划与任务清单

## Primary Agent/Model
主控/计划 agent + `GPT-5.4 Pro xhigh`

## Secondary Agent/Model
研究/审查 agent + `Claude Opus 4.6`

## Required Skills
- `ralphy-initializing`
- `spec-tasking`
- `spec-reviewing`
- `tdd-planning`
- `tdd-implementing`

## Steps
1. 跑 `Setup`，清洗会议、固定技术轨道、生成 `CLAUDE.md`。
2. 跑 `Research`，对照参考仓库生成主题化研究报告。
3. 跑 `Spec`，形成 `SPECS/*.md` 并完成人工审核。
4. 跑 `Code`，用 TDD 和检查点重构实施第一轮代码。
5. 跑 `Alignment`，补齐遗漏和偏离。

## Exit Criteria
- 项目已形成可复用的规范层和可执行实施层
- 新成员可从 `CLAUDE.md`、`SPECS/*.md` 和 `TODO.yaml` 直接接手

## Failure Recovery
- 如果参考仓库质量不足，先补 Research，不要提前写 Spec
- 如果 Spec 审核不过，禁止进入 Code

## Related Templates
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
- [`../templates/spec-template.md`](../templates/spec-template.md)
- [`../templates/todo-yaml-template.md`](../templates/todo-yaml-template.md)

## Stable Knowledge Vs Runtime Context
- 稳定知识：技术栈白名单、阶段流程、模板、handoff 契约
- 运行时上下文：当前项目目标、当前会议决策、当前参考仓库结论

## First-Round Prompt Kit

### Prompt 1: Setup
```text
基于当前项目会议纪要和目录，按知识库的 Setup 流程生成项目初始化产物。固定技术轨道，只保留一个主路径；输出清洗后的会议要点、CLAUDE.md 草案、.ralphy/config.yaml 草案，以及进入 Research 的 handoff。
```

### Prompt 2: Research
```text
基于 CLAUDE.md、已选技术轨道和 .references/ 参考仓库，生成 ANALYSIS.md 和 TODO.yaml，并按主题产出 .research/*.md。只保留与当前项目目标相关的方案比较、推荐做法和拒绝理由。
```

### Prompt 3: Spec
```text
基于 .research/*.md 和业务目标，生成 SPECS/*.md。先生成 ANALYSIS.md 与 TODO.yaml，再产出 Spec；完成后执行 spec-reviewing，并整理出等待人工审核的问题清单。
```

## Stage Deliverables
- Setup：`.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md`
- Research：`ANALYSIS.md`, `TODO.yaml`, `.research/*.md`
- Spec：`SPECS/*.md`, 审查结论, 人工审核结论
- Code：`.plans/*.md`, 代码与测试
- Alignment：缺口分析、补齐实现、重构检查点结果

## Acceptance Checklist
- 技术轨道只有一个主路线
- `CLAUDE.md` 已固定规则与禁用项
- `SPECS/*.md` 已通过人工审核
- 第一轮代码实施与 Alignment 已经形成闭环