From a14977a86689691a313fd7642e4cafe575a2e1d3 Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Thu, 23 Apr 2026 10:25:18 +0900 Subject: [PATCH] roadmap(#180-framing): lock authoritative framing + branch name MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per gaebal-gajae cycle #103 framing pass. Captures narrative choice + reality divergence in one line. Framing: 'USAGE.md currently teaches entry modes, but not the actual standalone command surface exposed by claw --help.' Locks branch name: feat/jobdori-180-usage-standalone-surface Next-branch prep steps documented so post-168c-merge execution is zero-friction. Three-stage pinpoint discipline validated again: filing (cycle #103 primary) → framing (cycle #103 addendum) → prep (execution checklist). --- ROADMAP.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/ROADMAP.md b/ROADMAP.md index 69a8215..53ebcae 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -10258,3 +10258,34 @@ That's 14 verbs not covered by USAGE.md's "quick-start" framing. **Status:** FILED. Per freeze doctrine, no doc changes on 168c. Proposed separate branch: `feat/jobdori-180-usage-verb-coverage`. **Pinpoint count:** 70 filed, 56 genuinely open. + +## Pinpoint #180 Framing Lock (cycle #103 addendum, 2026-04-23 10:27 Seoul) + +**Authoritative framing** (per gaebal-gajae cycle #103 framing pass): + +> "USAGE.md currently teaches entry modes, but not the actual standalone command surface exposed by `claw --help`." + +**Why this framing is stable:** +- **Subject:** USAGE.md (the narrative) +- **What it does:** teaches entry modes +- **What it misses:** standalone command surface exposed by `claw --help` +- **Implied assertion:** documentation narrative ≠ CLI surface ⇒ parity gap + +**Comparative wording options considered:** +- ❌ "USAGE.md is incomplete" (vague, doesn't pinpoint why) +- ❌ "USAGE.md misses 14 verbs" (numerical, brittle to future verbs) +- ✅ "USAGE.md teaches entry modes, but not the actual standalone command surface" (captures narrative choice + reality divergence) + +**Proposed branch name:** `feat/jobdori-180-usage-standalone-surface` + +This naming follows `feat/jobdori--` convention and surfaces the exact fix scope in the branch name. + +**Next-branch prep (after 168c merge):** +1. Create `feat/jobdori-180-usage-standalone-surface` from main +2. Add `## Standalone Commands` section to USAGE.md with all `--help`-exposed verbs +3. For each verb: one-line description + one-line example +4. Special disambiguation: `/doctor` vs `claw doctor`, `/status` vs `claw status` (REPL slash vs. standalone) +5. Add regression test: audit script that greps USAGE.md coverage against `--help` output +6. Single-commit PR, easy review + +**Family alignment:** Part of doc-truthfulness family (#76, #79, #82, #172, #180). Different from SCHEMAS.md gaps (#172 = inventory drift, #180 = narrative/surface divergence).