{
  "schema_version": "prompt-examples/v1",
  "skill": "using-spec-first",
  "examples": [
    {
      "name": "clear implementation request needs plan before work",
      "user_intent": "用户要求直接开发一个新能力，但只描述了目标，没有 settled plan 或 task pack。",
      "expected_posture": "推荐当前 host 的 plan entrypoint 或 task compilation path，而不是直接进入 mutating work。",
      "boundary_note": "不要把 using-spec-first 变成 brainstorm 默认入口；只在 HOW 未定时路由到 plan。",
      "negative_signal": "没有确认 execution plan 就开始修改 source 文件。",
      "context_snippets": ["desired outcome is clear", "implementation path is not settled"],
      "source_note": "existing prompt clause: Routing Priority distinguishes execution planning from work",
      "id": "clear-implementation-request-needs-plan-before-work",
      "coverage_tags": ["trigger"]
    },
    {
      "name": "document review routes to doc-review",
      "user_intent": "用户给出一个 requirements 或 plan 文档路径，要求审查内容质量。",
      "expected_posture": "推荐 `$spec-doc-review`，让 doc-review workflow 拥有 persona selection、findings synthesis、授权时的 bounded dispatch 和未授权时的 report-only fallback。",
      "boundary_note": "不要把文档审查误当成 `$spec-work` 执行，也不要把路由到 `$spec-doc-review` 当作 Codex `spawn_agent` 显式授权。",
      "negative_signal": "直接编辑代码、执行计划，或在未显式授权 subagents / parallel reviewers 时启动 Codex `spawn_agent`。",
      "context_snippets": ["requirements, plan, spec, or markdown document review", "doc-review before implementation"],
      "source_note": "existing prompt clause: Route Map maps requirements/plan markdown review to doc-review",
      "id": "document-review-routes-to-doc-review",
      "coverage_tags": ["expected"]
    },
    {
      "name": "direct doc-review route is not subagent authorization",
      "user_intent": "用户输入 `$spec-doc-review` 或 `spec-doc-review` 要求审查文档，但没有要求 subagents、delegated review、parallel agents 或 persona reviewer dispatch。",
      "expected_posture": "路由到当前 host 的 document-review workflow；在 Codex 中不要调用 `spawn_agent`，让 doc-review 记录 `dispatch_authorization_missing` 并走 single-agent report-only fallback。",
      "boundary_note": "public workflow admission authorizes workflow execution, not host-level subagent tools whose contract requires explicit wording.",
      "negative_signal": "把 `$spec-doc-review` 入口本身解释成 explicit `spawn_agent` authorization。",
      "context_snippets": ["It does not by itself override host-level subagent tool contracts", "explicit dispatch authorization is absent"],
      "source_note": "current Codex tool contract: direct workflow invocation alone is not subagent authorization",
      "id": "direct-doc-review-route-is-not-subagent-authorization",
      "coverage_tags": ["boundary"]
    },
    {
      "name": "parent workspace write scope is ambiguous",
      "user_intent": "用户在包含多个 git repo 的父目录里要求修改项目，但没有说明目标子仓库。",
      "expected_posture": "先要求明确 target repo 或选择 child-local workflow scope；只读 orientation 可以使用 advisory candidates。",
      "boundary_note": "写入、测试、review autofix 或 commit 前必须有明确 repo scope。",
      "negative_signal": "在父目录写 `.spec-first` 或跨多个 child repo 修改文件。",
      "context_snippets": ["parent workspace containing multiple independent Git repos", "target_repo missing"],
      "source_note": "current source/runtime governance rule: workspace repo scope guard in using-spec-first and work workflows",
      "id": "parent-workspace-write-scope-is-ambiguous",
      "coverage_tags": ["boundary", "failure"]
    },
    {
      "name": "report-only request disables reviewer dispatch",
      "user_intent": "用户要求 review 但明确指定 report-only、no-agents 或禁用 helper dispatch。",
      "expected_posture": "推荐对应 review workflow 的 report-only fallback，不启动 persona dispatch。",
      "boundary_note": "用户显式禁用 helper agents 时，不能仍然尝试 dispatch 并声称多 persona 已跑。",
      "negative_signal": "忽略 report-only/no-agents 约束，继续启动 subagents。",
      "context_snippets": ["report-only", "dispatch unavailable or disabled"],
      "source_note": "known failure mode: review workflows must distinguish dispatch availability from report-only fallback",
      "id": "report-only-request-disables-reviewer-dispatch",
      "coverage_tags": ["boundary"]
    },
    {
      "name": "lightweight explanation stays direct",
      "user_intent": "用户只是问某个 workflow 的含义、某个文件在哪里，或要求简短解释。",
      "expected_posture": "直接回答或做窄事实查询，不启动 public workflow。",
      "boundary_note": "using-spec-first 不应把轻量问答升级成 brainstorm、plan 或 work。",
      "negative_signal": "为一个解释性问题生成计划、修改文件或运行 mutating command。",
      "context_snippets": ["lightweight factual answers", "narrow code-location questions"],
      "source_note": "existing prompt clause: What Counts as Substantial Work excludes lightweight factual answers",
      "id": "lightweight-explanation-stays-direct",
      "coverage_tags": ["boundary"]
    }
  ],
  "source_refs": ["skills/using-spec-first/SKILL.md"],
  "source_ref_authority": "source"
}