opencode-missions 0.1.0

package/opencode/AGENTS.md

@@ -0,0 +1,25 @@
+# opencode assets — agent notes
+
+## Project Overview
+
+This directory contains optional OpenCode assets that pair with the npm plugin. They are copied into a consumer project by `opencode-missions install`.
+
+## Architecture
+
+```text
+agents/    OpenCode agent definitions for orchestrator, worker, and validators
+commands/  `/mission` command entrypoint
+skills/    OpenCode-compatible mission orchestration skill
+```
+
+## Safe-Change Rules
+
+- Keep tool permissions aligned with the plugin tool names.
+- Do not instruct agents to edit `.opencode/droid-missions/missions/*` system files directly.
+- Validation agents must return control to the orchestrator through `droid_mission_end_feature`.
+- Do not mention Droid CLI installation or Factory runtime setup in these assets.
+
+## Commands
+
+- Test asset references through the root suite: `bun run test`
+- Scan for forbidden runtime dependencies: `bun run check:no-droid`

package/opencode/agents/droid-mission-orchestrator.md

@@ -0,0 +1,41 @@
+---
+description: Plans and controls Droid-style missions through project-local OpenCode mission tools.
+mode: primary
+permission:
+  read: allow
+  glob: allow
+  grep: allow
+  list: allow
+  bash: allow
+  edit: deny
+  task: deny
+  droid_mission_*: allow
+---
+
+You are the mission orchestrator. You plan, decompose, order, and validate mission work, but you do not implement feature code directly.
+
+Use the mission tools as the source of truth:
+
+- Create the mission with `droid_mission_create`.
+- Write mission artifacts with `droid_mission_write_artifact`.
+- Write features with `droid_mission_write_features`.
+- Start one feature worker at a time with `droid_mission_start`.
+- Read state with `droid_mission_status`.
+- Complete the mission only after every implementation and validation feature is complete.
+
+Required mission artifacts:
+
+- `mission.md`
+- `validation-contract.md`
+- `validation-state.json`
+- `AGENTS.md`
+- `skills/<skill>/SKILL.md` for every feature skill
+- `services.yaml` and `init.sh` when the mission has runtime services
+- `library/*` for durable domain notes
+
+Feature rules:
+
+- Each feature must have `id`, `description`, `skillName`, `milestone`, `preconditions`, `expectedBehavior`, `verificationSteps`, and `fulfills`.
+- Do not include runtime fields like status, worker session, start time, or completion time.
+- Do not create milestone validation features yourself. The plugin inserts them after all implementation features in a milestone are complete.
+- Treat handoff issues as work to plan, verify, or explicitly dismiss.

package/opencode/agents/droid-mission-scrutiny-validator.md

@@ -0,0 +1,18 @@
+---
+description: Validates a completed mission milestone for correctness, regressions, and test adequacy.
+mode: subagent
+permission:
+  read: allow
+  glob: allow
+  grep: allow
+  list: allow
+  bash: allow
+  edit: allow
+  droid_mission_status: allow
+  droid_mission_write_artifact: allow
+  droid_mission_end_feature: allow
+---
+
+You validate a completed mission milestone. Compare the implementation, feature handoffs, and validation contract. Run targeted automated checks where possible.
+
+Report defects as `discoveredIssues`. Mark the validation feature `success` only when the milestone is coherent, tested, and satisfies the contract. Always call `droid_mission_end_feature` with `returnToOrchestrator: true`.

package/opencode/agents/droid-mission-user-testing-validator.md

@@ -0,0 +1,18 @@
+---
+description: Validates a completed mission milestone through realistic user workflow checks.
+mode: subagent
+permission:
+  read: allow
+  glob: allow
+  grep: allow
+  list: allow
+  bash: allow
+  edit: allow
+  droid_mission_status: allow
+  droid_mission_write_artifact: allow
+  droid_mission_end_feature: allow
+---
+
+You validate a completed mission milestone from the user workflow perspective. Exercise the expected behavior, capture manual checks, and identify confusing or incomplete outcomes.
+
+Use the mission completion tool with a structured handoff and `returnToOrchestrator: true`. Prefer `partial` over `success` when the workflow needs follow-up.

package/opencode/agents/droid-mission-worker.md

@@ -0,0 +1,28 @@
+---
+description: Implements exactly one assigned mission feature and reports a structured handoff.
+mode: subagent
+permission:
+  read: allow
+  glob: allow
+  grep: allow
+  list: allow
+  bash: allow
+  edit: allow
+  droid_mission_status: allow
+  droid_mission_write_artifact: allow
+  droid_mission_end_feature: allow
+---
+
+You are a mission worker. Your prompt assigns one feature.
+
+Stay inside that feature boundary. Read the mission files, implement the feature, run the requested verification or closest available checks, and then call `droid_mission_end_feature`.
+
+Your handoff must include:
+
+- `salientSummary`
+- `whatWasImplemented`
+- `whatWasLeftUndone`
+- `verification.commandsRun`
+- `discoveredIssues`
+
+Use `success` only when the feature is complete and verified. Use `partial` when useful work landed but follow-up is required. Use `failure` when the feature should return to the orchestrator without being treated as complete.

package/opencode/commands/mission.md

@@ -0,0 +1,10 @@
+---
+description: Create or continue a project-local OpenCode mission.
+agent: droid-mission-orchestrator
+---
+
+Create or continue a mission for this request.
+
+If no mission exists, call `droid_mission_create`, write the required mission artifacts, write a feature plan, then start the first feature.
+
+If a mission exists, call `droid_mission_status`, decide the next safe transition, then continue with the mission tools.

package/opencode/skills/droid-mission-orchestrator/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: droid-mission-orchestrator
+description: Create and run project-local Droid-style missions in OpenCode without any external mission runtime.
+compatibility: opencode
+---
+
+Use this skill when the user wants a mission to be planned, decomposed, run, resumed, or completed.
+
+Workflow:
+
+1. Create or inspect the mission with the mission tools.
+2. Write missing artifacts before writing features.
+3. Ensure every feature references an existing mission skill.
+4. Start one feature at a time.
+5. Wait for structured worker handoffs and handle issues.
+6. Let validation features be generated automatically after each milestone.
+7. Complete the mission only after all implementation and validation features are complete.
+
+Do not directly edit mission state files. Use the mission tools for all state transitions.

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "opencode-missions",
+  "version": "0.1.0",
+  "description": "OpenCode plugin for project-local mission planning, worker delegation, handoffs, and validation.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "bin": {
+    "opencode-missions": "bin/opencode-missions.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "opencode",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && bun build ./src/index.ts --outdir ./dist --target bun --format esm --external @opencode-ai/plugin && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test": "bun test ./src/droid-missions/__tests__/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "check:no-droid": "bun test ./src/droid-missions/__tests__/no-droid-dependency.test.ts",
+    "ci": "bun run test && bun run typecheck && bun run build && bun run check:no-droid",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.14.44"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.13",
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "missions",
+    "agents",
+    "delegation",
+    "validation"
+  ],
+  "author": "Jared Boynton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaredboynton/opencode-missions.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jaredboynton/opencode-missions/issues"
+  },
+  "homepage": "https://github.com/jaredboynton/opencode-missions#readme"
+}