release(website): docs Full Harness Bundle + install commands fix + minor cleanups#359
Merged
Conversation
…skill/--plugin X` commands
The `npx skills` CLI does not accept `--skill` or `--plugin` flags for plugin-
marketplace repos, and `ForgePlan/marketplace` is not a standalone-skill repo
(no root `SKILL.md`). All 20 occurrences across 10 files (5 EN + 5 RU mirror)
have been replaced with working commands:
- Forge skill (offline, built into binary):
`forgeplan setup-skill` # writes ~/.claude/skills/forge/SKILL.md
- Specific marketplace plugin (from inside a Claude Code session):
`/plugin marketplace add ForgePlan/marketplace`
`/plugin install <name>@ForgePlan-marketplace`
Files touched:
website/src/content/docs/docs/getting-started/installation.md
website/src/content/docs/docs/marketplace/{overview,forgeplan-workflow,dev-toolkit,sparc,commands}.md
website/src/content/docs/docs/methodology/overview.md
website/src/content/docs/docs/cli/{index,setup-skill}.md
website/src/content/docs/docs/guides/fpf.md
(+ RU mirror at website/src/content/docs/ru/docs/...)
Root cause: docs were written 2026-04-11 as a single "catch-up" sprint
("docs v0.18.0 catch-up — 147 pages, full CLI+MCP reference, marketplace
integration"). The `--skill/--plugin` flag pattern was aspirational — it does
not exist in skills.sh CLI. No CI gate validated commands before publish, so
the bug shipped and stayed for 46 days until first-touch users hit it.
Out of scope (future PRs):
- plugin catalog drift on /docs/marketplace/overview/ (6 vs 16 plugins)
- 21 missing CLI command pages
- MCP tool count (73 → 66)
- new pages for /smith, /forgeplan-cookbook, forgeplan migrate-secrets,
forgeplan mcp install
- CI sync workflow to prevent re-drift (EVID-113 hypothesis H2)
After installing the /forge skill (the previous section), users often need
the full Forgeplan harness — /smith master orchestrator, /forge-cycle
pipeline driver, audit/sprint commands, canonical Profile A/B/C/D agents,
FPF ADI, Hindsight memory. Without this guidance, users follow only the
/forge skill setup, then hit /smith-bootstrap Step 0a halt ("5 MUST
plugins missing") with no idea where to look.
This commit adds a "Full Harness Bundle (Claude Code)" section listing:
- 5 MUST plugins (fpl-skills, agents-pro, agents-sparc, agents-core,
forgeplan-workflow) — what /smith-bootstrap Step 0a requires
- 2 SHOULD plugins (fpf for ADI reasoning, fpl-hsmem for memory)
- Single copy-paste block of /plugin install commands
- Rationale table — what each plugin provides + what breaks without it
- Optional plugins (laws-of-ux, agents-domain, agents-github,
brownfield-pack, orchestra) with one-liner trigger conditions
EN + RU mirror parity preserved.
…ven narrative The 'Without it' column was a passive inversion of 'Provides' with internal project jargon (Profile A creators, guardian gate, 4-layer pipeline driver, SPARC contract) that the reader of /docs/getting-started/installation/ has no context for. Rewriting as 'What you can do with it' — one short sentence per plugin in plain language, naming concrete user-visible actions. Same in RU mirror.
Follow-up to PR #354. The cleanup caught most visible-text anglicisms, but 3 instances of "edge cases" in prose inside bmad-cycle.html slipped through. Replaced with "граничные случаи" to match the convention used elsewhere. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs(website): fix 20 broken npx skills commands + add Full Harness Bundle section
fix(website/guides): 3 missed 'edge cases' in bmad-cycle
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release `dev -> main` carrying 6 commits that accumulated in dev:
Docs additions
Install commands
Guide cleanup
Commits
```
297c72a Merge pull request #358 from ForgePlan/fix/bmad-edge-cases
a004b8e Merge pull request #357 from ForgePlan/fix/website-install-commands-v2
ca90647 fix(website/guides): translate 3 missed "edge cases" in bmad-cycle prose
006b2b0 docs(website): rewrite Full Harness Bundle plugin table - outcome-driven narrative
0ffcc20 docs(website): add Full Harness Bundle section to installation.md
5045ddf docs(website): fix 20 broken `npx skills add ForgePlan/marketplace --skill/--plugin X` commands
```
Test plan (after merge + deploy)
🤖 Generated with Claude Code