agi-farm 1.0.0

package/skills/agi-farm/SKILL.md

@@ -0,0 +1,439 @@
+---
+name: agi-farm
+description: >
+  Interactive setup wizard that creates a fully working multi-agent AI team on OpenClaw.
+  One command bootstraps agents, SOUL.md personas, comms infrastructure (inboxes/outboxes/broadcast),
+  cron jobs, auto-dispatcher (HITL + rate-limit backoff + dependency checking), and a portable
+  GitHub bundle — all customized to team name, size (3/5/11 agents), domain, and frameworks
+  (autogen/crewai/langgraph). Includes a React + SSE live ops dashboard with file-watcher
+  (~350ms push latency) and persistent macOS LaunchAgent. Model-selection guidance built in.
+  Commands: setup | status | rebuild | export | dashboard | dispatch
+---
+
+# agi-farm
+
+Builds a complete multi-agent AI team on OpenClaw. One wizard, full team.
+
+> **Note:** AGI Farm is now an OpenClaw plugin. See the plugin documentation at
+> `~/.openclaw/extensions/agi-farm/README.md` for full details.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `/agi-farm setup` | Full wizard — agents, workspace, crons, bundle, GitHub |
+| `/agi-farm status` | Team health: agents, tasks, cron status |
+| `/agi-farm rebuild` | Regenerate workspace from existing bundle (preserves edits) |
+| `/agi-farm export` | Push bundle to GitHub |
+| `/agi-farm dashboard` | Launch live ops room — see [references/dashboard.md](references/dashboard.md) |
+| `/agi-farm dispatch` | Run auto-dispatcher — see [scripts/auto-dispatch.py](scripts/auto-dispatch.py) |
+
+---
+
+## `/agi-farm setup`
+
+Ask **one question at a time**. Do not proceed until confirmed.
+
+### Step 1 — Team name
+> "What should we call your team? (e.g. NovaCorp, TradingDesk — default: MyTeam)"
+
+Store as `TEAM_NAME`.
+
+### Step 2 — Orchestrator name
+> "What's your orchestrator's name? (default: Cooper)"
+
+Store as `ORCHESTRATOR_NAME`.
+
+### Step 3 — Team size
+> "How many agents?
+> **3** — Minimal: Orchestrator + Researcher + Builder
+> **5** — Standard: adds QA + Content
+> **11** — Full stack: complete AGI system (recommended)"
+
+Store as `PRESET`.
+
+### Step 3.5 — Domain
+> "What domain? software / trading / research / general (default) / custom"
+
+If custom: ask for one-phrase description. Store as `DOMAIN`.
+
+### Step 3.6 — Custom agents _(PRESET 3 or 5 only)_
+> "Add a custom agent? (yes/no, default: no)"
+
+If yes, collect per agent: `id`, `name`, `emoji`, `role`, `goal`. Max 3 custom agents.
+Append to roster in Step 7 with `"template": "generic"`.
+
+### Step 4 — Frameworks
+> "Collaboration frameworks? autogen / crewai / langgraph / all / none"
+
+Store as `FRAMEWORKS` list. `all` → `["autogen", "crewai", "langgraph"]`.
+
+### Step 5 — GitHub
+> "Create a GitHub repo for the bundle? yes / no"
+
+Store as `CREATE_GITHUB`.
+
+### Step 6 — Confirm
+Show summary, ask "Shall I proceed? (yes/no)". If no → restart Step 1.
+
+---
+
+### Step 7 — Write `team.json`
+
+```bash
+mkdir -p ~/.openclaw/workspace/agi-farm-bundle/
+openclaw agents list --json   # use output to assign appropriate models per role
+```
+
+Use the `openclaw agents list` output to assign each agent a model appropriate for
+its role. Write resolved model strings directly into the `"model"` fields.
+
+**Model selection cheat sheet** (based on `openclaw agents list --json` output):
+
+| Role | Recommended tier | Why |
+|------|-----------------|-----|
+| Orchestrator | High-capability (e.g. `sonnet`, `opus`) | Needs broad reasoning, delegation judgment |
+| Solution Architect / Researcher | High-capability | Deep analysis + design |
+| Implementation Engineer | Mid-tier (e.g. `glm-5`, `sonnet`) | Fast code gen; cost-efficiency matters |
+| Debugger | High-capability (e.g. `opus`) | Root-cause analysis benefits from deep reasoning |
+| Business Analyst / Knowledge | Mid-high (e.g. `gemini-2.0-pro-exp`) | Long-context research tasks |
+| QA Engineer | Fast/cheap (e.g. `glm-4.7-flash`) | High volume, pattern-matching checks |
+| Content / Multimodal | Multimodal-capable (e.g. `gemini-2.0-pro-exp`) | Vision + rich generation |
+| R&D / Process Improvement | High-capability | Creative + structured experimentation |
+
+> Tip: assign `opus` or `sonnet` to roles that make decisions; use `flash`/`glm-4.7-flash` for high-frequency reviewers to manage cost.
+
+**3-agent roster:**
+```json
+{"team_name":"<TEAM_NAME>","orchestrator_name":"<ORCHESTRATOR_NAME>","preset":"3",
+ "domain":"<DOMAIN>","frameworks":<FRAMEWORKS_JSON>,"created_at":"<ISO_TIMESTAMP>",
+ "agents":[
+   {"id":"main",       "name":"<ORCHESTRATOR_NAME>","emoji":"🦅","role":"Orchestrator",           "goal":"Orchestrate the team, delegate tasks, synthesize results",             "model":"<MODEL>","workspace":"."},
+   {"id":"researcher", "name":"Sage",               "emoji":"🔮","role":"Researcher",             "goal":"Research deeply and surface the insights that matter most",            "model":"<MODEL>","workspace":"researcher"},
+   {"id":"builder",    "name":"Forge",              "emoji":"⚒️","role":"Builder",                "goal":"Implement solutions cleanly and efficiently",                          "model":"<MODEL>","workspace":"builder"}
+ ]}
+```
+
+**5-agent:** add to 3-agent roster:
+```json
+{"id":"qa",     "name":"Vigil", "emoji":"🛡️","role":"QA Engineer",       "goal":"Ensure every output meets quality standards","model":"<MODEL>","workspace":"qa"},
+{"id":"content","name":"Anchor","emoji":"⚓", "role":"Content Specialist","goal":"Craft clear content that communicates complex ideas simply","model":"<MODEL>","workspace":"content"}
+```
+
+**11-agent roster:**
+```json
+[
+  {"id":"main",  "name":"<ORCHESTRATOR_NAME>","emoji":"🦅","role":"Orchestrator",            "goal":"Orchestrate specialists, delegate tasks, synthesize results",                          "model":"<MODEL>","workspace":"."},
+  {"id":"sage",  "name":"Sage",              "emoji":"🔮","role":"Solution Architect",       "goal":"Design robust, scalable architectures",                                               "model":"<MODEL>","workspace":"solution-architect"},
+  {"id":"forge", "name":"Forge",             "emoji":"⚒️","role":"Implementation Engineer", "goal":"Implement clean, well-tested code efficiently",                                        "model":"<MODEL>","workspace":"implementation-engineer"},
+  {"id":"pixel", "name":"Pixel",             "emoji":"🐛","role":"Debugger",                "goal":"Find the true root cause of any bug or failure",                                       "model":"<MODEL>","workspace":"debugger"},
+  {"id":"vista", "name":"Vista",             "emoji":"🔭","role":"Business Analyst",        "goal":"Research deeply and surface the insights that matter most",                            "model":"<MODEL>","workspace":"business-analyst"},
+  {"id":"cipher","name":"Cipher",            "emoji":"🔊","role":"Knowledge Curator",       "goal":"Curate and surface knowledge so the team never forgets",                              "model":"<MODEL>","workspace":"knowledge-curator"},
+  {"id":"vigil", "name":"Vigil",             "emoji":"🛡️","role":"QA Engineer",             "goal":"Ensure every output meets quality standards",                                         "model":"<MODEL>","workspace":"quality-assurance"},
+  {"id":"anchor","name":"Anchor",            "emoji":"⚓", "role":"Content Specialist",     "goal":"Craft clear content that communicates complex ideas simply",                           "model":"<MODEL>","workspace":"content-specialist"},
+  {"id":"lens",  "name":"Lens",              "emoji":"📡","role":"Multimodal Specialist",   "goal":"Extract meaning from images, documents, and multimodal inputs",                       "model":"<MODEL>","workspace":"multimodal-specialist"},
+  {"id":"evolve","name":"Evolve",            "emoji":"🔄","role":"Process Improvement Lead","goal":"Make the team better systematically through continuous improvement",                   "model":"<MODEL>","workspace":"process-improvement"},
+  {"id":"nova",  "name":"Nova",              "emoji":"🧪","role":"R&D Lead",                "goal":"Turn hypotheses into proven capabilities through structured experimentation",          "model":"<MODEL>","workspace":"r-and-d"}
+]
+```
+
+---
+
+### Step 8 — Generate workspace files
+
+```bash
+python3 ~/.openclaw/skills/agi-farm/generate.py \
+  --team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
+  --output ~/.openclaw/workspace/ \
+  --all-agents --shared --bundle
+```
+
+---
+
+### Step 9 — Create OpenClaw agents
+
+For each agent **except `main`** (skip if already exists):
+
+```bash
+openclaw agents add \
+  --agent <id> --name "<name>" --emoji "<emoji>" \
+  --model "<model>" \
+  --workspace "~/.openclaw/workspace/agents-workspaces/<workspace>"
+```
+
+Use `agent["model"]` from team.json directly.
+
+---
+
+### Step 10 — Register cron jobs
+
+```bash
+python3 ~/.openclaw/skills/agi-farm/scripts/register-crons.py \
+  --team-json ~/.openclaw/workspace/agi-farm-bundle/team.json
+```
+
+Timezone is read automatically from OpenClaw config. Skips any cron that already exists.
+
+---
+
+### Step 11 — Install frameworks
+
+For each framework in `FRAMEWORKS`:
+
+```bash
+if [ ! -d ~/.openclaw/skills/<fw>-collab ]; then
+  TMP=$(mktemp -d)
+  git clone --depth 1 --filter=blob:none --sparse \
+    https://github.com/oabdelmaksoud/openclaw-skills.git "$TMP"
+  cd "$TMP" && git sparse-checkout set <fw>-collab
+  cp -r <fw>-collab ~/.openclaw/skills/ && rm -rf "$TMP"
+fi
+python3 ~/.openclaw/skills/<fw>-collab/build_agents.py --force 2>/dev/null || true
+```
+
+---
+
+### Step 12 — GitHub (if chosen)
+
+```bash
+cd ~/.openclaw/workspace/agi-farm-bundle
+git init -b main && git add . && git commit -m "feat: <TEAM_NAME> AGI farm"
+gh repo create agi-farm-<TEAM_NAME_LOWER> --public --source . --remote origin --push
+```
+
+---
+
+### Step 13 — Commit workspace
+
+```bash
+cd ~/.openclaw/workspace
+git add -A && git commit -m "feat: <TEAM_NAME> AGI team — agi-farm setup complete"
+```
+
+---
+
+### Step 14 — Initialize registries + health check
+
+```bash
+# Write TASKS.json and AGENT_STATUS.json
+python3 - << 'EOF'
+import json
+from pathlib import Path
+ws   = Path.home() / ".openclaw/workspace"
+team = json.loads((ws / "agi-farm-bundle/team.json").read_text())
+(ws / "TASKS.json").write_text("[]")
+(ws / "AGENT_STATUS.json").write_text(json.dumps(
+    {a["id"]: {"status": "available", "name": a["name"]} for a in team["agents"]}, indent=2))
+print("✅ registries written")
+EOF
+
+# Health check
+AGENTS=$(openclaw agents list --json 2>/dev/null | python3 -c "import json,sys; print(len(json.load(sys.stdin)))" || echo 0)
+CRONS=$(openclaw cron list 2>/dev/null | grep -c "<TEAM_NAME_LOWER>" || echo 0)
+[ -d ~/.openclaw/workspace/comms/inboxes ] && echo "✅ comms OK" || echo "❌ comms missing"
+[ -f ~/.openclaw/workspace/TASKS.json ]    && echo "✅ TASKS.json OK" || echo "❌ TASKS.json missing"
+echo "✅ Agents: $AGENTS | Crons: $CRONS"
+```
+
+---
+
+### Step 15 — Done
+
+```
+✅ <TEAM_NAME> AGI team is live!
+Agents   : <PRESET> (<AGENT_NAMES_LIST>)
+Workspace: ~/.openclaw/workspace/
+Bundle   : ~/.openclaw/workspace/agi-farm-bundle/
+GitHub   : <URL if created>
+
+Next: talk to <ORCHESTRATOR_NAME> · /agi-farm status · /agi-farm dashboard
+```
+
+---
+
+## `/agi-farm status`
+
+```bash
+openclaw agents list --json | python3 -c "
+import json,sys
+for a in json.load(sys.stdin):
+    print(f'  {a.get(\"identityEmoji\",\"🤖\")} {a.get(\"identityName\",a[\"id\"])}: {a.get(\"model\",\"?\")}')
+"
+python3 -c "
+import json
+from pathlib import Path
+ws = Path.home() / '.openclaw/workspace'
+tasks = json.loads((ws/'TASKS.json').read_text()) if (ws/'TASKS.json').exists() else []
+t = [t for t in tasks if isinstance(t,dict)]
+print(f'  Tasks: {len(t)} total · {sum(1 for x in t if x.get(\"status\")==\"pending\")} pending · {sum(1 for x in t if x.get(\"status\")==\"needs_human_decision\")} HITL')
+"
+openclaw cron list 2>/dev/null | head -15
+```
+
+---
+
+## `/agi-farm rebuild`
+
+```bash
+python3 ~/.openclaw/skills/agi-farm/generate.py \
+  --team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
+  --output ~/.openclaw/workspace/ \
+  --all-agents --shared --no-overwrite
+```
+
+`--no-overwrite` skips files that already exist, preserving manual edits.
+Add `--force` (remove `--no-overwrite`) to overwrite everything.
+
+---
+
+## `/agi-farm export`
+
+```bash
+cd ~/.openclaw/workspace/agi-farm-bundle
+git add -A
+git commit -m "export: $(date +%Y-%m-%d)" 2>/dev/null || echo "Nothing to commit"
+git push 2>/dev/null || echo "No remote — run /agi-farm setup first"
+```
+
+---
+
+## `/agi-farm dashboard`
+
+**React + SSE ops room.** File-watcher pushes live data to the browser in ~350ms on any workspace `.json` or `.md` change. Runs as a persistent macOS LaunchAgent — always on, auto-restarts on crash.
+
+### Architecture
+
+```
+dashboard.py          ← Python HTTP server (SSE + static)
+  ├── WorkspaceWatcher  watchdog file-watcher, 250ms debounce
+  ├── SlowDataCache     background thread — caches `openclaw agents list`
+  │                     and `openclaw cron list` every 30s (each takes ~1-2s)
+  ├── Broadcaster       thread-safe SSE fan-out to all connected clients
+  └── /api/stream       SSE endpoint — pushes full snapshot on every file change
+
+dashboard-react/      ← Vite + React 18 + Recharts frontend
+  dist/               ← production build (served by dashboard.py)
+  src/
+    hooks/useDashboard.js   SSE hook — auto-reconnects on disconnect
+    components/
+      Header.jsx            live badge, stats, clock
+      Nav.jsx               tab switcher
+      tabs/
+        Overview.jsx        stats, budget bar, SLA alerts, agent grid, broadcast preview
+        Agents.jsx          full agent cards — model, inbox, quality, credibility, cache age
+        Tasks.jsx           filterable table, expandable rows, ticking deadlines, pagination
+        Velocity.jsx        7-day charts (Recharts), quality trend, task-type donut
+        Budget.jsx          period bars, threshold markers, per-agent/model breakdown
+        OKRs.jsx            objectives + KRs with progress bars
+        RD.jsx              experiments, backlog, benchmarks
+        Broadcast.jsx       terminal log, color-coded CRITICAL/BLOCKED/HITL
+```
+
+### Data sources (all real-time from workspace files)
+
+| Field | Source file | Refresh |
+|-------|-------------|---------|
+| tasks, task_counts, sla_at_risk | `TASKS.json` | instant |
+| agents (inbox, perf, status) | `AGENT_STATUS.json`, `AGENT_PERFORMANCE.json`, `comms/inboxes/` | instant |
+| agent model, cron error/busy | `openclaw agents/cron list` | 30s cache |
+| budget | `BUDGET.json` | instant |
+| velocity | `VELOCITY.json` | instant |
+| okrs | `OKRs.json` | instant |
+| broadcast | `comms/broadcast.md` | instant |
+| experiments / backlog | `EXPERIMENTS.json`, `IMPROVEMENT_BACKLOG.json` | instant |
+| knowledge_count | `SHARED_KNOWLEDGE.json` | instant |
+| memory_lines | `MEMORY.md` | instant |
+
+### LaunchAgent (always-on)
+
+The dashboard is registered as `ai.coopercorp.dashboard` and starts automatically at login.
+
+```bash
+# Status
+launchctl list | grep coopercorp
+curl -s http://localhost:8080/api/data | python3 -m json.tool | head -5
+
+# Restart
+launchctl stop  ai.coopercorp.dashboard
+launchctl start ai.coopercorp.dashboard
+
+# Logs
+tail -f /tmp/coopercorp-dashboard.log
+tail -f /tmp/coopercorp-dashboard.err
+
+# Disable / re-enable
+launchctl unload ~/Library/LaunchAgents/ai.coopercorp.dashboard.plist
+launchctl load   ~/Library/LaunchAgents/ai.coopercorp.dashboard.plist
+```
+
+**URL**: http://localhost:8080
+
+### Rebuild React frontend
+
+```bash
+cd ~/.openclaw/skills/agi-farm/dashboard-react
+npm install        # first time only
+npm run build      # outputs to dist/ — dashboard.py serves automatically
+```
+
+Full reference: [references/dashboard.md](references/dashboard.md)
+
+---
+
+## `/agi-farm dispatch`
+
+```bash
+# Dry-run (preview only)
+python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py
+
+# Execute
+python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py --execute
+```
+
+Fires agent sessions for pending tasks, handles HITL notifications, stale task
+resets, rate-limit backoff, and dependency checking. Cron (every 1 min):
+```bash
+* * * * * python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py --execute \
+            >> ~/.openclaw/workspace/logs/auto-dispatch.log 2>&1
+```
+
+---
+
+## Troubleshooting
+
+### Setup issues
+
+| Symptom | Fix |
+|---------|-----|
+| `generate.py` fails with `ModuleNotFoundError` | Run `pip3 install jinja2` |
+| `openclaw agents add` says agent already exists | Safe to ignore — skip that agent |
+| `gh repo create` fails | Run `gh auth login` first |
+| Cron registration shows 0 crons added | Run `openclaw cron list` to check for duplicates; use `--force` flag on re-register |
+| `git commit` fails in Step 13 | Run `git config --global user.email` and set name/email first |
+
+### Runtime issues
+
+| Symptom | Fix |
+|---------|-----|
+| Auto-dispatcher fires but agents don't respond | Check `logs/auto-dispatch.log`; verify `openclaw agents list` shows agents |
+| Dashboard shows stale data | Restart LaunchAgent: `launchctl stop ai.coopercorp.dashboard && launchctl start ai.coopercorp.dashboard` |
+| TASKS.json parse error | Validate JSON: `python3 -m json.tool ~/.openclaw/workspace/TASKS.json` |
+| Agent stuck >30 min | Check broadcast.md for `[BLOCKED]` tags; reassign task manually |
+| Rate-limit backoff too aggressive | Edit `RATE_LIMIT_BACKOFF_MIN` in `scripts/auto-dispatch.py` (default: 10 min) |
+| `openclaw` not found in cron | Set `OPENCLAW_BIN=/path/to/openclaw` in the cron environment, or add `PATH=/opt/homebrew/bin:$PATH` |
+
+### Recovery
+
+```bash
+# Re-run setup without overwriting existing files
+python3 ~/.openclaw/skills/agi-farm/generate.py \
+  --team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
+  --output ~/.openclaw/workspace/ \
+  --all-agents --shared --no-overwrite
+
+# Force full regeneration (overwrites everything)
+python3 ~/.openclaw/skills/agi-farm/generate.py \
+  --team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
+  --output ~/.openclaw/workspace/ \
+  --all-agents --shared --bundle --force
+```

