next-increment

What problem does it solve?

Mature codebases with written architecture direction often stall on what to build next; this Skill turns architecture docs and repository state into a short, actionable set of candidate increments and a concrete mini-spec for the chosen one so teams can move forward safely and quickly.

Core Features & Use Cases

• Architecture-aware candidates: Reads docs/02-architecture and repository state to produce 3-5 candidate increments grounded in existing design.
• Archetype diversity and concrete verification: Ensures candidates span infrastructure-seed, user-visible, and risk-reducer archetypes with specific verify steps (curl/SQL/CLI/UI).
• Mini-spec authoring and history persistence: Writes a pending mini-spec to docs/06-plans and appends a normalized entry to .claude/increment-history.yml to maintain flow.
• Use case: A maintainer of a mature service asks what to build next and receives a short, verifiable increment plus a spec file and history entry ready for planning or execution.

Quick Start

Ask the assistant to run next-increment on a repository that contains docs/02-architecture to produce 3-5 candidates and write a mini-spec saved to docs/06-plans.