planner-handbook

Writing a spec.md involves defining project scope, selecting archetypes, and applying architecture decision records. This handbook guides the planner agent through authoring clear, concise specifications to streamline your software development planning process.

The grill protocol in project planning is a context extraction process used by the planner agent. It ensures sufficient context is gathered upfront for downstream agents, preventing repeated questions during spec.md authoring.

You need an architecture decision record (ADR) when your project methodology encounters specific design choices. The handbook applies an ADR three-test gate to identify which design choices warrant formal documentation during planning.

Yes, you can use archetype templates for frontend, backend, library, CLI, data-pipeline, and hybrid project planning. These templates provide structured starting points to streamline spec generation across diverse software development contexts.

Automating spec generation with a planner agent involves initiating a grill session to extract context, selecting an archetype template, and applying ADR guidelines. This handbook provides the methodology to streamline the end-to-end authoring process.