skills/cc-switch-dev-workflow/references/knowledge-base/playbooks/new-project-from-scaffold.md

Playbook: New Project From Scaffold

Purpose

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

When to Use

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

Inputs

• 项目目标
• 原始会议纪要
• 初始目录
• 目标交付范围

Outputs

• CLAUDE.md
• AGENTS.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/analysis-template.md
• ../templates/spec-template.md
• ../templates/todo-yaml-template.md

Stable Knowledge Vs Runtime Context

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

First-Round Prompt Kit

Prompt 1: Setup

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

Prompt 2: Research

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

Prompt 3: Spec

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

Stage Deliverables

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

Acceptance Checklist

• 技术轨道只有一个主路线
• CLAUDE.md 已固定规则与禁用项
• AGENTS.md 已为 Codex 固定读文件顺序、边界和升级点
• SPECS/*.md 已通过人工审核
• 第一轮代码实施与 Alignment 已经形成闭环