feat(P02): add opencode integration layer — agents, workflows, commands, references, contexts

---ci---
phase: 2
milestone: v0.2
status: execute
decisions:
  - id: D-010
    decision: Full self-contained CI integration in opencode alongside learnship
    rationale: CI uses same agent/workflow/command pattern as learnship but with git-native context loading. Commands prefixed ci- vs learnship-. Zero learnship dependencies.
    confidence: 0.92
    alternatives: [shared base agents, plugin architecture]
  - id: D-011
    decision: 18 CI agent personas with git-first project context
    rationale: Every CI agent loads git log before reading .ci/ files. This ensures the git log IS the project memory — the core v0.2.0 design principle.
    confidence: 0.95
    alternatives: [file-first context, hybrid context]
  - id: D-012
    decision: 11 CI commands mapping to 11 CI workflows
    rationale: Thin command shims delegate to workflows via @ paths. Matches learnship pattern for consistency. Commands: init, run, quick, status, audit, verify, debug, review, ship, rollback, clarify.
    confidence: 0.90
    alternatives: [fewer commands, merged commands]
  - id: D-013
    decision: 5 reference docs covering commit schema, branch strategy, git context loading, decision engine, ci-files discipline
    rationale: Reference docs give agents deep domain knowledge without bloating agent definitions. Matches learnship reference pattern.
    confidence: 0.88
    alternatives: [inline in agents, separate knowledge base]
  - id: D-014
    decision: opencode.json adds ~/.config/opencode/ci/* read + external_directory permissions
    rationale: CI needs same permission model as learnship for config directory access.
    confidence: 0.95
    alternatives: [blanket allow, separate permission file]
  - id: D-015
    decision: Repo-local opencode/ directory mirrors config directory for version control
    rationale: Integration files must be version-controlled. The opencode/ directory in the repo can be installed to ~/.config/opencode/ during setup.
    confidence: 0.85
    alternatives: [separate repo, git submodule]
---/ci---

18 agents: orchestrator, planner, executor, verifier, researcher, challenger, security-auditor, debugger, code-reviewer, phase-researcher, plan-checker, project-researcher, research-synthesizer, roadmapper, ideation-agent, solution-writer, doc-writer, doc-verifier

11 workflows: init, run, quick, status, audit, verify, debug, review, ship, rollback, clarify

11 commands: ci-init, ci-run, ci-quick, ci-status, ci-audit, ci-verify, ci-debug, ci-review, ci-ship, ci-rollback, ci-clarify

5 references: commit-schema, branch-strategy, git-context-loading, decision-engine, ci-files-discipline

3 contexts: dev, research, review
This commit is contained in:
CI
2026-05-29 13:27:00 +00:00
parent eedcdd4282
commit 05917b9808
50 changed files with 3113 additions and 0 deletions
+21
View File
@@ -0,0 +1,21 @@
---
description: Audit CI project health — reconstruct state from git log, verify .ci/ files match codebase, check for stale references
tools:
read: true
bash: true
glob: true
grep: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/audit.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI audit workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Clarify CI project ambiguities — generate questions, accept defaults at full autonomy, present at supervised/guided
argument-hint: "[phase_number]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/clarify.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI clarify workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Systematic CI debugging with git context — triage, diagnose root cause, auto-fix or escalate
argument-hint: "[description]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/debug.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI debug workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Initialize a new CI project — specification → clarify → create .ci/ reference files → initial commit
argument-hint: "[description]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/init.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI init workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Execute an ad-hoc CI task with full agentic guarantees — git context, ---ci--- commits, optional research and verification
argument-hint: "[description] [--research] [--verify] [--full]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/quick.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI quick workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+25
View File
@@ -0,0 +1,25 @@
---
description: Review CI code changes with multi-persona analysis — auto-apply P0 fixes, flag P1+ for post-hoc review
argument-hint: "[phase_number]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/review.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI review workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Rollback CI phase — revert the last phase or specified phase by resetting to its pre-phase state
argument-hint: "[phase_number]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/rollback.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI rollback workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+26
View File
@@ -0,0 +1,26 @@
---
description: Execute the full CI pipeline — research → plan → execute → verify → complete
argument-hint: "[phase_number]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
question: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/run.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI run workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+25
View File
@@ -0,0 +1,25 @@
---
description: Ship CI phase or milestone — test, commit, tag, push, release. Full autopilot: zero HITL after milestone setup
argument-hint: "[phase_number|milestone]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/ship.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI ship workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+21
View File
@@ -0,0 +1,21 @@
---
description: Show CI project status — current phase, milestone, pipeline stage, decisions, escalations, and requirements coverage
tools:
read: true
bash: true
glob: true
grep: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/status.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI status workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>
+25
View File
@@ -0,0 +1,25 @@
---
description: Verify CI project deliverables against requirements — structural, behavioral, security, and quality checks
argument-hint: "[phase_number]"
tools:
read: true
bash: true
write: true
edit: true
glob: true
grep: true
task: true
---
<execution_context>
@/home/jchery/.config/opencode/ci/workflows/verify.md
</execution_context>
<context>
Arguments: $ARGUMENTS
</context>
<process>
Execute the CI verify workflow end-to-end.
Preserve all workflow gates, validations, checkpoints, and routing.
</process>