persona-authorlisted
Install: claude install-skill pilotspace/ADD
# Authoring an ADD persona
A persona is a **lens, not a voice** — a distilled slice of domain expertise the ADD engine
loads onto a beat so a generic agent becomes the specialist. Author for that seam and nothing
else: **tone lives in SOUL.md**, the **six-dimension self-score lives in the agent** (add-worker),
and the **deliverable's shape lives in the agent's Return contract**. A persona that duplicates
any of those is dead weight. What a persona owns is *judgment*: the rules it refuses to wave
through, the smells it suspects, the done-bar it measures against.
Two references and one worked example back this workflow — read them as you go:
- **`references/contract.md`** — the exact engine contract (required/recommended/optional sections,
frontmatter field semantics, the flow values and task-kinds taxonomy, the quality WARNs). Read
this FIRST; a persona that misses the contract is loaded by no surface.
- **`references/patterns.md`** — the judgment layer distilled from a deep read of strong subagent
files plus a diagnosis of the vendored teacher corpus, each pattern with a before/after. This is
what separates an expert lens from a keyword list.
- **`references/seeding.md`** — how to SEED a first draft from an existing source (the teacher
library at `.add/personas-teacher/`, or a `~/.claude/agents/*.md` subagent) instead of a blank
page: the two source→schema mappings, and the columns a source never supplies (failure-aware
Success Metrics, `not-when`, read-before