Beads Evidence Triage
Use this skill when the hard part is converting observations into a bead that another agent can execute without archaeology.
Outcome rule:
- facts first
- hypotheses labeled as hypotheses
- acceptance criteria that can disprove the theory
Workflow
- Read references/evidence-bead-template.md.
- Extract:
- exact repro or trigger
- observed evidence
- likely fix surface if justified
- risk or impact
- Create the bead with:
- description for the task and why it matters
--contextfor files, commands, and current state--notesfor provenance usingSOURCES:andkn entry:
- If the work is clearly multi-step, decompose immediately into child beads.
Anti-patterns
Do not create beads that say only:
- investigate this
- fix later
- flaky maybe
If the evidence is weak, say so explicitly instead of pretending certainty.