Vibecoding General — Multi-Agent Coding Orchestration

Design-first, multi-agent workflow for building general software projects. Covers Python tools, data pipelines, ML systems, APIs, games, bots, CLI apps, mobile apps, and any non-frontend coding task.

Core Principles

1. Spec-first. A specification document (SPEC.md) is written before any implementation. It is the single source of truth for architecture, modules, interfaces, and data flow.
2. Spec fidelity. Subagents implement SPEC.md faithfully — exact interfaces, exact module boundaries, exact data formats. No unilateral changes.
3. Main agent owns init, merge, integration. Subagents implement and commit on their branches.
4. Parallelism by modules & features. Each subagent owns one or more modules/features. Group related work into one agent to minimize cross-agent dependencies.
5. Git worktrees isolate work. Each subagent works in its own git worktree to avoid conflicts. The shared repo is the coordination hub.
6. Interface contracts are sacred. Define function signatures, data schemas, and file formats in the spec. Subagents implement to these contracts so modules integrate cleanly.
7. Test before merge. Each subagent runs tests for their module before committing. Main agent runs integration tests after merge.

Mode Selection