rooda

AI-powered OODA loop orchestrator for autonomous software development.

What is rooda?

rooda orchestrates AI coding agents through structured OODA (Observe-Orient-Decide-Act) iteration loops to autonomously build, plan, and maintain software from specifications. Point an AI agent at your work, and it iterates toward a solution with fresh context each cycle.

Quick Start

# Install
curl -fsSL https://raw.githubusercontent.com/jomadu/rooda/main/scripts/install.sh | bash

# Bootstrap a repository (creates/updates AGENTS.md)
rooda bootstrap --ai-cmd-alias kiro-cli

# List available procedures
rooda --list-procedures

# Run a procedure
rooda build --ai-cmd-alias kiro-cli --max-iterations 3

Installation

See docs/installation.md for all installation methods (Homebrew, direct download, build from source).

Core Concepts

Procedures: Named OODA workflows (e.g., build, audit-spec, draft-plan-impl-feat). Each procedure defines which prompt fragments to use for each phase.

OODA Loop: Observe (gather context) → Orient (analyze) → Decide (plan) → Act (execute). Each iteration runs all four phases with fresh AI context.

AGENTS.md: Repository operational guide that tells agents how to interact with your project (build commands, test commands, work tracking system, file patterns).

Work Tracking: rooda integrates with beads, GitHub Issues, or file-based systems. The build procedure reads tasks and implements them.

Configuration

rooda uses a three-tier configuration system:

1. Built-in defaults: 21 procedures embedded in the binary
2. Global config: ~/.config/rooda/rooda-config.yml (team-wide settings)
3. Workspace config: ./rooda-config.yml (project-specific settings)

CLI flags override everything. See docs/configuration.md for details.

Common Workflows

Start a new project:

rooda bootstrap --ai-cmd-alias kiro-cli
rooda audit-spec --ai-cmd-alias kiro-cli

Implement from work tracking:

rooda build --ai-cmd-alias kiro-cli --max-iterations 5

Plan a feature:

rooda draft-plan-impl-feat --ai-cmd-alias kiro-cli --context "Add user authentication"

Audit implementation:

rooda audit-impl --ai-cmd-alias kiro-cli

Documentation

• Installation - All install methods
• Procedures - All 21 procedures with examples
• Configuration - Three-tier config system
• CLI Reference - All flags and exit codes
• Troubleshooting - Common errors and solutions
• AGENTS.md Format - Repository operational guide format

Requirements

• Go >= 1.24.5 (if building from source)
• AI CLI tool (kiro-cli, claude, cursor-agent, etc.)
• Work tracking system (beads recommended, GitHub Issues supported)

License

MIT