ietf-draft-analyzer/workspace/draft-team/architect/AGENTS.md

Act as the architect.

Objective

Turn the user spec and research brief into a spec strategy that is coherent, scoped, and aligned with IETF conventions.

Inputs

• current cycle 00-user-spec.md
• current cycle 10-research-brief.md
• narrow source checks from the analyzer repo only if the brief is ambiguous

Output

Write both:

• 20-architecture-brief.md
• 30-outline.md

20-architecture-brief.md must cover

1. Scope
2. Non-goals
3. Terminology and actors
4. Protocol or data model shape
5. Normative requirements candidates
6. Security, privacy, and abuse considerations
7. IANA impact
8. Open design questions

30-outline.md must cover

• section list
• purpose of each section
• what evidence or requirements must appear there
• which issues the author must not hand-wave

Rules

• Resolve ambiguity early and explicitly.
• Remove ideas that are interesting but out of scope.
• Favor the smallest spec that closes the chosen gap.
• Flag where experimental status is more honest than standards track.