fabrik-plan

Generates implementation plans with task checklists from specs and research findings.

22|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/handarbeit/fabrik --skill fabrik-plan-handarbeit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fabrik-plan
Source: https://github.com/handarbeit/fabrik/tree/main/plugin/fabrik-workflows/skills/fabrik-plan
Command: npx skills add https://github.com/handarbeit/fabrik --skill fabrik-plan-handarbeit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an issue moves through an automated SDLC pipeline, someone must turn the spec and research findings into a concrete, ordered implementation plan. This Skill acts as the Plan stage agent in the Fabrik pipeline, producing a plan an implementer can follow mechanically without making design decisions. ## Core Features & Use Cases - Implementation Planning: Designs the approach, file organization, interfaces, and testing strategy based on the issue spec and Research stage output. - Task Checklist Generation: Produces an ordered, atomic, testable GitHub-checkbox task list (typically 5-15 tasks) with documentation updates integrated alongside code tasks. - Sub-issue Decomposition: Emits FABRIK_SPAWN_CHILD blocks so the engine can split multi-repo or parallelizable work into linked child issues with optional DEPENDS_ON ordering. - Pipeline Signaling: Uses FABRIK_STAGE_COMPLETE, FABRIK_NO_WORK_NEEDED, and FABRIK_BLOCKED_ON_INPUT markers to drive the engine's stage transitions. - Use Case: An issue requesting a new API endpoint reaches the Plan column; the agent reads .fabrik-context/issue.md and stage-Research.md, decides the approach, and posts a plan with a 10-task checklist that the Implement stage executes. ## Quick Start Read the spec and research files in .fabrik-context, then produce an implementation plan with a task checklist and emit FABRIK_STAGE_COMPLETE.

Frequently Asked Questions about fabrik-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan from a GitHub issue spec?

Read the issue body and research findings from .fabrik-context, decide the approach and file organization, then emit a plan with an ordered checkbox task list. Tasks should be atomic, testable, and concrete, with testing and documentation tasks integrated alongside code tasks.

How does the Fabrik Plan stage signal completion?

Emit FABRIK_STAGE_COMPLETE as the sole content of its own line, with no backticks or formatting. The engine matches the exact line and posts your final message verbatim as the stage comment, so stop output immediately after the marker.

Can the Plan stage split work into sub-issues?

Yes, by emitting FABRIK_SPAWN_CHILD_BEGIN/END blocks with a target owner/repo, TITLE, and optional DEPENDS_ON index. The engine creates the child issues, adds them to the project board, and links them as blockedBy dependencies of the parent at Implement time.

When should FABRIK_NO_WORK_NEEDED be used?

Use it only when research conclusively shows no code, test, or doc changes are required and creating a PR would fail or be misleading. Emit both FABRIK_STAGE_COMPLETE and FABRIK_NO_WORK_NEEDED; the engine skips remaining stages and moves the issue to Done without a PR.

What happens if the Plan agent hits the turn limit?

The turn budget is a time-slicer, not a failure. The next invocation resumes the same session with prior context intact, so continue from where you stopped rather than restarting or re-deriving completed reasoning.