package/templates/AGENTS.md.template

@@ -0,0 +1,37 @@
+<!-- Template: AGENTS.md.template -->
+<!-- Purpose:  Team roster — lists all agents, roles, comms paths, and session startup checklist -->
+<!-- Variables: team_name, orchestrator_name, agents[] -->
+<!-- Rendered by: generate.py -->
+# AGENTS.md — {{TEAM_NAME}} Team
+
+This workspace belongs to **{{AGENT_NAME}} {{AGENT_EMOJI}}** ({{AGENT_ROLE}}).
+
+## Your Team
+
+| ID | Name | Emoji | Model | Role |
+|----|------|-------|-------|------|
+{{AGENTS_TABLE}}
+
+## Communication
+
+- **Your inbox**: `comms/inboxes/{{AGENT_ID}}.md`
+- **Your outbox**: `comms/outboxes/{{AGENT_ID}}.md`
+- **Broadcast**: `comms/broadcast.md`
+- **Orchestrator**: {{ORCHESTRATOR_NAME}} (main)
+
+## Every Session
+
+1. Read `SOUL.md` — who you are and how to operate
+2. Check `comms/inboxes/{{AGENT_ID}}.md` for pending tasks
+3. Check `comms/broadcast.md` for team-wide alerts
+4. Complete tasks, write results to outbox
+5. Mark done tasks `[DONE]` in your inbox
+
+## Escalation
+
+- Stuck or uncertain → write to {{ORCHESTRATOR_NAME}} inbox
+- Blocked → write to broadcast.md with `[BLOCKED]` tag
+- Critical issue → write to broadcast.md with `[CRITICAL]` tag
+
+---
+_{{TEAM_NAME}} AGI Team | agi-farm | {{DATE}}_

