docs: add agent operating memory (AGENTS.md, docs/agent/*, swarm commands) (#70)

Author: mahyarmlk

.opencode/README.md

@@ -15,6 +15,8 @@ All commands use the `opencode/big-pickle` model.
 |---------|-------------|
 | `/work <task>` | General implementation workflow. Creates a branch, implements, validates, PRs, observes CI, merges when green. |
 | `/docs <task>` | Documentation-only changes. No runtime/API changes, no version bumps, exact current APIs only. |
+| `/dispatch <plan>` | Turn a user-provided swarm plan into GitHub issues and `/oc` worker comments. Does not implement work. |
+| `/swarm-status` | Read-only report on active swarm issues, PRs, worker status, CI, conflicts, and merge order. |
 | `/review-pr <number>` | Read-only PR review. Checks correctness, scope, API fit, docs, changesets, packaging. Does not merge. |
 | `/observe-pr <number>` | Watch PR CI, merge when green. Skips risky changes without explicit approval. |
 | `/fix-ci <number>` | Diagnose and fix a failing CI run on a PR. Pushes minimal fix, re-observes CI, merges when safe. |

.opencode/commands/dispatch.md

@@ -0,0 +1,33 @@
+---
+model: opencode/big-pickle
+description: Dispatch a user-provided swarm plan as GitHub issues and /oc worker comments. Does not implement work itself.
+---
+
+You are working on the Intent repository at `intent-framework/intent`.
+
+## Task
+
+Turn a user-provided swarm plan into GitHub issues and `/oc` worker comments.
+
+## Workflow
+
+1. Read `docs/agent/SWARM.md` to understand lane rules, allowed/forbidden files, and conflict rules.
+2. Read `docs/agent/RELEASE-STATE.md` to understand release serialization.
+3. Parse the user's plan into independent work items.
+4. For each item, identify the lane and file family.
+5. **Check for overlapping file families** across all items. If any overlap exists:
+   - Warn the user about the conflict
+   - Suggest sequencing instead of parallelizing
+   - Do not create issues until the conflict is resolved
+6. For each non-conflicting item:
+   - Create a GitHub issue with a clear title, lane tag, and task description
+   - Post a comment on the issue with `/oc <task description>` to trigger the worker
+7. Report the list of created issues, their lanes, and the worker commands posted.
+
+## Safety
+
+- Do not invent unrelated tasks
+- Do not implement work yourself
+- Do not create issues for overlapping scopes
+- Do not dispatch release/version work as parallel swarm tasks
+- Stop after creating issues and posting worker comments. Do not merge, publish, or approve anything.

.opencode/commands/swarm-status.md

@@ -0,0 +1,41 @@
+---
+model: opencode/big-pickle
+description: Read-only report on active swarm issues, PRs, worker status, CI, conflicts, and recommended merge order. Does not edit, approve, merge, publish, or post comments.
+---
+
+You are working on the Intent repository at `intent-framework/intent`.
+
+## Task
+
+Report on active swarm issues and PRs.
+
+## Instructions
+
+For each active PR related to swarm work, inspect and report:
+
+- PR number and title
+- Worker status (open, draft, ready for review)
+- CI status (passing, failing, in progress)
+- Files changed and their file families
+- Likely conflicts with other open PRs (same file family)
+- Blockers (failing CI, merge conflicts, pending review)
+
+For all active swarm issues, report:
+
+- Issue number and title
+- Lane
+- Whether a worker has been triggered
+- PR link (if one exists)
+
+Finally, provide a **recommended merge order** based on:
+
+1. No overlapping file families (conflicting PRs must not merge simultaneously)
+2. Docs/tooling first (lowest risk)
+3. Runtime/API last (requires user review)
+4. Merge one PR at a time
+
+## Safety
+
+- Read-only. Do not edit, approve, merge, publish, or post any comments.
+- If a PR is risky (runtime/API/release), flag it and note that explicit user approval is required.
+- Do not suggest expanding scope or creating new issues.