What problem does it solve? Software projects accumulate implicit decisions about databases, versions, contracts, security, and testing that different tasks then guess inconsistently. This Skill centralizes those decisions in a single docs/project-profile.md file so no task has to guess and no two tasks guess differently. ## Core Features & Use Cases - Decision token vocabulary: Enforces exactly three tokens — ASK (user must answer, blocks work), RESOLVE (agent looks up and records with date), and UNDECIDED (deliberate deferral with a forcing condition). - Profile gate: Blocks production code changes until every decision the task depends on is recorded, with narrow exceptions for documentation-only edits. - Template and fallback rules: Ships a copy-ready project profile template covering platform, persistence, API contract, security, observability, caching, performance, and testing decisions, with fallbacks living only in the template's Fallback column. - Use Case: Before implementing a new Spring Boot feature, an agent checks docs/project-profile.md, finds the database engine row is a bare ASK with no fallback, and asks the user once instead of silently picking H2 from a test dependency. ## Quick Start Ask the agent to create docs/project-profile.md from the template and fill in every decision the current task depends on before writing any production code.
