grill-with-docs

Review an architecture plan by challenging the proposed design against existing repository structure and documented decisions to surface ambiguities, contradictions, and hidden trade-offs. The skill interrogates the plan one question at a time until intent is unambiguous.

Align domain terminology by reconciling proposed plan concepts against the project's existing glossary. As terms are clarified during plan interrogation, glossary entries are updated inline to ensure domain language remains consistent across the codebase.

Capture architectural decisions by recording them in ADR-style documentation as they crystallize during plan review. The skill updates decision records inline while walking through design questions and resolving trade-offs against the codebase.

This approach works best with repositories containing glossary and ADR documentation, as it relies on documented decisions and domain language to challenge plans. Without existing documentation, the reconciliation and interrogation features have limited context for surfacing contradictions.

Architecture reviews miss hidden trade-offs when plans are not stress-tested against existing codebase structure and documented decisions. Interrogating the design question by question resolves ambiguities and exposes contradictions early before implementation begins.

Plan interrogation works for new workflows by ensuring terminology matches existing concepts and durable decisions are recorded properly. The skill walks through the proposed workflow step by step, asking clarifying questions resolved from the implementation.