mattpocock-skills-opencode/.opencode/state/status.md

Project status

Updated: 2026-10-14 (phase 0 — analysis)

Current phase

Phase 0 (analysis) — COMPLETE. Phase 1 (plugin package) ready to start at TODO 1.1.

Done

• Repo bootstrapped (was empty; Gitea remote haylan/mattpocock-skills-opencode configured).
• Studied reference repos (cloned to temp, not vendored):
  • fastcrw-opencode-websearch — V2 plugin shape, Gitea release script/workflows, test style (node --test on .ts), prettier/tsconfig conventions.
  • mcdays94/pocock-agents — proven orchestrator/worker agent pair (V1-era, tracks upstream v1.3 d81f3a1), drift-check script, Docker smoke test.
  • mattpocock/skills @ 49dd158 (2026-10-09, v1.3.1) — all 38 SKILL.md files read in full by a subagent: frontmatter census (only name/description/disable-model-invocation×23/argument-hint×4/ metadata.credits×1), dependency graph, subagent census, 17 pending patch changesets.
• Verified OpenCode V2 API surface against docs + anomalyco/opencode@dev source + installed @opencode/plugin@2.0.29 typings (see AGENTS.md "Key V2 facts").
• Wrote: AGENTS.md, state files (upstream/decisions D1–D8/classification.json), TODO.md, docs/architecture.md, docs/skill-mapping.md (31 vendored + 7 excluded skills classified).

Known gaps / risks

• Unverified at runtime: exact Skill.Info field set accepted by editor.add (docs show id/name/description/path/content + autoinvoke; confirm against installed @opencode/plugin typings in Phase 1). Same for permissions array frontmatter in agent .md — verify with a real opencode serve smoke.
• Background subagents: V1 needed OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true; V2 status unknown — orchestrator must work in batch mode either way.
• request.body overlays are accepted but not sent by the V2 runner yet — don't rely on temperature tuning.
• Nightly commit-back to main needs a Gitea token with repo write scope (same PACKAGE_TOKEN pattern as fastcrw, which used it for tags + package link).

Next steps (exact)

1. Phase 1.1: scaffold package (package.json @haylan/opencode-pocock — confirm scope with owner, tsconfig, prettier, .gitignore, MIT LICENSE + upstream attribution, README stub).
2. Phase 1.2: scripts/sync-upstream.ts + vendor upstream/ @49dd158 (strip non-skill files: keep skills/{engineering,productivity,misc}/** minus agents/openai.yaml; write UPSTREAM.json).
3. Phase 1.6 note: agent templates = port pocock.md/pocock-worker.md from mcdays94/pocock-agents (temp clone path in status history) to V2-native frontmatter + add pocock-reviewer; update stack-skills table to be user-editable; worker skill allow-list from classification.json.