Grand Diomande Research · Full HTML Reader

App Evolution Protocol — Standardized Dispatch Pipeline

| Level | Requirements | Dispatch? | |-------|-------------|-----------| | L0 | Git repo exists | No | | L1 | CLAUDE.md (50+ lines) | No | | L2 | EVOLUTION.md (15+ tasks) | Manual only | | L3 | GitHub webhook wired to swarm | Auto-dispatch | | L4 | CI/CD pipeline (TestFlight) | Full automation |

Agents That Account for Themselves research note experiment writeup candidate score 24 .md

Full Public Reader

App Evolution Protocol — Standardized Dispatch Pipeline

Every app in the portfolio follows this protocol to become dispatch-ready for Agent Swarm.

Readiness Levels

Level	Requirements	Dispatch?
L0	Git repo exists	No
L1	CLAUDE.md (50+ lines)	No
L2	EVOLUTION.md (15+ tasks)	Manual only
L3	GitHub webhook wired to swarm	Auto-dispatch
L4	CI/CD pipeline (TestFlight)	Full automation

Per-App File Structure

AppName/
  CLAUDE.md          — Architecture, models, services, views, integrations, gotchas
  EVOLUTION.md       — Prioritized task queue (Critical/High/Medium/Low)
  ExportOptions.plist — Build pipeline config
  project.yml        — XcodeGen spec (if used)

EVOLUTION.md Format

markdown

# Evolution Queue — AppName
> Last audited: YYYY-MM-DD | Tasks: N | Dispatched: M

## Critical (blocks user experience)
- [ ] [SWARM] Fix crash on launch when CloudKit unavailable
  - File: Services/CloudKitManager.swift:45
  - Issue: No error handling for CKError.networkUnavailable
  - Test: Launch in airplane mode, verify graceful degradation

## High (improves core functionality)
- [ ] [SWARM] Add pull-to-refresh on main list view
  - File: Views/MainView.swift
  - Issue: No refresh mechanism, data goes stale
  - Test: Pull down, verify data reloads

## Medium (polish and refinement)
- [ ] [SWARM] Add VoiceOver labels to all interactive elements
  ...

## Low (nice-to-have)
- [ ] [SWARM] Add haptic feedback on button taps
  ...

Tasks prefixed with `[SWARM]` are dispatchable to Agent Swarm.

GitHub Issue Auto-Creation

To make a task dispatchable, create a GitHub issue:

Title: {task title}
Labels: swarm, {priority}
Body: {task description with file paths}

The swarm daemon picks up `issues.opened` events with `swarm` label and auto-dispatches.

Continuous Evolution Loop

1. Agent audits app codebase → generates EVOLUTION.md
2. Tasks from EVOLUTION.md → GitHub issues (labeled "swarm")
3. Agent Swarm picks up issues → dispatches Claude session
4. Claude implements task → commits to branch
5. PR created → reviewed → merged
6. EVOLUTION.md updated (task checked off)
7. Next audit cycle generates new tasks

Priority Ordering (Portfolio)

Tier 1 (revenue + users): Spore, SpeakFlow, CreativeDirector
Tier 2 (platform): OpenClawHub, SecuriClaw, Aura
Tier 3 (ecosystem): agent-swarm, agent-intelligence, creator-shield
Tier 4 (Trajectory Bloom): 14 Wave 3 apps
Tier 5 (experimental): remaining apps

Promotion Decision

Attach run IDs, datasets, metrics, and reproduction commands.

Source Anchor

projects/agent-swarm/APP-EVOLUTION-PROTOCOL.md

Detected Structure

Method · Evaluation · Code Anchors · Architecture