Comprehensive feature planning and execution system. Provides workflows for creating plans, decomposing into features, and pull-based execution. Uses Beads as source of truth for state management.
This skill provides a reliable system for planning and executing features. It uses Beads as the source of truth for plans and task state, with mechanical enforcement of quality gates.
plan:new ──► Beads Epic (plan in description)
│
▼
plan:optimize <epic-id> ──► Beads Tasks (prompts in descriptions)
│ + dev/plans/<name>/ (supporting files)
▼
bd ready ──► Pull-based execution (one task at a time)
plan:new --master ──► Beads Epic + Features (high-level decomposition)
│
▼
plan:new <feature-id> ──► Detailed plan in feature description
│ (optional: research tasks first)
▼
plan:optimize <feature-id> ──► Beads Tasks under feature
│ + dev/plans/<name>/ (supporting files)
▼
bd ready ──► Pull-based execution (one task at a time)
| Component | Purpose | |-----------|---------| | Commands | Lean workflow coordinators | | Workflows | Detailed phase instructions (loaded on-demand) | | Templates | Standardized file formats | | Verification | TypeScript scripts for mechanical enforcement | | Hooks | Block shortcuts at Stop events |
All plans are stored in Beads epics. Each feature becomes a task under that epic with the full prompt in the description.
# Epic created by plan:new (plan content in description)
bd create --type=epic --title="Feature Name" --description="<full plan>" --silent
# Tasks created by plan:optimize (prompts in description)
bd create --type=task --parent=<epic-id> --title="F001: Setup types" --description="<full prompt>" --silent
# Dependencies between features
bd dep add <task-F002> <task-F001>
# Pull-based execution
bd ready # Find available work
bd update <task-id> --status=in_progress # Claim work
bd close <task-id> # Complete work
Azure DevOps Story status can sync with Beads epic via sync-devops.ts.
Hooks in hooks/hooks.json run TypeScript verification scripts:
Quality gates (all configurable via .planconfig):
| Task | Command |
|------|---------|
| Start new plan (standard) | plan:new |
| Start master plan | plan:new --master |
| Plan a feature | plan:new <feature-id> |
| Optimize epic into tasks | plan:optimize <epic-id> |
| Optimize feature into tasks | plan:optimize <feature-id> |
| Find work | bd ready |
| View task | bd show <task-id> |
| Claim work | bd update <task-id> --status=in_progress |
| Complete work | bd close <task-id> |
| Reflect on conversation | /reflect |
| Toggle auto-reflect | /reflect on or /reflect off |
| Reflect status | /reflect status |
Load these on-demand during command execution:
workflows/1-planning.md - Planning phase detailsworkflows/2-optimization.md - Optimization phase detailstemplates/plan.md - Plan document structuretemplates/prompt.md - Feature prompt structuretemplates/context.md - Context file templatetemplates/constraints.md - Constraints file templateCreated by plan:optimize in dev/plans/<name>/:
context.md - Project background and architectureconstraints.md - Global rules for all featuresdecisions.md - Architectural decisions logedge-cases.md - Known edge cases and handlingtesting-strategy.md - Testing approach.planconfig (YAML, project root):
build_command: "npm run build"
test_command: "npm test"
lint_command: "eslint ."
format_command: "prettier --check ."
static_analysis_command: "sonar-scanner"
All commands optional. Missing commands skip that verification step.
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer