Doctrine Spine
Use When
- Use at project start, engine audits, skill routing reviews, and major workflow redesigns.
- Use when deciding which skills must run and in what order.
- Use when the engine risks becoming a loose library rather than an operating system.
Do Not Use When
- A small task already has a prescribed single-skill workflow.
- The user asks for a narrow source check or code edit.
Doctrine Intake Guidance
- Project type, audience, output family, cohorts, evidence risk, and decision stakes.
- Existing project context and registry state.
Doctrine Method Detail
- Start with evidence discipline and source evaluation.
- Define research design, cohorts, scope, and outputs.
- Run collection waves and preserve sources.
- Verify sources, claims, quotes, and gaps.
- Build evidence-claim graph.
- Run critical reasoning and analytic tradecraft.
- Add calibration where forecasts or risk calls exist.
- Add decision support where the output recommends action.
- Select report shape and executive communication style.
- Productize reusable knowledge only after verification.
- Export with validation and release evidence.
Quality Standards
- Mandatory order is explicit.
- No synthesis occurs before verification.
- No recommendation occurs before reasoning and tradecraft checks.
- No monetization claim outruns the evidence base.
Legacy Doctrine Pitfalls
- Jumping from source collection to polished report.
- Running report design before knowing the decision and evidence maturity.
- Treating source verification as optional.
- Productizing unverified claims.
Doctrine Deliverable Detail
- Mandatory skill route.
- Wave-to-gate crosswalk.
- Release readiness checklist.
Evidence Produced
| Category |
Artifact |
Format |
Example |
| Operability |
Doctrine route |
Markdown checklist |
Skill order and gate order |
| Release evidence |
Wave-to-gate crosswalk |
Markdown table |
Wave, output, validation gate |
References
- Load
references/research-operating-sequence.md for the canonical sequence and crosswalk.
Companion Skills
Capability Contract
Routing and audit are read-only by default. Changing routers, skills, project state, publication, or release requires explicit authority.
Degraded Mode
If project state or a mandatory gate is unavailable, return the verified prefix of the route and mark later gates blocked; never infer readiness.
Decision Rules
| Choice |
Action |
Failure/risk avoided |
| Evidence is unverified |
Hold synthesis |
Unsupported claim |
| Output recommends action |
Add reasoning and decision support |
Advice without logic |
| Reusable product is proposed |
Verify before productization |
Scaling error |
Doctrine Correction Examples
- Skipping verification; hold synthesis.
- Drafting before the decision is known; return to intake.
- Monetising unverified claims; block productization.
- Treating optional craft as a mandatory gate; justify route.
- Claiming release with missing evidence; mark blocked.
Doctrine Scenario
A verified descriptive brief may skip forecasting, but cannot skip evidence discipline or source verification.
Companion Skills
research-orchestration runs the wave model.source-verification enforces verification before synthesis.analytical-report-shapes selects the final artifact.
Inputs
| Input |
Source/provider |
If absent |
| Project type, audience, decision, risk, output family |
Brief and registry |
Stop and request missing decision context |
| Gate status and active catalogue |
Project evidence and filesystem |
Return only the verified route prefix |
Workflow
- Establish evidence discipline, project design, audience, decision, and output.
- Sequence collection, verification, reasoning, and applicable downstream gates.
- Stop when a mandatory upstream gate fails or its evidence is unavailable.
- Recover by repairing the failed gate and resuming from its checkpoint.
- Release only when every included gate has an observable pass condition.
Outputs
| Artefact |
Consumer |
Acceptance condition |
| Mandatory route and gate crosswalk |
Orchestrator and release reviewer |
Every stage has an owner, predecessor, evidence output, stop condition, and acceptance gate |
Anti-Patterns
- Skipping verification. Fix: hold synthesis until claims pass.
- Drafting before the decision. Fix: return to intake.
- Productising unverified claims. Fix: block reuse.
- Making every skill mandatory. Fix: justify the minimum route.
- Claiming release without evidence. Fix: mark the route blocked.
Worked Example
A verified descriptive brief may omit forecasting, but still passes evidence discipline, verification, reasoning, output-shape, and release gates.
1---2name: doctrine-spine3description: Use when defining or auditing the mandatory operating sequence for the research engine: evidence discipline, research design, collection, verification, reasoning, tradecraft, calibration, decision support, report shape, productization, and export.4---56# Doctrine Spine78<!-- dual-compat-start -->910## Use When1112- Use at project start, engine audits, skill routing reviews, and major workflow redesigns.13- Use when deciding which skills must run and in what order.14- Use when the engine risks becoming a loose library rather than an operating system.1516## Do Not Use When1718- A small task already has a prescribed single-skill workflow.19- The user asks for a narrow source check or code edit.2021## Doctrine Intake Guidance2223- Project type, audience, output family, cohorts, evidence risk, and decision stakes.24- Existing project context and registry state.2526## Doctrine Method Detail27281. Start with evidence discipline and source evaluation.292. Define research design, cohorts, scope, and outputs.303. Run collection waves and preserve sources.314. Verify sources, claims, quotes, and gaps.325. Build evidence-claim graph.336. Run critical reasoning and analytic tradecraft.347. Add calibration where forecasts or risk calls exist.358. Add decision support where the output recommends action.369. Select report shape and executive communication style.3710. Productize reusable knowledge only after verification.3811. Export with validation and release evidence.3940## Quality Standards4142- Mandatory order is explicit.43- No synthesis occurs before verification.44- No recommendation occurs before reasoning and tradecraft checks.45- No monetization claim outruns the evidence base.4647## Legacy Doctrine Pitfalls4849- Jumping from source collection to polished report.50- Running report design before knowing the decision and evidence maturity.51- Treating source verification as optional.52- Productizing unverified claims.5354## Doctrine Deliverable Detail5556- Mandatory skill route.57- Wave-to-gate crosswalk.58- Release readiness checklist.5960## Evidence Produced6162| Category | Artifact | Format | Example |63|---|---|---|---|64| Operability | Doctrine route | Markdown checklist | Skill order and gate order |65| Release evidence | Wave-to-gate crosswalk | Markdown table | Wave, output, validation gate |6667## References6869- Load `references/research-operating-sequence.md` for the canonical sequence and crosswalk.7071<!-- dual-compat-end -->7273## Companion Skills7475## Capability Contract7677Routing and audit are read-only by default. Changing routers, skills, project state, publication, or release requires explicit authority.7879## Degraded Mode8081If project state or a mandatory gate is unavailable, return the verified prefix of the route and mark later gates blocked; never infer readiness.8283## Decision Rules8485| Choice | Action | Failure/risk avoided |86|---|---|---|87| Evidence is unverified | Hold synthesis | Unsupported claim |88| Output recommends action | Add reasoning and decision support | Advice without logic |89| Reusable product is proposed | Verify before productization | Scaling error |9091## Doctrine Correction Examples9293- Skipping verification; hold synthesis.94- Drafting before the decision is known; return to intake.95- Monetising unverified claims; block productization.96- Treating optional craft as a mandatory gate; justify route.97- Claiming release with missing evidence; mark blocked.9899## Doctrine Scenario100101A verified descriptive brief may skip forecasting, but cannot skip evidence discipline or source verification.102103## Companion Skills104105- `research-orchestration` runs the wave model.106- `source-verification` enforces verification before synthesis.107- `analytical-report-shapes` selects the final artifact.108109## Inputs110111| Input | Source/provider | If absent |112|---|---|---|113| Project type, audience, decision, risk, output family | Brief and registry | Stop and request missing decision context |114| Gate status and active catalogue | Project evidence and filesystem | Return only the verified route prefix |115116## Workflow1171181. Establish evidence discipline, project design, audience, decision, and output.1192. Sequence collection, verification, reasoning, and applicable downstream gates.1203. Stop when a mandatory upstream gate fails or its evidence is unavailable.1214. Recover by repairing the failed gate and resuming from its checkpoint.1225. Release only when every included gate has an observable pass condition.123124## Outputs125126| Artefact | Consumer | Acceptance condition |127|---|---|---|128| Mandatory route and gate crosswalk | Orchestrator and release reviewer | Every stage has an owner, predecessor, evidence output, stop condition, and acceptance gate |129130## Anti-Patterns131132- Skipping verification. **Fix:** hold synthesis until claims pass.133- Drafting before the decision. **Fix:** return to intake.134- Productising unverified claims. **Fix:** block reuse.135- Making every skill mandatory. **Fix:** justify the minimum route.136- Claiming release without evidence. **Fix:** mark the route blocked.137138## Worked Example139140A verified descriptive brief may omit forecasting, but still passes evidence discipline, verification, reasoning, output-shape, and release gates.
peterbamuhigire