fpl-skills

By ForgePlan

Flagship workflow plugin for the ForgePlan ecosystem. 40 engineering skills + dev-advisor agent + 5 hooks (+ smith greeting + insight watchdog). v1.49.0: NEW /forge-heal skill — PRD-074/RFC-020 brick 2 (Layer 4 heal-or-task): propose-not-silent 3-tier dispatch of findings onto PRD-032 AUTO/ADI/USER — AUTO auto-fixes ONLY 2 reversible kinds (phase_mismatch, complete stuck_draft) after a batch confirm + journal + one-call rollback (phase rollback via phase_advance --to prior, NOT undo_last); ADI reasons; USER writes a tracked NOTE-013 task + suggests the agent; never silent-mutates the tree. v1.48.0: NEW /forge-insight skill + insight-watchdog SessionStart hook — PRD-074/RFC-019 brick 1 self-aware integrity: filtered anomaly digest (silent when clean), accurate session counts from forgeplan truth (retires the stale-grep draft-count falsehood), NOTE-013 machine-findings ledger; plus a decay-reminder.sh stale --output/--kind flag fix (its ADR-trigger scan was silently no-opping). v1.46.0: NEW /conformance-vectors skill (SDD optional enrichment — ADR-008 / PRD-072 FR-006 / DEFER-012): the `## Conformance Vectors` convention (frozen language-neutral corpus = sole oracle) + a corpus-agnostic generic harness (freeze + conformance + cross-language equivalence gates, live negative-control-verified) + the proven 4-language semver reference promoted from sandbox (EVID-119) + a cross-language equivalence guardian-gate for multi-language SPECs. v1.45.0: /autorun RIPER methodology gate (DEFER-016 / RFC-018 FR-4) — a Row-4 (non-trivial production bug → RIPER, hook-gate=No) task makes the Plan→Execute transition human_required; autopilot HOLDS before the first Execute dispatch (unattended default = WAIT, not proceed) + checkpoint + CONCERNS EVIDENCE; closes the EVID-167 F1 / G8 autonomous-RIPER gap. v1.44.1: /riper FR-5 pin-hash basis clarified — hash the Research NOTE body content (sections, excluding mutable frontmatter), NOT the projection file (which false-stales on unrelated activation/link/score); + F2 note (the orchestrator records the Research NOTE; research-analyst is read-only Profile C) — DEFER-018 / EVID-172 F1+F2. v1.44.0: RIPER instance #4 (RFC-018 / ADR-010) — /riper formalized into the contract instance (C1-C6 + non-freezable Research C4+C6 + Plan-gate pin-freshness + per-mode hard constraints + hook-gate=No main-session orchestration), smith Row 4 reframe + disambiguator, /methodology-check Step 10 recognizes the Research ## Pinned revision C6; the ADR-012 internal codename is rendered hook-gate in all shipped artifacts. v1.43.0: smith routing-map Row 3 (new feature in existing service) reframed as the explicit SPARC instance — master-coordinated sparc-orchestrator dispatch + mandatory per-gate independent C4 + Pseudocode-absorption + Refinement→TDD delegation + SPARC/BMAD/TDD/Strangler disambiguator (RFC-016/ADR-010 instance #3). v1.42.0: smith routing-map Row 1 (greenfield) reframed as the explicit BMAD instance — master-coordinated agents-bmad dispatch + 3 mandatory C4 gates + BMAD/SPARC/TDD/Strangler disambiguator (RFC-013/ADR-010 instance #2). v1.41.1: smith routing-map adds a 'TDD-first feature' context row routing to the agents-tdd dispatch sequence (RFC-012/ADR-010). v1.41.0: /spec-author skill (ADR-008 light-path SDD; frozen #### Scenario = oracle) merged alongside the FR-3 ground-truth clause (PRs #130 + #131). v1.40.0: RFC-011 FR-3 ground-truth verification clause (generator≠verifier) — AGENT-AUTHORING-GUIDE adds canonical 'Profile B Step 4.5' section (variants A/A'/A'' + `## Ground-truth verification` EVID template + Profile B universal HARD RULE 8 making ML-13 enforceable: empty git diff on a claimed change = BLOCKER even when tests are green); smith routing-map adds 'Ground-truth verification (generator≠verifier)' methodology card applying to every Build/Audit row; corrected the worktree under-claim (isolation works for standalone subagents + Workflow + AgentTeams teammates, not coder-only — real risks are leak + assume-without-verify). Refs PROB-002/RFC-011/ADR-009; smoke `sandbox-verify/r3-reviewer-groundtruth-smoke.sh`. v1.38.1: cookbook §07 fix — final-e2e found CLI vs MCP agent-id validator asymmetry on forgeplan 0.32.1 (filed as forgeplan#353). Cookbook §07.1 example switched from 'adr-architect/1.11.1' (CLI rejects) to dash-form 'adr-architect-v1-11-1' (both accept). §14.4 added documenting the asymmetry + workaround. §14.5/14.6/14.7 renumbered. v1.38.0: NEW `/forgeplan-cookbook` skill — agentic-RAG router for 66 mcp__forgeplan__* MCP tools + 82 forgeplan CLI subcommands. 14 sections by use-case (lifecycle / discovery / quality / pipeline-health / session-phase / AI-driven / multi-agent / brownfield / activity / FPF / playbooks / plugins / release / MCP-safety) + flat alphabetical _index. Quick router maps intent → section. Section 14 documents 3 filed upstream bugs (#348 score-all hint, #350 CRITICAL @filepath data loss, #351 plugins doctor syntax) + canonical safe patterns. v1.37.1: CRITICAL safety convention — AGENT-AUTHORING-GUIDE now documents the MCP `body` parameter as literal-string-only (forgeplan#350 silent data-loss bug). Canonical safe pattern: Read file via host CLI, pass content as string. CLI vs MCP semantics table prevents agent confusion. Profile A/B/D agents are most exposed (canonical body writers). v1.37.0: --help-driven verification + Step 1b uses native `forgeplan migrate-secrets --apply` for LLM key import (PRD-077 FR-023 Part B). 4-row table covers: gemini (default template match), anthropic, openai, or no-key-found path. Removes 35-line manual config snippet — auto-import is the canonical forgeplan flow. v1.36.0: deep-e2e fix pack — (a) templates/smith-bootstrap.md acceptance probes use --type (4 places) — was --kind=, drifted from SKILL.md fix in v1.35.2; (b) new Step 1b in smith-bootstrap probes .forgeplan/config.yaml for an llm: block right after forgeplan init; if absent, prints informational guidance (3 providers — Anthropic / Gemini / OpenAI — with full config + secrets.env example) so the user can configure before the first /forge-cycle Step 4.5 ADI call; (c) Failure modes covers downstream LLM-not-configured halt. Closes deep-e2e findings 2 and 4. v1.35.2: e2e-test fix pack — smith-bootstrap Step 5/6 acceptance probes use correct CLI flag `--type` (not `--kind` — that name only exists in MCP forgeplan_new(kind=...) form), Step 6 documents the literal section names forgeplan validate MUST-requires (Problem statement, Target audience, Goals/Success Criteria, Functional Requirements with literal capitalisation, Out of scope, Related Artifacts) + cites the validator rule names that trigger on miss, and adds `forgeplan validate PRD-NNN → PASS` to acceptance criteria. v1.35.1: smoke-test fix — Step 0c 6th state `plugin-handles-it` (fpl-hsmem enabled + no project-local .mcp.json hindsight block = normal/healthy, not unclassified). Smoke against fresh tmp project surfaced that the previous 5-state matrix marked this normal case as 'UNCLASSIFIED'. Reference implementation now ships as bash if/elif ladder with explicit precedence order. v1.35.0: MCP-wiring drift closure trio — (1) /fpl-init Step 5 migrated from Python merge to native `forgeplan mcp install --client claude --scope project` (same primitive as smith-bootstrap Step 0b, eliminates skill-to-skill drift); (2) hooks bundle expanded from 1 to 3 files (safety-hook + pre-pr-evidence-check + forge-safety-hook) at templates/hooks/; (3) AGENTS.md MCP server registration section now leads with `forgeplan mcp install` as canonical wiring command across Claude Code / Cursor / Windsurf / Gemini / Codex. v1.34.0: smith-bootstrap Step 0 refactored from halt-and-instruct to active infrastructure runner. 5 sub-steps: 0a plugin enablement gate (halt-only on MUST miss), 0b forgeplan MCP auto-wire via native `forgeplan mcp install --client claude --scope project` (replaces halt + Python merge), 0c Hindsight detection with 5-state classification (fully wired / key missing / env-var naming mismatch / Docker quick-start / plugin not enabled) — informational guidance, never writes secrets, 0d minimal hooks bundle copy from templates/hooks/ (safety-hook.sh starter), 0e user-driven /reload-plugins + ToolSearch verify. Closes real-project gap observed 2026-05-20 where bootstrap landed CLAUDE.md+AGENTS.md but skipped MCP wiring → downstream agents shell-fallback → degraded artifacts. v1.33.0: smith-bootstrap pre-flight gates. v1.31.1: EPIC-002 niceties patch. v1.31.0: EPIC-002 — 4 smith skills + templates + session-start.sh.