package/templates/BOOTSTRAP.md.template

@@ -0,0 +1,39 @@
+<!-- Template: BOOTSTRAP.md.template -->
+<!-- Purpose:  Session bootstrap checklist read at the start of every agent session -->
+<!-- Variables: team_name, orchestrator_name, agent_name, agent_goal -->
+<!-- Rendered by: generate.py -->
+# BOOTSTRAP.md — {{AGENT_NAME}} Session Bootstrap
+
+_Read this at the start of every session._
+
+## Who You Are
+
+You are **{{AGENT_NAME}} {{AGENT_EMOJI}}**, the {{AGENT_ROLE}} for the {{TEAM_NAME}} AGI team.
+
+**Your goal**: {{AGENT_GOAL}}
+
+**Your model**: {{AGENT_MODEL}}
+
+## Session Startup Checklist
+
+- [ ] Read `SOUL.md` — your persona and operating instructions
+- [ ] Read `AGENTS.md` — your team roster
+- [ ] Check `comms/inboxes/{{AGENT_ID}}.md` — pending tasks
+- [ ] Check `comms/broadcast.md` — team alerts
+
+## Task Execution
+
+1. Pick the highest-priority pending task from your inbox
+2. Execute it according to your SOUL.md guidelines
+3. Write results to `comms/outboxes/{{AGENT_ID}}.md`
+4. Mark task `[DONE]` in your inbox
+5. If blocked: write to broadcast.md with `[BLOCKED]`
+
+## Escalation
+
+- Uncertainty or low confidence → escalate to {{ORCHESTRATOR_NAME}}
+- Architectural decisions → loop in orchestrator
+- Irreversible actions → HITL required
+
+---
+_{{TEAM_NAME}} AGI Team | agi-farm | {{DATE}}_

