Clean break, no compatibility alias. Renames the product name, the CLI binary (`ccam` -> `agenthub`), the env var prefix (`CCAM_` -> `AGENTHUB_`), the Prometheus metric namespace (`ccam_*` -> `agenthub_*`), the tmux session prefix (`ccam-lane-<id>` -> `agenthub-lane-<id>`), the per-repo runtime profile directory (`.ccam/profile` -> `.agenthub/profile`), the lanes state root (`~/.claude/ccam-lanes` -> `~/.claude/agenthub-lanes`), the bundled plugins (`plugins/ccam*` -> `plugins/agenthub*`) and their slash commands (`/ccam-doctor` -> `/agenthub-doctor`, `/ccam:*` -> `/agenthub:*`). Because there is no alias, an existing install has to be updated by hand: rename its `.ccam/profile` directory and any `CCAM_*` variables, and reinstall the plugin under its new name. Two other name families are deliberately left alone here, since they are not just strings: the `Claude-Code-Monitor` repository/marketplace name, and the `agent-dashboard` npm package plus its `~/.claude/agent-dashboard` runtime directory, which holds the live database and needs a migration rather than a rename. Verified: server 1406/1406, client 459/459, `grep -i ccam` clean across tracked files, `openapi.yaml` regenerated (95 paths, unchanged count).
3.3 KiB
F3b — agenthub skills install: making /ship-feature-lane actually invokable
Status: approved 2026-08-05. Roadmap it belongs to:
docs/superpowers/plans/2026-08-03-shipyard-parity-lanes.md (subsystem E, a gap found auditing E1-F3a for Shipyard parity).
Problem
.claude/skills/ship-feature-lane/SKILL.md's own description says "Invoke inside a lane's working directory" — but Claude Code only auto-discovers a .claude/skills/ directory when the session's cwd is inside the repo that OWNS that directory. The skill lives only at agenthub-lanes/.claude/skills/ship-feature-lane/SKILL.md; confirmed empty: ~/.claude/skills/ has no ship-feature-lane entry. Every piece built across E1/E2/E3/F1/F3a is unreachable from its actual intended invocation context — a session inside some OTHER lane's repo, not inside agenthub-lanes itself.
Shipyard's own install-claude-assets.sh solves exactly this: it copies bundled skills into ~/.claude/skills/ (user-level, global) so every project's session sees them.
Scope
In scope:
agenthub skills install— copies<agenthub-lanes repo>/.claude/skills/ship-feature-lane/to~/.claude/skills/ship-feature-lane/, overwriting on reinstall (same "reinstall, not merge" shape asagenthub lanes agents install).docs/LANES.mdnote.
Out of scope:
- Changing
agenthub lanes agents install's existing per-lane.claude/agents/mechanism. That one's already reachable correctly (Claude Code discovers.claude/agents/from the lane's own cwd, which IS where a driving session runs) — this gap is specific to the SKILL, not the agents. No architecture change needed there. - Auto-running this from
npm run setupor any other command. Explicit, like every other install primitive in this codebase (lanes agents install,lanes mcp sync,lanes proof-link) — a human runs it once per machine. - Any other bundled skill Shipyard ships (
/review-prs,/harness-adapt) — AgentHub has no equivalent of either; out of scope by the same reasoningpr-reviewerwas dropped (no driving skill to attach to).
Design
bin/agenthub.js already has REPO_ROOT (path.resolve(path.dirname(fs.realpathSync(__filename)), "..")) — the exact self-location primitive Shipyard needed HARNESS_ROOT for, already present because agenthub is npm-linked. No new resolution logic needed.
cmdSkillsInstall()inbin/agenthub.js(no HTTP round-trip — this has nothing to do with any lane or the dashboard's DB, purely a local file copy from the CLI's own checkout to the user's home directory; matches the existing local-only patterncmdLanesProfileInitalready uses viaREPO_ROOT).- Copies
path.join(REPO_ROOT, ".claude", "skills", "ship-feature-lane")→path.join(os.homedir(), ".claude", "skills", "ship-feature-lane")viafs.cpSync(..., {recursive: true, force: true})(force: true = overwrite existing files, matching reinstall semantics). - Command:
agenthub skills install, no lane argument (nothing lane-specific here).
Verify
A unit test isn't practical for a command that writes into the real $HOME — instead: a manual smoke check (run the command, confirm ~/.claude/skills/ship-feature-lane/SKILL.md exists and matches the repo's own copy byte-for-byte), same verification shape this repo already uses for routes with no HTTP test harness.