Roles and Evidence
A productive AI-assisted workflow does not treat “the AI” as one all-purpose author. Each role has a different job, authority boundary, and required handoff.
Canonical roles
Section titled “Canonical roles”Handoff rules
Section titled “Handoff rules”A good handoff states:
- the artifact being handed over,
- the decisions that are already approved,
- the questions still open,
- the evidence already collected,
- the checks the next role must perform,
- changes the next role is not authorized to make silently.
For example, the Drowned Bell design approved letter-first exploration. The Technical Implementer therefore had to preserve that path rather than gating the satchel until the first quest began.
Evidence labels
Section titled “Evidence labels”The same claim can require several kinds of evidence
Section titled “The same claim can require several kinds of evidence”Consider this claim:
Finding the sealed letter before speaking with Mara does not block the campaign.
The evidence is layered:
- Contract: a quest objective may use
completeWhen: { hasItem: ... }. - Validator: the item, quest, objective, dialogue, and action references are valid.
- Runtime/test: the objective recognizes current inventory after the quest starts.
- Human playtest: the letter-first route is understandable and leads naturally to Oren.
No single layer proves all four.
How to write a useful finding
Section titled “How to write a useful finding”A review finding should include:
- severity,
- affected artifact or path,
- observed or inferred behavior,
- evidence type,
- player or author impact,
- recommended disposition.
Avoid vague statements such as “the quest may be broken.” Prefer:
Major — Static inference:
recover_letterdepends only on an acquisition event gated by the active quest. Opening the one-time satchel first consumes the event and leaves no later producer for the objective. Reproduce with the letter-first playtest route; replace event-only progression with a current-state item condition.
Human authority remains explicit
Section titled “Human authority remains explicit”AI can accelerate ideation, implementation, review, and documentation. It does not own the campaign and does not make the final release decision.
The human campaign owner decides when evidence is sufficient and whether remaining risks are acceptable.