Engineering Pipeline โ
TIP
Quick reference: Engineering workflows are grouped under src/cli/commands/engineering.ts and connect to sprint state, browse daemon, and quality gates.
Workflow Building Blocks โ
- Browse automation for UI checks and visual captures
- Guardian checks for destructive-command and path safety controls
- Sprint pipeline with
.cm/sprintartifacts and event progression - Advisory loop for reviewing execution analyses, skill quality, and self-healing handoffs
- Second opinion / retro / suggest helpers for analysis and follow-up
Sprint Runtime Artifacts โ
Sprint-related runtime state is managed in .cm/sprint and linked by utilities in src/sprint-pipeline.ts.
Recommended Flow โ
- Prepare context and sprint state.
- Run implementation tasks and validations.
- Run QA (including visual QA where needed).
- Review and canary before broader rollout.
- When a run degrades or a skill looks weak, use the advisory loop before changing skill behavior.
Advisory Workflow โ
Use the advisory commands when you want telemetry-backed follow-through instead of guesswork:
bash
cm advisory report --project .
cm advisory metrics --project .
cm advisory handoff --project . --for cm-skill-healthThen use the structured note with:
- the legacy
cm-skill-healthadvisory consumer id for diagnosis payloads cm-skill-evolutionforFIX,DERIVED, orCAPTURED
Risk Reduction โ
- Gate with
npm run test:gatebefore major transitions. - Use guardian checks for sensitive operations.
- Keep sprint artifacts updated for reproducible handoffs.
- Use
cm advisory handoff --format jsonwhen another agent needs the same evidence without re-querying SQLite.
See also:
- Browse daemon runbook โ Playwright install,
CM_BROWSE_TOKEN,cm qa-visual - Advisory loop โ
cm advisory report,metrics, andhandoff - Guardian hooks โ
cm guardian checkand IDE pre-exec patterns - Servers and MCP Runtime
- CLI Command Reference
- Testing and Release Gates
- ADR 001 โ Browse daemon ยท ADR 002 โ Sprint bus ยท ADR 003 โ Skill distro