package/templates/CLAUDE.md.template

@@ -0,0 +1,119 @@
+<!-- Template: CLAUDE.md.template -->
+<!-- Purpose:  Team-wide operating manual injected into every agent's CLAUDE.md -->
+<!-- Variables: team_name, orchestrator_name, frameworks -->
+<!-- Rendered by: generate.py -->
+# CLAUDE.md — {{TEAM_NAME}} Team Operating Manual
+
+_Read by ALL agents. These are the shared rules of the {{TEAM_NAME}} system._
+
+---
+
+## 1. Team Roster
+
+| ID | Name | Emoji | Model | Role |
+|----|------|-------|-------|------|
+{{AGENTS_TABLE}}
+
+---
+
+## 2. Communication Protocol
+
+### Inboxes (receive tasks here)
+`~/.openclaw/workspace/comms/inboxes/<agent-id>.md`
+
+### Outboxes (write results here)
+`~/.openclaw/workspace/comms/outboxes/<agent-id>.md`
+
+### Broadcast (team-wide alerts)
+`~/.openclaw/workspace/comms/broadcast.md`
+
+**Rules:**
+- Inboxes are append-only. Mark completed tasks `[DONE]`.
+- {{ORCHESTRATOR_NAME}} reads all outboxes on synthesis cycles.
+- All agents check broadcast.md on every heartbeat.
+- Only write to broadcast for: critical alerts, learning sessions, process updates.
+
+### Task Message Format ({{ORCHESTRATOR_NAME}} → Agent)
+```markdown
+---
+TASK_ID: <uuid>
+FROM: main
+TO: <agent-id>
+TYPE: implementation|research|debug|review|content|analysis
+PRIORITY: immediate|normal|background
+ASSIGNED_AT: <ISO timestamp>
+---
+
+## Context
+## Task
+## Expected Output
+## Constraints
+## Escalation
+```
+
+---
+
+## 3. Quality Gate
+
+Every output goes through quality review before delivery.
+
+| Score | Meaning | Action |
+|-------|---------|--------|
+| 5 | Exceptional | Deliver |
+| 4 | Good | Deliver |
+| 3 | Acceptable | Deliver with notes |
+| 2 | Needs work | Block, revise |
+| 1 | Unacceptable | Block, reassign |
+
+Score ≤2 blocks delivery and triggers retrospective.
+
+---
+
+## 4. Task State Machine
+
+```
+pending → in-progress → complete
+                      → failed → retry → complete
+                                       → escalate
+```
+
+All state transitions must be logged in TASKS.json.
+
+---
+
+## 5. Escalation Chain
+
+| Trigger | Action |
+|---------|--------|
+| Same task fails 2× | Reassign to different specialist |
+| Quality score ≤2 | Block, revise, trigger retrospective |
+| Confidence <70% | HITL — escalate to user |
+| Irreversible action | HITL — user must approve |
+| Agent stuck >30min | Ping agent, log incident |
+| Task stuck >1h | Escalate to {{ORCHESTRATOR_NAME}} |
+
+---
+
+## 6. Constitutional Rules (INVIOLABLE)
+
+1. Never fabricate — if unsure, say so and escalate
+2. Never skip quality gate
+3. {{ORCHESTRATOR_NAME}} never does specialist work — always delegates
+4. Never mark a task complete without actual output
+5. Always update AGENT_STATUS.json on session start/end
+6. MAX_GENERATION_DEPTH: 3
+7. HITL before irreversible actions
+8. **On task completion: update TASKS.json — set `status: complete` and `completed_at: <ISO>` for your task ID**
+
+---
+
+## 7. Memory System
+
+- `MEMORY.md` — curated long-term memory (≤200 lines)
+- `memory/YYYY-MM-DD.md` — daily session logs
+- `TASKS.json` — task history and state
+- `AGENT_STATUS.json` — agent availability
+
+---
+
+_Built with agi-farm on {{DATE}} | Team: {{TEAM_NAME}} | Preset: {{PRESET}} agents | Frameworks: {{FRAMEWORKS}}_

