Grilling
Interview the user until you reach a shared understanding. Map the topic as a design tree: every decision branches into the decisions that hang off it.
Resolve every .agents/projects/ path from the repository root; never read or write
project artifacts in a global agent-installation directory.
Process
Identify the active project. Read
.agents/projects/<project>/CONTEXT.mdandLINKS.mdwhen they exist. Inspect the repository for facts; do not ask the user for facts that the environment can establish.Done when known facts and unresolved decisions are distinct.
Work the tree in rounds. The frontier is every decision whose prerequisites are settled. Ask the whole frontier in one numbered round, with a recommended answer for each question. Do not ask a question whose answer depends on another open question in the round.
**Q1 - Question title:** Question body and choices. Recommended: Recommended answer.Done when the user has answered the current frontier.
Recompute the frontier after each response. Record confirmed project facts, tracker choices, reusable non-secret configuration references, terminology, and links in the active project's context as they become known. Record durable technical decisions separately only when they meet the ADR test in
domain-modeling.Done when every newly settled decision is captured in the appropriate project artifact.
End when the frontier is empty. Summarize the shared understanding and wait for the user's confirmation before taking action based on it.
Done when the user confirms the understanding.