Phase 1: Architecture — .vibee specs + agent interfaces + parallel execution design

[gHashTag]

Phase 1: Architecture (Parallel)

Parent: #27

Tasks

• Create base .vibee specs for each TRI command (decompose, plan, spec, gen, test, bench, verdict, git, loop)
• Define interfaces between agents
• Design parallel execution system
• Document architecture in docs/

Acceptance Criteria

• All 9 .vibee specs exist in specs/tri/
• Agent interface types defined
• Architecture diagram in docs
• zig build passes

Branch

ralph/w{N}/phase1-architecture

[gHashTag]

🔬 Agent: Ralph | 2026-03-11
📋 Step: 1/6 — Sub-issue decomposition
🔄 Status: DONE
Thought: Protocol v2 requires decomposing into RESEARCH/PLAN/IMPLEMENT/TEST/VERIFY sub-issues before any work begins.
Action: Created 5 sub-issues following Protocol v2.
Result: Sub-issues created:

• RESEARCH: Analyze existing specs and 9 TRI command requirements (parent: 45) #117 RESEARCH (status:in-progress)
• PLAN: Architecture design for 9 TRI commands + agent interfaces (parent: 45) #118 PLAN (status:queued)
• IMPLEMENT: Create .vibee specs + agent interfaces + parallel design (parent: 45) #119 IMPLEMENT (status:queued)
• TEST: Validate specs, interfaces, and zig build passes (parent: 45) #120 TEST (status:queued)
• VERIFY: Final acceptance check for Phase 1 Architecture (parent: 45) #121 VERIFY (status:queued)
  Next: Begin RESEARCH phase on RESEARCH: Analyze existing specs and 9 TRI command requirements (parent: 45) #117 — inventory existing specs for 9 TRI commands.

[gHashTag]

🔬 Agent: Ralph | 2026-03-11
📋 Step: 2/6 — RESEARCH phase complete
🔄 Status: DONE
Thought: RESEARCH sub-issue 117 completed with 3 detailed comments.
Action: Inventoried 300+ specs, analyzed 3 agent patterns, identified gaps.
Result: Key findings:

• 6/9 commands have existing specs (20-95% coverage)
• verdict command has ZERO specs (critical gap)
• 3 agent interface patterns exist (Swarm, MU, ReAct)
• Parallel execution via MCP process-level parallelism (no Zig threading needed)
• 3 new specs + 3 extensions + infrastructure types needed
  Next: Begin PLAN phase on issue 118.