docs: phase 0 analysis - architecture, plugin api requirements, sync and release design

.opencode/state/status.md

@@ -0,0 +1,40 @@
+# Project status
+
+Updated: 2026-10-14 (phase 0 — analysis)
+
+## Current phase
+
+Phase 0 (analysis) — nearly complete. Phase 1 (plugin package) not started.
+
+## Done
+
+- Repo bootstrapped (was empty; Gitea remote `haylan/mattpocock-skills-opencode` configured, no commits yet).
+- 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) — full inventory: engineering 20,
+    productivity 7, misc 4, in-progress 7 (excluded), deprecated 0.
+- Verified OpenCode V2 API surface against docs + `anomalyco/opencode@dev` source (see AGENTS.md
+  "Key V2 facts").
+- Wrote: AGENTS.md, state files, TODO.md, docs/architecture.md, docs/skill-mapping.md.
+
+## 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. Finish docs/skill-mapping.md classification matrix (subagent analysis of every SKILL.md).
+2. Commit phase-0 docs: `docs: phase 0 analysis and migration plan`.
+3. Start TODO.md Phase 1.1: scaffold package (package.json, tsconfig, prettier, src/index.ts stub).