Skip to content

ForgePlan/marketplace

Repository files navigation

English | Русский

ForgePlan — From Raw Idea To Proven Decision

ForgePlan Marketplace

Official plugin marketplace for Claude Code from ForgePlan — UX, workflow, engineering, and developer tools.

19 plugins | 33 marketplace-aware agents (83 total) | 38+ skills | 9+ knowledge bases

ForgePlan ecosystem: this marketplace + forgeplan CLI (artifact lifecycle) + @forgeplan/web (browser viewer with time-travel + graph). Three siblings; install what you need.

📚 Documentation

Guide When to read
👋 Onboarding Read this first — pocket guide, friendly tone, get from zero to autonomous agent dispatch in 30-60 min. Hindsight setup + command cookbook + when-you're-needed matrix
🚧 Brownfield guide Companion to Onboarding — existing codebases, Discover Agent, Strangler Fig + DDD + ACL with concrete examples
🚀 Developer Journey Longer 30-min walkthrough from zero to your first shipped feature, with 4 persona Day 0 walkthroughs
🧭 Smith — master orchestrator Routing map: 14 routing rows × 27 methodologies. When and how to dispatch /smith as the BMAD-style master that picks the right workflow for the task
📋 Playbook Use-case matrix: which command for which scenario (empty project, brownfield, night-run, …)
📖 Usage Guide Reference manual: 18 commands, hooks, agent activation rules, troubleshooting
🏛 Architecture 4-layer mental model — Orchestra (where) · Forgeplan (what) · FPF (how to think) · SPARC (how to code)
🔬 Methodologies What's built into forgeplan (BMAD, OpenSpec, ADI, F-G-R, DDR, Verification Gate) vs what's external
🔁 Autoresearch integration Combining uditgoenka/autoresearch (metric-driven loops) with /forge-cycle lifecycle
🧭 AI-SDLC mapping Phase-by-phase map for users coming from AI-SDLC vocabulary (Concept → Research → Design → Build → Test → Release → Operate → Maintain)
📚 Upstream methodologies Bibliography — pointers to Quint-code, BMAD, OpenSpec, FPF, Karpathy autoresearch, git-adr, ccpm, adr-tools
🛠 Setup Guide for new repo End-to-end bootstrap (~20 min): forgeplan + Claude Code plugins + GitHub Projects v2 + auto-add workflow + convention. Use when adding a new ForgePlan repo to the ecosystem.
🚚 Migration: dev-toolkit → fpl-skills Switching plugins safely (side-by-side or clean-cut, with rollback plan)
🗂 Tracker Integration Recipes for Orchestra · GitHub Issues · Linear · Jira · local TODO
🌐 Forgeplan Web Browser viewer — time-travel slider + artifact graph + health dashboard
🔄 Process Reference (EN) / RU Full process from idea to commit — 5 agent profiles, 10 artifact kinds, 4-layer pipeline, methodologies (BMAD/FPF/SPARC/RIPER-5)
📜 Changelog Release history
🤝 Contributing Add a new plugin to the marketplace

Quick Start

# 1. Add the ForgePlan marketplace
/plugin marketplace add ForgePlan/marketplace

# 2. Install your first plugin (works with any project, no dependencies)
/plugin install dev-toolkit@ForgePlan-marketplace

# 3. Reload to activate
/reload-plugins

# 4. Try it — run a code audit
/audit

Where to Start?

New here? Pick the row that matches you. Each row is a complete setup — no need to read the full catalog.

Your role Install these Why
I want a master orchestrator fpl-skills + agents-pro Start here → /smith routes 14 routing rows to 27 methodologies
Forgeplan user (recommended) fpl-skills One install, 38 skills, full route → ship loop
Any developer (no forgeplan) dev-toolkit + agents-core Universal tools, no CLI dependency
Frontend fpl-skills + laws-of-ux + agents-domain UX + framework agents
Architect fpl-skills + fpf + agents-pro + agents-sparc Thinking + SPARC
Multi-session / team fpl-skills + forgeplan-orchestra Coordination + Inbox Pattern
Brownfield migration fpl-skills + forgeplan-brownfield-pack Ingest legacy docs + C4/DDD/research analyses
Everything All 18 plugins Complete ecosystem

