Overview
/silver classifies intent and routes to a catalog-backed workflow (silver:feature, silver:ui, …) or a dynamic route. Workflows compose canonical atomic flow IDs and reusable workflow components from the APO catalog. Each atomic flow is one subagent work package with its own V-loop; each flow step/skill has a local V-loop that rolls up before the parent flow gate can pass.
Active composition state lives in .planning/workflows/<id>.md (Flow Log CSV rows). The retired single-file WORKFLOW.md model is legacy only. SB is the lifecycle authority — no external workflow delegation.
hooks/lib/orchestrator-state.sh.Composer Workflows
Composer workflows are catalog-backed workflow entities. They compose atomic flow slugs and reusable workflow components; conditional insertions are recorded through catalog dynamic rules and composition logs.
| Composer | Entry signals | Catalog Composition |
|---|---|---|
| /silver | freeform intent, unclear route, mixed work | ROUTE → feature: BOOTSTRAP → … → EXECUTE → post-exec gatesROUTE → fast: FAST_PATH → QUALITY_GATE → PLAN → VALIDATE → EXECUTE → VERIFY |
| /silver:deep-research | compare X vs Y, spike, technology decision | CLARIFY → DECIDE → DOCUMENT → VALIDATE |
| /silver:feature | add, build, implement, new feature, enhance | BOOTSTRAP → ORIENT → CLARIFY → DECIDE → SPECIFY → QUALITY_GATE → PLAN → DESIGN_CONTRACT → EXECUTE → [UI_QUALITY if UI] → REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE → VERIFY (verify-tests) → SECURE (VALIDATE as needed) → QUALITY_GATE → BRANCH_FINISH → COMPLETION_AUDIT → SHIP |
| /silver:bugfix | bug, broken, crash, error, regression | [ORIENT if needed] → DEBUG → PLAN → EXECUTE → REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE → VERIFY (verify-tests) → SECURE (VALIDATE as needed) → QUALITY_GATE → BRANCH_FINISH → COMPLETION_AUDIT → SHIP |
| /silver:ui | UI, frontend, component, screen, design | BOOTSTRAP → ORIENT → CLARIFY → DECIDE → SPECIFY → QUALITY_GATE → PLAN → DESIGN_CONTRACT → EXECUTE → UI_QUALITY → REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE → VERIFY (verify-tests) → SECURE (VALIDATE as needed) → QUALITY_GATE → BRANCH_FINISH → COMPLETION_AUDIT → SHIP |
| /silver:fast | trivial, typo, bounded small change | FAST_PATH → QUALITY_GATE → PLAN → VALIDATE → EXECUTE → VERIFY |
| /silver:devops | infra, CI/CD, terraform, IaC, cloud | BLAST_RADIUS → DEVOPS_ROUTE → QUALITY_GATE → SECURE → ORIENT → PLAN → VALIDATE → EXECUTE → REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE → VERIFY (verify-tests) → SECURE (VALIDATE as needed) → QUALITY_GATE → BRANCH_FINISH → COMPLETION_AUDIT → SHIP |
| /silver:release | release, publish, version, tag v | QUALITY_GATE → REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE → VERIFY (verify-tests) → SECURE (VALIDATE as needed) → BRANCH_FINISH → COMPLETION_AUDIT → SHIP → RELEASE |
Utility skills map to catalog slugs directly: /silver:spec supports SPECIFY; /silver:ingest is a specify step; /silver:validate supports VALIDATE.
Atomic Flow Catalog
The APO catalog defines 27 canonical atomic flows. Each entry has an input contract, work product, per-flow V-loop, owning skills, tool policy, execution block, dependency/mutation metadata, and exit condition. Full generated contracts: docs/composable-flows-contracts.md.
| Atomic flow | Slug | Capability class | Public route | Legacy alias |
|---|---|---|---|---|
AF-ROUTE | ROUTE | route intent | /silver | new in APO |
AF-BOOTSTRAP | BOOTSTRAP | project bootstrap | /silver:init | FLOW 1 |
AF-ORIENT | ORIENT | context orientation | /silver:scan, /silver:context | FLOW 2 |
AF-CLARIFY | CLARIFY | scope clarification | /silver:clarify | FLOW 3 |
AF-DECIDE | DECIDE | decision research | /silver:deep-research | FLOW 4 |
AF-SPECIFY | SPECIFY | requirements specification | /silver:spec, /silver:ingest | FLOW 5 |
AF-PLAN | PLAN | execution planning | /silver:plan | FLOW 6 |
AF-DESIGN-CONTRACT | DESIGN_CONTRACT | design contract | /silver:ui-contract | FLOW 7 |
AF-VALIDATE | VALIDATE | gap validation | /silver:validate | new in APO |
AF-QUALITY-GATE | QUALITY_GATE | cross cutting quality gate | /silver:quality-gates, /devops-quality-gates | FLOW 13 |
AF-FAST-PATH | FAST_PATH | bounded fast path | /silver:fast | new in APO |
AF-EXECUTE | EXECUTE | implementation execution | /silver:execute | FLOW 8 |
AF-DEBUG | DEBUG | failure diagnosis | /silver:debug, /silver:forensics | FLOW 15 |
AF-UI-QUALITY | UI_QUALITY | ui quality review | /silver:ui-review | FLOW 9 |
AF-VERIFY | VERIFY | verification and testing | /silver:verify | FLOW 12 |
AF-SECURE | SECURE | security and llm safety | /silver:secure | FLOW 11 |
AF-REVIEW-REQUEST | REVIEW_REQUEST | review request | /silver:review-request | new in APO |
AF-REVIEW | REVIEW | artifact and code review | /silver:review | new in APO |
AF-REVIEW-TRIAGE | REVIEW_TRIAGE | review triage and fix | /silver:review-triage | new in APO |
AF-BLAST-RADIUS | BLAST_RADIUS | blast radius assessment | /silver:blast-radius | new in APO |
AF-DEVOPS-ROUTE | DEVOPS_ROUTE | devops toolchain routing | /silver:devops (IaC routing step) | new in APO |
AF-BRANCH-FINISH | BRANCH_FINISH | branch hygiene | /silver:branch-finish | new in APO |
AF-COMPLETION-AUDIT | COMPLETION_AUDIT | completion audit | /silver:completion-audit | new in APO |
AF-SHIP | SHIP | ship readiness | /silver:ship | new in APO |
AF-RELEASE | RELEASE | release management | /silver:release, /silver:create-release | FLOW 18 |
AF-DOCUMENT | DOCUMENT | durable documentation | /silver:ensure-docs | FLOW 17 (+ FLOW 16 design handoff in release) |
AF-PHASE-MANAGE | PHASE_MANAGE | phase and state management | /silver:phase, /silver:add | new in APO |
Post-Execution Sequencing
For silver:feature, silver:ui, silver:devops, and silver:bugfix, the reusable post-execution component expands after EXECUTE:
Each atomic flow joins only after every owned flow-step V-loop passes and rolls up into the parent atomic-flow V-gate.
Composition vs Enforcement
Composer skills declare catalog-backed workflow compositions using atomic flow slugs and reusable workflow components. The orchestrator enforcement queue in hooks/lib/orchestrator-state.sh contains runtime markers needed to prove selected atoms ran; optional atoms are inserted only when context and catalog dynamic rules require them.
Worker templates under templates/orchestrator-workers/ implement catalog atomic-flow work packages. Flow-step V-loops, work products, evidence, and exit conditions live in docs/apo-catalog.json and its generated views — not in hand-authored composer prose.
Hook Activation & Recommended Tools (v0.48.3)
As of v0.48.3, hooks engage only when a project is SB-initiated: both .silver-bullet.json and silver-bullet.md must exist. Non-initiated workspaces receive no enforcement — run /silver:init first.
Recommended tools (opt-in):
- Graphify —
recommended_tools.graphify.enabled_by_userin.silver-bullet.json; preferred retrieval before planning, editing, review, and release - agentmemory —
recommended_tools.agentmemory.enabled_by_user; session capture and git-backed memory export. When both are enabled: save via agentmemory, retrieve via Graphify - RTK —
recommended_tools.rtk.enabled_by_user; shell output compression via upstream PreToolUse hooks (docs/RTK.md) - Context Mode —
recommended_tools.context_mode.enabled_by_user; MCP compaction and PreCompact recovery (docs/CONTEXT-MODE.md, ELv2 license)
Consent, install, and enforcement-suspend flows run through /silver:init and /silver:update.
Individual Workflow Pages
/silver
Dynamic router — AF-ROUTE composes feature or fast chain (WF-SILVER-ROUTER)
/silver:deep-research
Evidence-based decisions (CLARIFY → DECIDE)
/silver:clarify
Fuzzy-intent intake and decision-ready brief (CLARIFY)
/silver:spec
SPEC.md and REQUIREMENTS.md (SPECIFY)
/silver:ingest
External artifact ingestion for SPECIFY
/silver:validate
Gap analysis BLOCK/WARN/INFO
/silver:new-workflow
Create, convert, or audit catalog-backed workflows (WF-SILVER-NEW-WORKFLOW)
/silver:feature
Full feature development composition chain
/silver:bugfix
Triage-first debug → plan → execute → ship
/silver:ui
UI design contract + UI quality gate
/silver:fast
Tiered fast path for bounded small changes
/silver:test
Test hardening — plan gaps, execute, verify (WF-SILVER-TEST)
/silver:refactor
Behavior-preserving refactor with post-exec gates (WF-SILVER-REFACTOR)
/silver:benchmark
Agent/model benchmark with rubric and evidence (WF-SILVER-BENCHMARK)
/silver:content
Docs, copy, and public content workflow (WF-SILVER-CONTENT)
/silver:devops
Blast-radius, IaC gates, no application TDD
/silver:deploy
Live rollout — blast radius, verify, secure, ship (WF-SILVER-DEPLOY)
/silver:canary
Post-deploy canary watch and rollback readiness (WF-SILVER-CANARY)
/silver:release
Milestone audit, gap closure, GitHub Release
/silver:review-triad
Reusable review chain — REVIEW_REQUEST → REVIEW → REVIEW_TRIAGE (WF-REVIEW-TRIAD)
/silver:ship-readiness
Reusable ship gate — BRANCH_FINISH → COMPLETION_AUDIT → SHIP (WF-SHIP-READINESS)
/silver:incident
Production incident response and postmortem (WF-SILVER-INCIDENT)
/silver:retro
Engineering retrospective from delivery evidence (WF-SILVER-RETRO)
/silver:forensics
Session and post-mortem failure reconstruction (WF-SILVER-FORENSICS)
/silver:process-maintenance
Phase, backlog, and planning state maintenance (WF-PROCESS-MAINTENANCE)
See Also
- Composable Workflow Orchestration — supervision loop and workflow tracker
- Routing Logic — complexity triage and intent classification
- Command Reference — Composable Flows
- Software Delivery Workflow — skill-level phase map for
full-dev-cycle - DevOps & IaC Workflow — blast radius and environment promotion