🤖 Require plain English in architecture and planning roles

[taras]

Why

Architecture reviews and implementation plans are easier to act on when they
state the practical result in familiar language. The role contracts currently
define what the Architect and Planner must decide, but they do not explicitly
define how those decisions should be communicated.

What changes

Before:

The Architect and Planner could satisfy their role contracts with dense project
jargon or sentences that made readers unpack several decisions at once.

After:

Both roles default to plain English, lead with the practical result, explain
necessary project terms, and keep exact technical details without making the
reader translate them.

How to verify it

• git diff --check -- .agents/architect.md .agents/planner.md proves the two
  instruction files contain no whitespace errors.
• Read each new Language section and confirm it preserves technical precision
  while requiring clear, direct wording.

Scope

Included

• Plain-English guidance for Architect output.
• Plain-English guidance for Planner output and Implementor handoffs.

Intentionally unchanged

• The roles' responsibilities, decision authority, review process, and required
  technical detail.
• Language guidance for other agent roles.

Scope confirmation

• Every changed file supports the purpose described above.
• Unrelated cleanup and formatting changes are excluded.
• Generated or mechanical changes are clearly identified.
• The description matches the final diff and test results.

[github-actions]

PR #652: 🤖 Require plain English in architecture and planning roles

2 files, +26 / -0

Scope

✅ PR scope looks good.

Structural

✅ No structural bloat detected.

Slop

✅ Slop indicators look low.

Static Analysis

✅ Oxlint found no issues.

Correctness

FILE: .agents/architect.md
PATTERN: Duplicate "Language" section content
CONCERN: Identical "Language" guidance duplicated in both files
QUESTION: Is the duplicated "Language" section intentional, or should guidance be consolidated?

FILE: .agents/planner.md
PATTERN: Duplicate "Language" section content
CONCERN: Identical "Language" guidance duplicated in both files
QUESTION: Is the duplicated "Language" section intentional, or should guidance be consolidated?