increment-planner

⚠Review·Scanned 2/17/2026

This skill plans and creates SpecWeave increments and templates, generating spec.md, plan.md, and tasks.md under .specweave/increments/. It instructs executing local scripts (e.g., bash plugins/specweave/hooks/v2/guards/spec-template-enforcement-guard.sh, node plugins/specweave/skills/increment-planner/scripts/feature-utils.js) and references integration commands like /sw-github:create-issue.

from clawhub.ai·vbac9822·34.9 KB·0 installs

Scanned from 1.0.0 at bac9822 · Transparency log ↗

$ vett add clawhub.ai/anton-abyzov/increment-plannerReview findings below

Increment Planner Skill

Self-contained increment planning for ANY user project after specweave init.

Progressive Disclosure

Load phases as needed to reduce context:

Phase	When to Load	File
Pre-flight	Starting planning	`phases/00-preflight.md`
Project Context	Resolving project/board	`phases/01-project-context.md`
Create Increment	Creating files	`phases/02-create-increment.md`
Reference	Examples, troubleshooting	`phases/03-reference.md`

Quick Reference

Increment Types

Type	Use When	WIP Limit
feature	New functionality	Max 2
hotfix	Production broken	Unlimited
bug	Needs RCA	Unlimited
change-request	Business changes	Max 2
refactor	Technical debt	Max 1
experiment	POC/spike	Unlimited

Directory Structure

.specweave/increments/####-name/
├── metadata.json  # REQUIRED - create FIRST
├── spec.md        # REQUIRED - user stories, ACs
├── plan.md        # OPTIONAL - architecture
└── tasks.md       # REQUIRED - implementation

Workflow Overview

STEP 0: Pre-flight (TDD mode, multi-project)
        → Load phases/00-preflight.md

STEP 1: Project Context (resolve project/board)
        → Load phases/01-project-context.md

STEP 2: Create Increment (via Template API)
        → Load phases/02-create-increment.md

STEP 3: Guide User (complete in main conversation)

Critical Rules

1. Project Field is MANDATORY

Every US MUST have **Project**: field:

### US-001: Feature Name
**Project**: my-app    # ← REQUIRED!
**As a** user...

Get project: specweave context projects

2. Use Template Creator API

Direct Write is FORBIDDEN! Use:

specweave create-increment --id "0021-name" --project "my-app"

3. NO Agent Spawning

Skills MUST NOT spawn Task() agents (causes crashes). Guide user to complete in MAIN conversation.

4. Increment Naming

Format: ####-descriptive-kebab-case

✅ 0001-user-authentication
❌ 0001 (no description)
❌ my-feature (no number)

Token Budget

Quick reference (this file): ~400 tokens
Each phase: ~300-500 tokens
Total if all loaded: ~2000 tokens

Load phases on-demand, not all at once!

Delegation

Pre-flight checks: /sw:increment command handles WIP, discipline
Spec completion: PM skill (in main conversation)
Architecture: Architect skill (in main conversation)
Task generation: Test-aware planner (in main conversation)

Usage

// Direct invocation
Skill({ skill: "sw:increment-planner", args: "--description=\"Add auth\"" })

// Via command (recommended - handles pre-flight)
/sw:increment "Add user authentication"

NOTE: Use sw: prefix! Plain increment-planner fails.