Available Plugins

Tip

Flagship — recommended for forgeplan users. Bundles 38 engineering skills built on top of forgeplan's artifact lifecycle. Replaces dev-toolkit (now soft-deprecated).

Full route → shape → build → audit → activate loop in one install. Includes /fpl-init for one-command project bootstrap.

Component What you get
/fpl-init One-shot project bootstrap: forgeplan init, MCP wiring, CLAUDE.md, docs/agents/
/research, /refine, /rfc Discovery → planning → formalisation
/sprint, /do, /autorun, /build, /team Execution (interactive, autopilot, multi-agent)
/audit, /diagnose Multi-expert review + 6-phase debug loop
/restore, /briefing, /setup, /bootstrap Session and project helpers
SessionStart hook Context-aware next-step hint (status, /fpl-init prompt for new repos)

Warning

Requires the forgeplan CLI on $PATH.

/plugin install fpl-skills@ForgePlan-marketplace

Smith — master orchestrator

Tip

The BMAD Master of the ForgePlan ecosystem. Routes 14 routing rows (greenfield, brownfield, audit, sprint, refactor, supersede, …) to the right methodology + dispatch sequence. Use /smith when you know what you want but don't know which command to run.

Smith is a Profile B-orchestrator agent paired with four skills. It reads the task, picks a methodology from a 27-entry routing map (BMAD, OpenSpec, FPF ADI, C4, SPARC, …), and dispatches the correct skill chain. Treat it as the front door for any non-trivial task in this marketplace.

Component Where
smith agent plugins/agents-pro/agents/smith.md
/smith skills (×4) plugins/fpl-skills/skills/smith*/
Routing map (14 routing rows × 27 methodologies) plugins/fpl-skills/skills/smith/routing-map.md

Full guide: docs/SMITH.md.

# Install both plugins, then dispatch:
/plugin install fpl-skills@ForgePlan-marketplace
/plugin install agents-pro@ForgePlan-marketplace
# In session:
/smith   # describe the task; Smith picks methodology + skill chain

dev-toolkit — deprecated

Caution

Superseded by fpl-skills. New installs should use fpl-skills. Existing dev-toolkit installs keep working — soft-sunset until catalog v2.0.

Universal engineering toolkit — audit, sprint planning, and session context restore. No CLI dependency.

Component What you get
/audit Multi-expert code review (4 agents: logic, architecture, security, tests)
/sprint Wave-based sprint planner: break tasks into phases, execute with parallel agents
/recall Session context restore from git + CLAUDE.md + memory (Hindsight/mem0/forgeplan)
Dev Advisor agent Suggests audit after changes, reminds about tests
Safety hook Blocks git push --force, rm -rf /, DROP TABLE
Test reminder Detects new public functions without tests

Supports: JavaScript/TypeScript, Python, Rust, Go, Java, Ruby, PHP, C#

/plugin install dev-toolkit@ForgePlan-marketplace

30 Laws of UX applied to frontend code review with actionable recommendations.

Review HTML/CSS/JS/React/Vue code against psychological principles from lawsofux.com by Jon Yablonski.

Component What you get
/ux-review Full UX audit of all frontend files
/ux-law [name] Look up any of the 30 laws
UX Reviewer agent Auto-activates for frontend tasks
Auto-hints hook UX reminders when editing .html/.css/.jsx/.tsx/.vue
Knowledge base 30 laws + 9 code pattern files (agentic RAG)

Categories covered:

Category Laws Examples
Heuristics 4 Fitts's Law (44px targets), Hick's Law (7 nav items max)
Cognitive 10 Miller's Law (7±2 chunks), Cognitive Load, Von Restorff
Gestalt 6 Proximity (spacing ratios), Similarity (consistent tokens)
Principles 10 Doherty Threshold (400ms), Jakob's Law, Postel's Law
/plugin install laws-of-ux@ForgePlan-marketplace

First Principles Framework — thinking amplifier for structured reasoning. By Anatoly Levenchuk, enhanced by ForgePlan.

One command /fpf routes to the right thinking mode — decompose, evaluate, reason, or lookup.

Component What you get
/fpf Universal router: /fpf decompose, /fpf evaluate, /fpf reason, /fpf lookup
/fpf-decompose Break systems into bounded contexts, roles, interfaces
/fpf-evaluate Compare alternatives with F-G-R scoring and Trust Calculus
/fpf-reason ADI reasoning cycle: 3+ hypotheses → test → conclude
FPF Advisor agent Suggests FPF when architecture/decision tasks detected
Knowledge base 224 FPF spec sections + 4 applied pattern guides (agentic RAG)
/plugin install fpf@ForgePlan-marketplace

Structured engineering workflow for forgeplan users.

Full dev cycle automation: route tasks, create PRDs, build, audit, create evidence, activate — all in one flow.

Component What you get
/forge-cycle Complete cycle: health → route → shape → build → evidence → activate
/forge-audit Multi-expert review (6 parallel agents) with structured report
Forge Advisor agent Suggests routing before coding, evidence after implementation
Quality hooks Safety hook + PRD check before code edits
Methodology KB Agentic RAG: workflow, artifacts, depth, R_eff scoring, quality gates

Warning

Requires forgeplan CLI — private application, access through project admin.

/plugin install forgeplan-workflow@ForgePlan-marketplace

Unified workflow: Forgeplan artifacts + Orchestra task tracking + Claude Code AI execution.

Bidirectional sync, Session Start Protocol with Inbox Pattern, and methodology knowledge base.

Component What you get
/sync Bidirectional sync: Forgeplan artifacts ↔ Orchestra tasks
/session Session Start Protocol: health + inbox + tasks + synthesis + next action
Orchestra Advisor agent Suggests sync on artifact create/activate
Unified Workflow KB Agentic RAG: architecture, setup, playbook, configs (Solo/Team/Medium)

Warning

Requires forgeplan CLI + Orchestra MCP server (orch).

/plugin install forgeplan-orchestra@ForgePlan-marketplace

Brownfield migration pack — ingest legacy docs and agent analyses into a structured forgeplan graph.

Implements the orchestrator model (ADR-009): forgeplan does not re-implement extraction. Instead, this pack composes existing marketplace plugins (c4-architecture, autoresearch, ddd-expert, feature-dev) with forgeplan's ingest engine via mapping YAMLs and playbook recipes.

Component What you get
mappings/c4-to-forge.yaml Maps C4 context markdown to forge artifacts (Epic, PRD, ADR, Evidence)
playbooks/ (scaffolded) Recipes for brownfield discovery + migration — requires forgeplan runtime v0.25+
skills/ (scaffolded) Extraction-specific guidance — forge-classify, madr-detection
agents/ (scaffolded) Brownfield-specific sub-agents

Warning

Alpha. Mapping layer (c4-to-forge) validated at CL3 on Forgeplan repo (2026-04-20). Playbook runtime in active development (Forgeplan EPIC-007 / PRD-065). Requires forgeplan CLI v0.25+.

/plugin install forgeplan-brownfield-pack@ForgePlan-marketplace

Claude Code ecosystem reference — opinionated agentic-RAG guide for CLAUDE.md, plugins, agents, hooks, MCP, and anti-patterns. Synthesises 47+ audit findings from ForgePlan marketplace work.

All 6 sections authored: claude-md, plugins, agents, hooks, mcp, anti-patterns.

/plugin install cc-best@ForgePlan-marketplace

Practical cookbook of forgeplan CLI recipes — 26 recipes covering init, PRD walkthrough, EVID flows, link directions, R_eff cascade fixes, polyglot patterns.

/plugin install fp-cookbook@ForgePlan-marketplace

Methodology skill for writing skills in agentic RAG format — SKILL.md as router + sections/_index.md + content files (~30-50 LOC each). 6 sections: when-to-use, structure, description-craft, content-quality, templates, distribution.

