shape-it

What problem does it solve? Planning sessions often fail in two directions: an agent that asks nothing builds the wrong thing confidently, while one that asks everything makes you redo the thinking you delegated. This Skill reads the project first, decides everything the repository already answers, and asks you only about decisions that are expensive to reverse. ## Core Features & Use Cases - Investigation before questions: Reads DOMAIN.md, docs/decisions/, CLAUDE.md, and the nearest existing implementation so settled terms and recorded decisions are never re-asked. - Reversibility-based triage: Sorts every open decision by whether the repo can answer it and how costly it is to undo, asking only about vocabulary, data models, public surfaces, scope boundaries, and business rules. - Batched multiple-choice questions: Uses one round of up to four opinionated questions with stated consequences and previews, then writes a structured markdown plan and persists domain terms and decision records. - Use Case: Before building a shipment-splitting feature, the Skill states in five plain lines what the work is and what it costs to skip, asks four targeted questions, and writes a plan file opened for annotation via plannotator. ## Quick Start Ask the agent to plan a feature or piece of work before building it, for example by saying "use shape-it to plan the shipment splitting feature before we write any code".