用途:在开始新项目、应用、工具、脚本或构建前,先把项目结构搭好,避免泄露密钥、遗忘决策或让新会话从零重建已有内容。流程要求按顺序执行,先于功能代码。
使用方式:第一步用一条简短消息提出五个问题:这个项目一句话做什么、谁使用、存储哪些数据及是否敏感、部署在哪里、已有哪些资源。若用户说“直接建”,则采用合理默认值,但必须把默认值写入决策日志。第二步搭建骨架:git init;在任何密钥出现前先建 .gitignore(至少含 .env*、node_modules/、dist/、.next/、.DS_Store 等);创建只含占位符的 .env.example,真实值放 .env 且不提交;写十行以内的 README;填写 CLAUDE.md(项目手册),包含项目说明、技术栈及原因、结构、命令、决策日志、注意事项。第三步选择常见工具而非新奇工具,若选新工具需在决策日志写一行说明收益。第四步养成习惯:每次可用变更后提交,提交信息写原因;启动时校验环境变量并明确报错;统一错误处理模式;随时追加决策日志。
适用场景:Web 应用、一次性自动化脚本等新项目的初始搭建。
限制与完成标准:资料给出“月份测试”——全新零历史会话仅凭仓库文件应能回答项目是什么、如何运行、为何这样构建、什么不该动及原因;否则基础未完成。设置完成标准包括 git 初始化并首次提交、.gitignore 先于密钥存在、.env.example 列出全部变量、.env 未跟踪、README 说明内容与运行方式、CLAUDE.md 已填写且至少有决策日志、技术栈常见或已写原因、缺失环境变量时大声失败。资料未提供具体收费、平台或效果信息。