| name | research-and-analysis |
| description | Source gathering, code tracing, fact versus inference separation, and evidence discipline |
| triggers | ["research a report","trace code","gather sources"] |
Research And Analysis
Gather evidence before writing report prose. Keep source notes outside the report until claims are stable.
Workflow:
- Inventory canonical docs, code paths, issues, papers, or designs.
- Trace the runtime path from entry point to data model or output.
- Mark each claim as fact, inference, or recommendation.
- Back facts with
sources entries and code line ranges when available.
- Keep uncertainty visible in synthesis
openQuestions, not hidden in confident prose.
Source of truth:
- Source schema:
packages/engine/src/schemas/source.ts
- Inline references:
packages/engine/src/schemas/synthesis.ts
- Validation rules:
packages/engine/src/validation/rules/source-refs.ts, packages/engine/src/validation/rules/block-refs.ts
- Reference UI:
packages/storybook/stories/views/ReferenceView.stories.tsx, packages/storybook/stories/reference/EntityDetailPanel.stories.tsx