architecture-grill

Resolves architectural ownership and subsystem boundaries through structured one-question-at-a-time interviews.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/bbenefield89/skills --skill architecture-grill-bbenefield89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-grill
Source: https://github.com/bbenefield89/skills/tree/main/skills/architecture-grill
Command: npx skills add https://github.com/bbenefield89/skills --skill architecture-grill-bbenefield89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump from behavioral discovery straight into specification or implementation without deciding who owns state, which systems may mutate it, and how subsystems depend on each other. This Skill closes that gap by running a focused architectural interview that settles ownership, authority, dependencies, and interfaces before tickets become specs or tasks. ## Core Features & Use Cases - Decision-focused interview: Applies an explicit test to each uncertainty, asking only questions that affect responsibility ownership, state mutation authority, dependency direction, or integration boundaries. - Pattern preservation: Inspects repository code, ADRs, and conventions to record existing architectural patterns with evidence instead of re-litigating settled decisions. - Structured output: Produces a summary of agreed owners, permitted mutations, interfaces, invariants, and trade-offs that downstream specification skills can consume directly. - Use Case: After defining how a game character should dash, use this Skill to decide whether the player controller or a movement system owns velocity state and who may call move_and_slide(), before writing the implementation spec. ## Quick Start Ask the assistant to run an architecture grill on the current feature to resolve ownership and subsystem boundaries before writing the specification.

Frequently Asked Questions about architecture-grill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide subsystem ownership before writing a specification?

Run an architectural interview that tests each uncertainty against ownership of state, mutation authority, and dependency direction. The Skill asks one question at a time with concrete alternatives, a recommendation, and trade-offs, then summarizes the agreed boundaries for the specification step.

When should architectural decisions happen in a development workflow?

They should happen after behavioral discovery settles what the feature must do, but before ticket-to-spec and spec-to-tasks generation. Deciding boundaries earlier avoids rework when implementation reveals ownership conflicts.

Does this Skill design the actual implementation details?

No. It deliberately excludes line-by-line implementation design such as variable names, loops, and helper methods. Those local details are left to the delivery phase within the agreed architectural boundaries.

What happens if no architectural decision is needed?

The interview ends without questions. The Skill states that the work stays within existing boundaries and briefly identifies the relevant ownership rules and the repository evidence supporting them.

How are existing code patterns handled during the interview?

Clear, consistent existing patterns that fit the requested behavior are preserved and recorded with supporting evidence, without asking the user to re-approve them. Only conflicting, absent, or expanding patterns trigger questions.