From 5736f364a934c13fe331a08784303435ecbfe71b Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Thu, 23 Apr 2026 07:52:41 +0900 Subject: [PATCH] =?UTF-8?q?roadmap(#153):=20file=20+=20close=20pinpoint=20?= =?UTF-8?q?=E2=80=94=20binary=20PATH=20instructions=20+=20verification=20b?= =?UTF-8?q?ridge?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cycle #96 dogfood found practical install-experience gap in USAGE.md. #153 closed by commit 6212f17 (same branch, same cycle). Part of discoverability family (#155, help/USAGE parity). Pinpoint count: 62 filed, 51 genuinely-open + #153 closed this cycle. --- ROADMAP.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/ROADMAP.md b/ROADMAP.md index 6551476..490aae7 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -9804,3 +9804,34 @@ All four were emitting `kind: "unknown"` in JSON envelope. **Closed:** Yes — shipped in cycle #95, feature branch `feat/jobdori-168c-emission-routing`, commit `1a4d0e4`. + +## Pinpoint #153. README/USAGE missing "add binary to PATH" and "verify install" bridge — SHIPPED (cycle #96, 2026-04-23 07:52 Seoul) + +**Gap.** USAGE.md had "Install / build the workspace" section with build command, but immediately jumped to "Quick start" examples. Missing: +1. How to add the compiled binary to system PATH (symlink vs export) +2. How to verify the install works +3. Troubleshooting guide for common PATH issues + +Developers building from source had to figure out either `./rust/target/debug/claw` every time or guess how to add the binary to PATH. + +**Fix shipped.** Commit `6212f17` on `feat/jobdori-168c-emission-routing`. + +Added two new subsections under "## Install / build the workspace": + +**"### Add binary to PATH"** +- Option 1: Symlink to existing PATH directory (most portable) +- Option 2: Add binary directory to PATH via shell rc file (direct approach) +- Includes verification step (`which claw`) + +**"### Verify install"** +- Three health checks: `claw version`, `claw doctor`, `claw --help` +- Troubleshooting guide if `claw: command not found` + - Check that PATH-dir is in `$PATH` + - Verify symlink or binary exists + - Show user how to diagnose + +**Tests:** 225/225 pass (doc-only change). + +**Family:** Discoverability / bridge documentation. Related: #155 (help/USAGE parity). + +**Closed:** Yes — shipped in cycle #96, feature branch `feat/jobdori-168c-emission-routing`, commit `6212f17`.