sf-tech-design

运行目录

执行任何 node .specforge/... 命令或读取 .specforge/... 文件前，必须先定位宿主项目根：项目根是“包含 .specforge/ 目录的业务项目目录”，不是 .specforge/ 目录本身。若当前目录是 .specforge/ 或其任意子目录，先 cd .. 回到宿主项目根；若当前目录是 frontend/、backend/ 等子目录，也先向上回到包含 .specforge/ 的项目根。禁止从 .specforge/ 内执行 node .specforge/core/scripts/...，否则会形成 .specforge/.specforge/... 的错误路径。

运行模式检测

1. 当前目录向上存在 .specforge/ 且有 active work item：Embedded 模式，按 artifact graph 写入 01-spec/technical-design.md，并遵守选型 / 依赖 / 工具链 / 核心决策 review 门禁。
2. 存在 .specforge/ 但无 active work item：Lightweight 模式，可先做技术影响面、候选方案和风险草稿；需要落档时输出 specforge-import-ready.md 格式内容，或先路由 sf-intake 创建 work item。
3. 不存在 .specforge/：Standalone 模式，不要运行 .specforge/... 命令；输出可导入的 specforge-import-ready.md，必须区分用户已确认、沿用现有栈、用户授权默认和 Agent recommendation。

sf-tech-design 把 requirements 和可选 UI design 转成可实现、可审查、可验证、可运行、可维护的工程设计。它不负责画页面线稿或决定视觉风格。

必读