opchain skills ecosystem
Checkpoint-driven pipeline · 36 skills · 6 phases · 11 tri-agent · 3 audit gates · spine ordinals · v1.7 Seams & Signals · v1.8 quality-gate rail · v1.9 assurance rail · v2.0 learning rail
Foundation · cross-cutting
/oc-ops · routing · cross-project status · gate enforcement.1DiscoverPhase 1 of 6
Reverse-engineer existing codebases into structured spec documents. The output feeds oc-app-architect as a Phase 2 baseline so the oc-orchestrator never starts from a cold context. Optional — greenfield projects skip this band entirely.
2PlanPhase 2 of 6
oc-app-architect anchors the spine, auto-invoking oc-stack-forge for platform decisions, taking advisory input from oc-scale-ops on capacity, and routing oc-migration-ops when a live system needs a schema, framework, or platform change. The plan checkpoint is the master record downstream skills consume. In v1.5, /oc-discover gained an “AI app?” branch that routes to the new AI phase.
Pack fabricv1.5 · 36
oc-stack-forge owns the registry; 6 skills consume it. Source: skills/oc-stack-forge/packs/<id>/pack.yml
3AIPhase 3 of 6 · NEW
v1.5 adds an AI-native phase. When /oc-discover flags an AI app, oc-app-architect chains to four new skills — oc-claude-api (model routing · caching · tool use · migration), the tri-agent pair oc-rag-forge (vector DB · embeddings · hybrid search · retrieval eval) and oc-agent-forge (Agent SDK · subagents · tool budgets · agent eval), and oc-prompt-ops (prompt versioning · eval datasets · regression). All four ship gated behind skills.registry.<id>.enabled and return checkpoints to oc-app-architect; oc-rag-forge consumes the vector-db packs.
4BuildPhase 4 of 6
Three tri-agent loops (oc-ux-engineer · oc-api-dev · oc-integrations-engineer) plus the dense-UI specialist (oc-dash-forge) work in parallel. oc-ux-engineer hands data-heavy screens to oc-dash-forge; oc-api-dev produces an OpenAPI/GraphQL contract that the deploy-time drift gate later enforces. All four feed checkpoints back to oc-app-architect.
5ShipPhase 5 of 6
Three audit gates (oc-bug-check pre-commit, oc-code-auditor for code-level findings, oc-security-auditor for STRIDE/OWASP/infra) all must pass before oc-deploy-ops will run the production sequence. At release boundaries the spine threads oc-git-ops → oc-release-ops → oc-deploy-ops; oc-release-ops produces the changelog · version bump · release ticket · announcement, then hands off (it is not itself a deployer). v1.5 taught oc-code-auditor prompt-injection and tool-use safety rules for AI apps.
6MonitorPhase 6 of 6
oc-deploy-ops hands off to oc-monitoring-ops once production is green. oc-monitoring-ops also receives oc-api-dev's SLO + drift manifest so contract violations alert the same way uptime errors do. Incident response runbooks and postmortems live here.
Quality-gate railv1.8 · PR gate
v1.8 reframes every gate onto one boundary timeline. The new piece is the PR rail: oc-git-ops chains to oc-docs-forge (writes the docs packet — README, changelog, ADR, PR body) then oc-repo-ops (repo hygiene + generated-file/catalog drift), which fails closed when the repo is not ready. It is a sequence oc-git-ops follows — unlike the commit gate, no hook enforces it. The commit gate (oc-bug-check) and the two deploy gates (oc-code-auditor, oc-security-auditor) are unchanged — they also appear in the Ship band above.
Assurance railv1.9 · 4 new
v1.9 lands four skills as one cross-cutting rail rather than four more boxes in the phase bands. oc-qa-ops decides which tests exist — split out of oc-bug-check, which still executes them at the commit gate — and writes .opchain/qa.yaml; a coverage-budget miss warns by default, and only coverage.enforce: fail makes it block. oc-data-ops is the 9th tri-agent (Designer / Builder / Contract-Verifier), invoked by oc-app-architect when discovery surfaces a data-heavy backend; the warehouse and queue choice still comes from oc-stack-forge. oc-compliance-ops keeps a standing control register and is inert until a project adds .opchain/compliance.yaml. oc-security-hardening is the execution half of a pair — oc-security-auditor assesses, this one executes. The last two each attach a conditional row to oc-deploy-ops' existing audit gate, so the ecosystem still has three gates, not five.
Learning railv2.0
Learn from completed work. Opchain 2.0 contains 36 skills, including oc-update, Hindsight and Evolve. The shared runtime stores scored outcomes in .opchain/learning/, checks recurring weak results and returns approved lessons as advisory context. Evolve uses recorded task runs and an externally trusted reviewer signature. Your team configures provider access, reviewer keys and separate evaluator sessions. Context is delivered through explicit commands.
Appendix A · Cross-cuttingCheckpoint Protocol — sync topology
Skills use a shared checkpoint protocol to save progress. The updater preserves existing checkpoints. The oc-orchestrator both reads from and writes to each — bidirectional sync. Diagram below shows 6 representative connections; the same topology extends to all 36 skills.
"skill": "oc-app-architect",
"phase": "build",
"progress_table": { "discover": "complete" },
"context_primer": "2-sentence summary...",
"blockers": ["waiting on API key"],
"next_actions": ["/oc-git-sync"],
"cost": { "total_usd": 1.81 },
"eval_scores": [{ "rubric": "oc-bug-check" }],
"telemetry_handle": { "enabled": false }
}
Appendix B · Cross-cuttingOrchestrator — routing decision flow
When a request enters /oc-ops, the oc-orchestrator reads source-skill checkpoint state, decides the next skill, and dispatches. All three states shown together (desktop version animates each in sequence).
Legend
Connections · markers · skill types
oc-app-architect → oc-stack-forge · oc-app-architect → oc-ux-engineeroc-scale-ops → oc-app-architect · oc-migration-ops ↔ oc-app-architect.checkpoints/<skill>.checkpoint.json · phase · progress · blockers · next_actions/oc-ops routing. All 36 skills carry ORC — every skill is route-addressable by the oc-orchestrator./oc-ops · cross-project routing · gate enforcement · "what should I do next"oc-app-architect orchestrates the build; oc-deploy-ops orchestrates the ship; oc-orchestrator routes across projects.Reference
Pipeline patterns at a glance
Spine Ordinals
- Mint pills on the 6 spine skills mark the handoff sequence
- 1 oc-reverse-spec → 2 oc-app-architect → 3 oc-git-ops → 4 oc-release-ops → 5 oc-deploy-ops → 6 oc-monitoring-ops
- Direction is implicit from vertical reading order
- Branch handoffs noted inline as captions:
- oc-ux-engineer → oc-dash-forge
- oc-api-dev / integ-eng → oc-code-auditor
- oc-code-auditor → oc-security-auditor
Tri-Agent Patterns
- oc-app-architect: Generator / Evaluator
- oc-ux-engineer: Planner / Generator / Evaluator
- oc-api-dev: Designer / Builder / Conformance
- oc-integrations-engineer: Planner / Builder / Tester
- oc-code-auditor: Auditor / Fixer / Verifier
- oc-rag-forge: Designer / Builder / Evaluator (v1.5)
- oc-agent-forge: Planner / Builder / Evaluator (v1.5)
- oc-signal-forge: Designer / Builder / Evaluator (v1.7)
- oc-data-ops: Designer / Builder / Contract-Verifier (v1.9)
- oc-hindsight: Curator / Lesson Gen / Retrieval Eval (v2.0)
- oc-evolve: Reflector / Rule Gen / Adversarial Eval (v2.0)
Audit Gates (3)
- oc-bug-check — pre-commit type/lint/secret scan
- oc-code-auditor — code-level Auditor/Fixer/Verifier
- oc-security-auditor — STRIDE / OWASP / posture assessment
- All three must pass before oc-deploy-ops ships
- v1.9 adds 2 conditional rows to the deploy gate — oc-compliance-ops evidence, oc-security-hardening manifest-verify. Still 3 gates.
- v2.0 adds ★ human gates on promote and adopt — not audit gates. Still 3.
Checkpoint Protocol
- JSON files at
.checkpoints/<skill>.checkpoint.json - Keys: phase · progress_table · context_primer · blockers · next_actions
- All 36 skills share checkpoint access (no ACL)
- 2.0 · shared history and task evidence · checkpoint wire 1.1
- Resume order: own → upstream → novice mode
- Framework-agnostic — no platform lock-in
Routing Key
- Bus pattern: 1 trunk + N branches for fan-outs/fan-ins
- Width: spine 2px · secondary 1.8px · advisory 1.5px · gate 2px
- Style: solid for spine handoffs · dashed for chains-to / advisory / gate
- Bidirectional: paired arrows when the receiver also sends back (advisor pattern)
- Mobile note: vertical reading order replaces left-right gutter routing from desktop