br4zz4:plan

Generates TDD implementation plans from approved specs with task decomposition and execution options.

Updated May 25, 2025
One-click install
npx skills add https://github.com/oporpino/commons --skill br4zz4-plan-oporpino
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: br4zz4:plan
Source: https://github.com/oporpino/commons/tree/main/ai/shared/skills/br4zz4%3Aplan
Command: npx skills add https://github.com/oporpino/commons --skill br4zz4-plan-oporpino

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved specification into working code without a structured plan leads to missed requirements, vague tasks, and inconsistent commits. This Skill converts an approved spec into a detailed, test-driven implementation plan with exact file paths, full code, and verification commands. ## Core Features & Use Cases - Spec-to-Plan Conversion: Reads an approved spec from .project/docs/specs/ and produces a timestamped plan in .project/docs/plans/ with a mandatory header, architecture summary, and global constraints. - Bite-Sized TDD Tasks: Decomposes work into tasks where each task is one TDD cycle — failing test, verification command, minimal implementation, and commit — with no placeholders allowed. - Scope and Quality Gates: Runs a pre-flight make check baseline, proposes splitting multi-subsystem specs into separate plans, and self-reviews for spec coverage, placeholders, and type consistency. - Execution Handoff: Creates the feature branch and offers subagent-driven parallel execution in worktrees or inline execution with commons:tdd. - Use Case: After approving a spec for a new API endpoint, invoke this Skill to get a plan file where every task contains the actual test code, implementation code, and commit commands an engineer (or subagent) can execute directly. ## Quick Start Ask the assistant to create an implementation plan from the approved spec in .project/docs/specs/ using the plan skill.

Frequently Asked Questions about br4zz4:plan

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

FAQPage Schema
How do I turn a spec into a TDD implementation plan?▼

Invoke the plan skill after a spec is approved in .project/docs/specs/. It reads the spec, maps affected files, and writes a timestamped plan in .project/docs/plans/ where each task is one TDD cycle with real test code, implementation code, and commit commands.

What should an implementation plan include for test-driven development?▼

Each task should list exact files to create or modify, the failing test with its run command and expected error, the minimal implementation, the passing verification, and a commit step. Plans must avoid placeholders like TBD and include interface contracts between tasks.

Can I run a plan without an approved spec first?▼

No. The skill expects an approved spec in .project/docs/specs/ and directs you to invoke the spec skill first if none exists. The plan header links back to its source spec via the spec frontmatter field.

How are large specs spanning multiple subsystems handled?▼

During the scope check phase, the skill proposes splitting the spec into separate plans, one per subsystem. Each resulting plan must produce working, testable software independently so tasks can run in parallel.

What happens after the implementation plan is saved?▼

The plan is committed, a feature branch is created from an up-to-date main, and you choose between subagent-driven execution with parallel worktrees or inline execution using the TDD skill with checkpoints between tasks.