package/templates/DASHBOARD.md.template

@@ -0,0 +1,31 @@
+<!-- Template: DASHBOARD.md.template -->
+<!-- Purpose:  Live ops dashboard reference — architecture, data sources, LaunchAgent instructions -->
+<!-- Variables: team_name -->
+<!-- Rendered by: generate.py -->
+# DASHBOARD.md — {{TEAM_NAME}} Team Health
+_Updated by Vigil on every heartbeat. Last updated: {{DATE}}_
+
+## Agent Status
+| Agent | Status | Last Active | Current Task |
+|-------|--------|-------------|-------------|
+{{AGENTS_DASHBOARD_TABLE}}
+
+## Task Queue
+- **Pending**: 0
+- **In Progress**: 0
+- **Completed today**: 0
+- **Failed today**: 0
+
+## Quality Scores (last 10 outputs)
+- Average: N/A
+- Below standard (≤2): 0
+- Blocked: 0
+
+## System Health
+- Cron jobs: ✅ Running
+- Comms: ✅ Active
+- Memory: ✅ Under 200 lines
+- Frameworks: {{FRAMEWORKS}}
+
+---
+_{{TEAM_NAME}} AGI Team | Vigil 🛡️ | agi-farm | {{DATE}}_

package/templates/DECISIONS.md.template

@@ -0,0 +1,16 @@
+<!-- Template: DECISIONS.md.template -->
+<!-- Purpose:  Architectural decision log — records key decisions and their rationale -->
+<!-- Variables: team_name -->
+<!-- Rendered by: generate.py -->
+# DECISIONS.md — {{TEAM_NAME}} Architecture Decision Records
+_Maintained by Sage and Cipher. Every significant decision documented._
+
+## ADR Format
+Each ADR includes: Context → Decision → Consequences → Status
+
+---
+
+_No decisions yet. First ADRs will be added as the team makes architectural choices._
+
+---
+_{{TEAM_NAME}} AGI Team | agi-farm | {{DATE}}_