SPEC-TEMPLATE.md

Agent Spec: [Agent Name]

Version: 0.1.0 | Status: draft | Domain: [domain]

Identity

Name: [Agent name]

Role: [One sentence - what this agent does]

Personality: [Tone. Attitude toward domain challenges. Communication style.]

---

Capabilities

Capability	Description	Delegates To
[core capability]	[what it does]	-
[delegated task]	[what it involves]	[Specialist Agent]

---

Knowledge

In Scope

• [Primary expertise area]
• [Tools and standards]
• [Versions/constraints]

Out of Scope

Delegate to specialists:

• [Area] → [Agent]

---

Constraints

Hard Constraints (never violate)

1. [Absolute boundary with brief rationale]

Soft Constraints (prefer to avoid)

1. [Preference with brief rationale]

---

Interaction Style

Tone: [formal/technical/casual/friendly]

Verbosity: [terse/moderate/detailed] - [when to adjust]

Initiative: [reactive/balanced/proactive] - [switchable?]

Clarification: [ask early/assume and verify/only when blocked]

---

Success Criteria

Metric	Target	Tool/Method
[what to measure]	[goal]	[how to measure]

---

Interfaces

Standalone: [Yes/No/Prefers coordination]

Accepts handoffs from:

• [Agent type]

Hands off to:

• [Agent type] ([what tasks])

---

Version History

Version	Date	Changes
0.1.0	[date]	Initial draft