/plugin install agentic-rag@ForgePlan-marketplace

Agent Packs

Eight specialized agent packs providing 77 ready-to-use agents for Claude Code.

Install any pack: /plugin install <pack-name>@ForgePlan-marketplace

Pack Agents Focus Install
agents-core 11 debugger, code-reviewer, planner, tester, TDD, production-validator agents-core
agents-domain 11 TypeScript, Go, React, Next.js, Electron, mobile, WebSocket agents-domain
agents-pro 30 security, architecture, creative, research, infrastructure agents-pro
agents-github 7 PR management, issues, releases, multi-repo, workflows agents-github
agents-sparc 5 SPARC methodology: spec → pseudo → architecture → refinement agents-sparc
agents-tdd 4 TDD instance #1 (RFC-012): tdd-orchestrator + RED/GREEN agents + test-validator agents-tdd
agents-bmad 1 BMAD instance #2 (RFC-013): bmad-orchestrator persona-walk + no-code-before-plan gate agents-bmad
agents-canvas 8 CANVAS instance #5 (RFC-021): design-system→code (/canvas, hook-gate=Yes) — canvas-coordinator master + tokens-before-code gate + 7 role agents (incl. canvas-storybook-validator) agents-canvas

Brownfield Discovery

Brownfield codebase onboarding — structured analysis of existing projects with tiered source priority via the canonical 7-phase MCP discovery protocol. Code first, docs last.

Migrated from a standalone agent to the forgeplan-brownfield-pack plugin in Sprint V (PRD-048, v1.4.0). The plugin agent follows the canonical Profile A pattern and wraps the forgeplan_discover_* MCP surface.

Three modes for any project size:

Mode For What happens
default <100K LOC Single agent, 7-phase MCP discovery (~15-30 min)
--deep 100K-2M LOC Pass 1 + Pass 2 deepening (planned; multi-session)
--full 2M+ LOC Pass 1 + Pass 2 + Pass 3 synthesis (planned)

7 phases: detect → structure → code → git → tests → docs → synthesize 3 source tiers: Code (T1, highest trust) > Tests (T2) > Docs (T3, lowest)

Dispatch via Task(subagent_type="forgeplan-brownfield-pack:discover", ...). See plugins/forgeplan-brownfield-pack/agents/discover/README.md for full documentation. The pre-migration standalone is archived at agents/_archive/discover-pre-sprint-v/.


How It Works

Each plugin uses agentic RAG — the agent navigates a section hierarchy, loading only relevant content into context (~300 lines at a time) instead of dumping the entire knowledge base. This keeps responses fast and focused.

SKILL.md (router)
  → sections/01-heuristics/_index.md → specific-law.md
  → sections/02-cognitive/_index.md  → specific-law.md
  → sections/05-code-patterns/       → concrete CSS/HTML/JS rules

Alternative: Skill Only (via skills.sh)

If you only want the knowledge base without commands, agents, or hooks:

# Laws of UX:
npx skills add ForgePlan/loux -g

# First Principles Framework:
npx skills add ForgePlan/fpf -g

These standalone repos are auto-mirrored from the marketplace — same content, shorter install command. Issues and PRs go to this marketplace repo.

Legacy alias ForgePlan/laws-of-ux-standalone still works but is deprecated in favour of ForgePlan/loux.

Plugin vs Skill — what's included

Plugin (marketplace) Skill (npx)
Knowledge base (laws / FPF spec) Yes Yes
Code pattern files Yes Yes
Slash commands (/ux-review, /fpf, ...) Yes No
Reviewer / advisor agents Yes No
Auto-hint hooks Yes No

Update

Get the latest plugins:

/plugin marketplace update ForgePlan-marketplace

Contributing

Want to add a plugin? See CONTRIBUTING.md for the plugin structure, CI/CD validation, and submission guide.

License

MIT


Built by ForgePlan

About

Official ForgePlan plugin marketplace for Claude Code — Backend and ForgePlan developer tools

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors