SKILLS · ARCHITECTURE · v2 · MOBILE · v1.8

opchain skills ecosystem

Checkpoint-driven pipeline · 29 skills · 6 phases · 8 tri-agent · 3 audit gates · spine ordinals · v1.6 instrument rail · v1.7 Seams & Signals · v1.8 quality-gate rail

Foundation · cross-cutting
PROTOCOL oc-checkpoint-protocol
JSON schema written by every skill: phase · progress · blockers · next_actions · wire 1.1: cost · eval_scores · telemetry_handle. Single source of truth — no database, no vendor lock-in.
ORCH oc-orchestrator
/oc-ops · routing · cross-project status · gate enforcement.
RAIL Instrumentation rail · v1.6
oc-cost-ops + oc-telemetry-ops · NEW · gated · tap every band ↓

1 Discover Phase 1 of 6

1 oc-reverse-spec Specialist · Workflow /oc-rev-spec · /oc-rev-full

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.

CPphase · codebase_scan · spec_output

2 Plan Phase 2 of 6

oc-scale-ops Advisor /oc-scale · perf · capacity auto-invoke ↓ ↑ advisory oc-stack-forge Advisor /oc-stack · /oc-stack-decide auto-invoke ↓ ↑ advisory 2 oc-app-architect Tri-agent · Orchestrator Generator / Evaluator · QA ≥ 7/10 /oc-app · /oc-discover · /oc-spec /oc-design · /oc-build · /oc-launch auto-invokes: stack-forge · ux-engineer auto-invoke ↓ ↑ advisory oc-migration-ops Specialist /oc-migrate · schema · platform oc-modularize-ops Specialist · gated ops · NEW v1.7 /oc-modularize · → migration ↓ spine 2 → 3 (build)

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.

CPphase · stack_decision · capacity · migration_plan
Pack fabric v1.5 · 36

oc-stack-forge owns the registry; 6 skills consume it. Source: skills/oc-stack-forge/packs/<id>/pack.yml

LANGUAGES 13
buncsharpdenoelixirgojavakotlinphppythonrubyrustswifttypescript
FRAMEWORKS 9
dotnet-aspnetlaravel-phpphoenixremixsolidspring-javaspring-kotlinsveltekitswiftui
MOBILE 4
kotlin-androidflutterios-swiftuireact-native-expo
DEPLOY 6
app-storeaws-amplifyplay-storeherokunetlifyrailway
VECTOR-DB · NEW v1.5 4
pgvectorpineconesupabase-vectorsturbopuffer
consumed by oc-stack-forge · oc-app-architect · oc-migration-ops · oc-api-dev · oc-deploy-ops · oc-rag-forge View /coverage →

3 AI Phase 3 of 6 · NEW

↑ “AI app?” branch off oc-app-architect oc-claude-api Specialist · Advisor /oc-claude-api · model routing NEW · v1.5 · gated oc-rag-forge Tri-agent · Designer/Builder/Eval /oc-rag · vector DB · eval NEW · v1.5 · gated oc-agent-forge Tri-agent · Planner/Builder/Eval /oc-agent · Agent SDK NEW · v1.5 · gated oc-prompt-ops Specialist · prompt-as-code /oc-prompt · eval · regression NEW · v1.5 · gated ↓ checkpoints → oc-app-architect → build

v1.5 adds an AI-native phase. When /oc-discover flags an AI app, oc-app-architect auto-invokes 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.

CPphase · model_routing · retrieval · agent_topology · prompt_versions

4 Build Phase 4 of 6

oc-ux-engineer Tri-agent · Planner / Generator / Eval /oc-uxe · /oc-design branches → oc-dash-forge oc-dash-forge Specialist · Tufte-density UI /oc-data-forge · /dashboard parallel build track ↓ PARALLEL · API + INTEGRATIONS oc-api-dev Tri-agent · OpenAPI / GraphQL first-party API surface branches → oc-code-auditor oc-integrations-engineer Tri-agent · Planner / Builder / Tester /oc-integrate · OAuth · webhooks branches → oc-code-auditor ↑ ALL 4 RETURN CHECKPOINTS to oc-app-architect (Phase 2) oc-signal-forge Tri-agent · Designer/Builder/Eval /oc-signal · frame · verify · wire ↓ spine 3 (ship)

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.

CPphase · ux_specs · api_surface · integrations · dashboards

5 Ship Phase 5 of 6

oc-bug-check Audit gate · pre-commit type · lint · secrets · vuln /oc-bugcheck 3 oc-git-ops Specialist · Workflow /oc-git · /oc-commit · /oc-pr · /oc-push auto-runs oc-bug-check pre-commit ↑ ↓ MUST PASS BEFORE PROD oc-code-auditor Tri-agent · gates prod Auditor · Fixer · Verifier /oc-audit · score ≥ 7/10 branches → oc-security-auditor oc-security-auditor Audit gate · posture review STRIDE · OWASP · TLS · CSP /oc-security · /oc-threat-model 3rd of 3 gates 3 GATES PASSED → RELEASE 4 oc-release-ops Specialist · Workflow plan draft bump announce ship activates at release boundaries only /oc-release · changelog · semver · ticket hand off 5 oc-deploy-ops Orchestrator · Workflow /oc-deploy gates → prod → rollback enforces all 3 audit gates oc-fleet-ops Specialist · gated ops · NEW v1.7 /oc-fleet · ↔ deploy peer ↓ spine 5 → 6 (monitor)

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.

CPphase · audit_score · posture · branch · pr · release_tag · deploy_status

6 Monitor Phase 6 of 6

6 oc-monitoring-ops Specialist · observability /oc-monitor · uptime · SLO + oc-api-dev SLO/drift manifest

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.

CPphase · slo_status · alert_rules · incident_log
Quality-gate rail v1.8 · PR gate
COMMIT · 1 gate oc-bug-check type · lint · secrets · vuln /oc-bugcheck PR · 2 new gates · v1.8 oc-docs-forge docs packet · README · changelog · ADR /oc-docs · pre-PR & release oc-repo-ops PR-readiness gate · drift · hygiene /oc-repo · blocks PR until clean DEPLOY · 2 gates code-auditor · security-auditor tri-agent ≥7/10 · STRIDE · OWASP · CSP both must pass → prod /oc-audit · /oc-security

v1.8 reframes every gate onto one boundary timeline. The new piece is the PR gate: oc-git-ops auto-invokes oc-docs-forge (writes the docs packet — README, changelog, ADR, PR body) then oc-repo-ops (repo hygiene + generated-file/catalog drift), which blocks the PR until the repo is clean. 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.

CPdocs-forge + repo-ops write phase · pr_docs · readiness · drift
Appendix A · Cross-cutting

Checkpoint Protocol — sync topology

Every skill (all 29) writes a JSON checkpoint after each state change. The oc-orchestrator both reads from and writes to each — bidirectional sync. Diagram below shows 6 representative connections; the same topology extends to all 29 skills.

CP oc-reverse-spec CP oc-app-architect CP oc-git-ops oc-orchestrator /oc-ops · routing · sync reads + writes all CPs CP oc-deploy-ops CP monitor-ops CP oc-code-auditor
{
  "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-cutting

Orchestrator — 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).

source skill writes CP · requests next request oc-orchestrator read source CP match next_actions to registry enforce gates → dispatch dispatch target skill activates · writes new CP

Legend

Connections · markers · skill types
N
Spine ordinal
Numbered mint pill on the 6 primary-spine skills marks handoff position. Replaces directional arrows between bands — vertical reading order is the 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
Auto-invoke
Orchestrator silently triggers a sub-skill without explicit user command. The sub-skill operates in the oc-orchestrator's current phase context.
e.g. oc-app-architect → oc-stack-forge · oc-app-architect → oc-ux-engineer
Advisory
Non-blocking recommendations passed via checkpoint. The receiver can accept or override. No hard dependency.
e.g. oc-scale-ops → oc-app-architect · oc-migration-ops ↔ oc-app-architect
Audit gate
Pipeline blocks until the gate writes a passing result. Three gates in this ecosystem: oc-bug-check (pre-commit), oc-code-auditor (code-level), oc-security-auditor (posture).
score ≥ 7/10 · STRIDE clean · zero critical CVEs
CP · checkpoint indicator
Solid ember dot in each skill's top-right corner indicates the skill writes a checkpoint. All 29 skills carry CP — desktop version shows full CP badge on each rect; mobile uses the dot for legibility.
.checkpoints/<skill>.json · phase · progress · blockers · next_actions
ORC · oc-orchestrator indicator
Faded ember dot adjacent to the CP dot indicates the skill participates in /oc-ops routing. All 29 skills carry ORC — every skill is route-addressable by the oc-orchestrator.
/oc-ops · cross-project routing · gate enforcement · "what should I do next"
Skill types
Tri-agent
Skills running an internal Planner / Generator / Evaluator loop. The Evaluator scores output (≥ 7/10 to advance); failure triggers Generator retry until threshold or max iterations.
oc-app-architect · oc-ux-engineer · oc-api-dev · oc-integrations-engineer · oc-code-auditor · oc-rag-forge · oc-agent-forge
Advisor
Non-orchestrating skills that return recommendations or analysis. No tri-agent loop. Results fed back via checkpoint; caller can override.
oc-stack-forge · oc-scale-ops
Standalone specialist
Single-purpose skills that produce a concrete artifact and hand it off. No internal loop, no orchestration of others.
oc-reverse-spec · oc-dash-forge · oc-git-ops · oc-release-ops · oc-migration-ops · oc-monitoring-ops · oc-cost-ops · oc-telemetry-ops (v1.6)
Workflow / oc-orchestrator
Skills that drive structured, sequential pipelines. oc-app-architect orchestrates the build; oc-deploy-ops orchestrates the ship; oc-orchestrator routes across projects.
oc-app-architect · oc-deploy-ops · oc-orchestrator
Audit gate
Quality enforcement skills that block pipeline progression until thresholds are met. Three in this ecosystem cover three layers: pre-commit, code-level (also tri-agent — see yellow stroke on oc-code-auditor), security posture.
oc-bug-check · oc-code-auditor · oc-security-auditor

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 (7)

  • oc-app-architect: Generator / Evaluator
  • oc-ux-engineer: Planner / Generator / Evaluator
  • oc-api-dev: Planner / Generator / Evaluator
  • 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)

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 / infra hardening
  • All three must pass before oc-deploy-ops ships

Checkpoint Protocol

  • JSON files at .checkpoints/<skill>.json
  • Keys: phase · progress_table · context_primer · blockers · next_actions
  • All 29 skills read all 29 checkpoints (no ACL)
  • 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 auto-invoke / 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