mirror of
https://github.com/ultraworkers/claw-code.git
synced 2026-04-24 13:08:11 +08:00
roadmap(#153): file + close pinpoint — binary PATH instructions + verification bridge
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.
This commit is contained in:
parent
6212f17c93
commit
5736f364a9
31
ROADMAP.md
31
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`.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user