# 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.