Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .agents/architect.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
13 changes: 13 additions & 0 deletions .agents/planner.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading