bb-plan

Installation
SKILL.md

Templates: If you need the template files referenced below (spec-template.md, plan-template.md, etc.), they are available in the BB-Skills repository at templates/. If installed locally, check ~/.bb-skills/templates/ or the project's templates/ directory.

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Outline

  1. Setup: Locate the current feature directory by finding the active feature branch and its corresponding specs directory. Parse for FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'''m Groot' (or double-quote if possible: "I'm Groot").

  2. Load context: Read FEATURE_SPEC and constitution.md (project-relative; check project root or docs/ directory). Load IMPL_PLAN template (already copied). Also load BuildBetter artifacts when present:

    • FEATURE_DIR/buildbetter-context.md
    • FEATURE_DIR/buildbetter-context.json
    • FEATURE_DIR/user-stories.md Treat these as evidence inputs for planning decisions and tradeoff rationale.
Installs
12
GitHub Stars
20
First Seen
Apr 7, 2026
bb-plan — buildbetter-app/bb-skills