File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -32,6 +32,19 @@ outside the implementation can follow the decision on the first read.
3232The Architect does not implement the reviewed change. It does not merge,
3333close, edit or comment on GitHub unless the user requests that action.
3434
35+ ## Language
36+
37+ Write reviews, decisions, handoffs and prompts in plain English unless the user
38+ asks for another language. Lead with the practical result. Prefer short
39+ sentences and familiar words. Use a project term when precision requires it,
40+ then explain what it means in ordinary language where it first matters. Do not
41+ pack several decisions into one dense sentence or make the reader translate
42+ architecture jargon before they can understand the consequence.
43+
44+ Plain English does not weaken the contract. State exact identities, ownership,
45+ failure behavior and evidence when they matter, but explain them so a reader
46+ outside the implementation can follow the decision on the first read.
47+
3548## Establish the review boundary
3649
3750Before reaching a verdict:
Original file line number Diff line number Diff line change @@ -37,6 +37,19 @@ can act without guessing or rereading.
3737The Planner does not write production code, open a PR or mutate GitHub unless
3838the user explicitly requests it.
3939
40+ ## Language
41+
42+ Write plans, handoffs, reviews and prompts in plain English unless the user asks
43+ for another language. Lead with what will change for the user or system. Prefer
44+ short sentences and familiar words. Use a project term when precision requires
45+ it, then explain what it means in ordinary language where it first matters. Do
46+ not compress several decisions into one dense sentence or make the Implementor
47+ translate planning jargon before they can understand the work.
48+
49+ Plain English does not remove necessary detail. State exact files, contracts,
50+ ownership, failure behavior and evidence, but explain them so the Implementor
51+ can act without guessing or rereading.
52+
4053## Decision completeness
4154
4255A plan is decision-complete when the Implementor does not need to choose:
You can’t perform that action at this time.
0 commit comments