Spec-First

Graph Bootstrap 指南 ​

spec-graph-bootstrap 在 setup ready 后运行，用于编译 canonical graph readiness facts、provider status 和 impact readiness artifacts。它不替代 LLM 判断，也不是旧版 Stage-0 facts 注入流水线。

使用方式 ​

宿主入口
Claude Code/spec:graph-bootstrap
Codex$spec-graph-bootstrap

建议在 spec-mcp-setup 完成后运行。对于 parent workspace，child repo 的 graph facts 仍以各自仓库的 .spec-first/ 为准，父 workspace 只能提供 advisory summary。

执行逻辑图 ​

text
用户运行 /spec:graph-bootstrap 或 $spec-graph-bootstrap
  |
  v
读取 .spec-first/config/* 和 provider artifact contract
  |
  v
检查 provider 是否 configured / reachable / fresh
  |
  +-- provider 不可用
  |     |
  |     v
  |   写入 degraded status，说明后续必须 bounded direct reads
  |
  +-- provider 可用
        |
        v
      运行 provider bootstrap / sync / normalize
        |
        v
      写入 .spec-first/providers/* 和 .spec-first/graph/*
        |
        v
      编译 .spec-first/impact/* capability envelope
        |
        v
      向 plan / work / review 暴露 query_ready 限制和证据路径

产物边界 ​

目录作用
.spec-first/graph/canonical graph readiness facts 和 bootstrap report
.spec-first/providers/<provider>/provider 状态、日志和 normalized facts
.spec-first/impact/context selection、impact radius 和 review support 的 capability envelope

当 facts missing、stale、blocked 或 degraded 时，下游 plan、work、review 不能假装 graph ready，应回退到明确范围内的直接代码读取。

下一步 ​

对于 brownfield 或团队协作项目，graph bootstrap 后可以进入 spec-standards，建立项目规范与 glue capability baseline：

text
spec-mcp-setup
→ spec-graph-bootstrap
→ spec-standards
→ brainstorm / plan / work / review