Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install finna

It will make the finna command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall finna uninstalls.

Back to the crate overview.

Readme

finna

Multi-model debate, spec, and implement tool. Takes an idea, debates it across Claude/Codex/Gemini, creates a roadmap, writes specs, and implements.

Usage

# Run all stages
finna "Add JWT authentication to the API"

# Or run stages separately
finna debate "Add JWT authentication"  # debate → roadmap
finna spec                              # roadmap → specs
finna implement                         # specs → code

# Target specific steps
finna spec --step auth-middleware
finna implement --step auth-middleware

How it works

Debate: Three models (Claude, Codex, Gemini) independently analyze the idea
Consensus: Claude synthesizes proposals into a unified approach
Roadmap: Break consensus into ordered, dependency-aware steps
Spec: Write detailed ARF specs for each step
Implement: Models propose edits, Claude synthesizes, edits applied

Output

.finna/
├── consensus.json      # Synthesized approach
├── roadmap.arf         # Ordered steps with dependencies
└── specs/
    ├── 01-step-name/
    │   └── spec.arf    # Detailed implementation spec
    ├── 02-next-step/
    │   └── spec.arf
    └── ...

ARF spec format

order = 1
what = "one sentence description"
why = "context and motivation"
how = """
Step-by-step implementation plan:
1. First do this
2. Then do that
"""
backup = "fallback approach"

[context]
files = ["paths/to/files"]
dependencies = ["external deps"]

Requirements

claude CLI
codex CLI
npx @google/gemini-cli

Build

nix-shell
cargo build --release

License

MIT