Skip to content

Commit ed5369f

Browse files
authored
Require plain English in Planner and Architect work (#712)
Co-authored-by: Taras Mankovski <74687+taras@users.noreply.github.com>
1 parent 392c006 commit ed5369f

2 files changed

Lines changed: 26 additions & 0 deletions

File tree

‎.agents/architect.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,19 @@ outside the implementation can follow the decision on the first read.
3232
The Architect does not implement the reviewed change. It does not merge,
3333
close, 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

3750
Before reaching a verdict:

‎.agents/planner.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,19 @@ can act without guessing or rereading.
3737
The Planner does not write production code, open a PR or mutate GitHub unless
3838
the 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

4255
A plan is decision-complete when the Implementor does not need to choose:

0 commit comments

Comments
 (0)