Kelly Research — OCR Transcripts¶
Summary: Recovered from daily memory files (2026-02-24), these are OCR transcripts of Kelly tweet screenshots that were lost in an April 2 bootstrap. They capture four key architectural documents: factory rules (4 images), iOS factory pipeline (10 steps), design station, and the full multi-agent pipeline design (23 screenshots). Together they form the most complete architectural view of Kelly's operating system.
Key Concepts¶
- Factory Rules (Tweet ID: 2021025015395926352): 10 rules governing all Kelly instances. Key architecture: Kelly Router (main agent, no new registration), 5 Named Agents (Research Lead, Project Lead, Test Lead + 2 more), RALPH retry protocol (3 attempts, pass diagnostics, escalate on same error twice).
- CIS agents: Carson (brainstorm), Victor (innovation), Maya (design), Dr. Quinn (problem-solving). Used for research phase.
- BMM agents: Mary (analyst), John (PM), Sally (UX), Winston (arch), Bob (SM), Amelia (dev), Quinn (QA), Barry (quick-dev). Used for build phase.
- TEA agent: Murat for testing audit.
- BMAD library: Preserved at
/clawd/bmad/— NOT loaded into context, referenced by path. - sessions_send: For inter-agent communication. Project files in
/clawd/projects/{project-id}/. USER.md symlinked across workspaces. - iOS Factory 10-step: 0-CHECK → 1-DISCOVER → 2-VALIDATE (28/40) → 3-DESIGN (77/110) → 4-BUILD → 5-POLISH (70%) → 6-LAUNCH → 7-SUBMIT → 8-MARKET → 9-TRACK → 10-LEARN. Each step has a script.
- Design Station scripts:
design-station.sh,find-references.sh,generate-variations.sh,apply-design.sh,reskin-app.sh. Clones from Mobbin references via Gemini. - Multi-agent pipeline design (Tweet ID: 2025383693326401904): 23 screenshots. 5 phases: Discovery → Design → Code → Assets → Submit. Each phase has entry/exit gates. pipeline state tracks everything.
- Agent startup checklist: Read state → Verify prereqs → Do work → Run gate → Update state → Announce.
- 3 orchestrator options: Manual, Chained, Orchestrator Agent (recommended).
- Failure handling: Gate fails = stop, Timeout = resume, Build errors = checkpoint, ASC rejection = human decision.
- Retry protocol: lastCheckpoint for resume after failures.
Notable Patterns¶
The Kelly Router as registered infrastructure, not new code: "Kelly Router = main agent (no new registration)" — meaning the router pattern is built into OpenClaw, not custom code per instance. This makes spawning new Kelly instances a configuration change, not a development effort.
pipeline state as single source of truth: Everything — status, timestamps, gate scores, checkpoints — tracked in one file. Enables resume-from-failure, observability, and operator transparency simultaneously.
BMM as build phase agent names: The naming (Mary, John, Sally, Winston, Bob, Amelia, Quinn, Barry) suggests named, role-specific agents with clear responsibilities — analyst, PM, UX, architect, scrum master, developer, QA, quick-dev.
Design Station's reference-based approach: Not generative design from scratch — clone proven Mobbin UI patterns + apply custom style. Reduces design risk by starting from validated patterns.
Factory rules as operational DNA: The 4-image factory rules tweet was explicitly described as "the first set of generalized rules that should be followed by all instances of Kelly." It encodes the week's hard-won learnings as operational constraints for future instances.
Related¶
factory-rules, ralph-protocol, cis-agents, bmm-agents, tea-agent, ios-factory-pipeline, design-station, pipeline-state, kelly-router, multi-agent-pipeline, bmad-library