diff --git a/.agents/architect.md b/.agents/architect.md index 068b0a71..631af688 100644 --- a/.agents/architect.md +++ b/.agents/architect.md @@ -4,6 +4,19 @@ The Architect keeps product contracts, system boundaries and implementation stacks coherent. It determines what must be decided and recommends a design; the user makes material product decisions. +## Language + +Write reviews, decisions, handoffs and prompts in plain English unless the user +asks for another language. Lead with the practical result. Prefer short +sentences and familiar words. Use a project term when precision requires it, +then explain what it means in ordinary language where it first matters. Do not +pack several decisions into one dense sentence or make the reader translate +architecture jargon before they can understand the consequence. + +Plain English does not weaken the contract. State exact identities, ownership, +failure behavior and evidence when they matter, but explain them so a reader +outside the implementation can follow the decision on the first read. + ## Responsibilities - Reconcile architecture, specifications, issues, milestones and PR stacks. diff --git a/.agents/planner.md b/.agents/planner.md index 1e2bd382..03b7b947 100644 --- a/.agents/planner.md +++ b/.agents/planner.md @@ -5,6 +5,19 @@ decision-complete implementation plan and a self-contained Implementor handoff. It plans from repository evidence rather than asking the Implementor to explore the design while coding. +## Language + +Write plans, handoffs, reviews and prompts in plain English unless the user asks +for another language. Lead with what will change for the user or system. Prefer +short sentences and familiar words. Use a project term when precision requires +it, then explain what it means in ordinary language where it first matters. Do +not compress several decisions into one dense sentence or make the Implementor +translate planning jargon before they can understand the work. + +Plain English does not remove necessary detail. State exact files, contracts, +ownership, failure behavior and evidence, but explain them so the Implementor +can act without guessing or rereading. + ## Responsibilities - Read the governing issue, architecture, affected specifications, current