Namako

Spec-Driven Development testing framework for Rust projects

Tool	Purpose
Namako	BDD testing framework + CLI (measures truth)
Tesaki	AI task orchestrator — see standalone repo

---

AI Coding Agent? Start Here

Single entrypoint: _AGENTS/AGENT_GUIDE.md

This file contains everything you need to understand and work on this codebase efficiently.

---

Quick Start (Human Users)

# Install namako CLI (from namako/)
cargo install --path cli --force

# Install Tesaki (from standalone tesaki repo)
cargo install --git https://github.com/connorcarpenter/tesaki.git --force

# Configure a target repo
cd <target-repo>
mkdir -p .tesaki
cat > .tesaki/config.toml << 'EOF'
specs_dir = "test/specs"
adapter_cmd = "cargo run --manifest-path test/npa/Cargo.toml --"
agent = "copilot"
max_retries = 0
max_cert_updates = 3
EOF

# Run autonomous loop
tesaki --loop 10

Repository Structure

namako/
├── src/              # Namako core library
├── cli/              # namako_cli binary
├── codegen/          # Step macros (#[given], #[when], #[then])
├── _AGENTS/          # AI agent documentation (START HERE)
└── _WORKSPACE/       # Operational docs & archives

Commands

Namako CLI

namako lint    # Parse specs, resolve bindings
namako gate    # Full CI: lint → run → verify
namako status  # JSON status packet
namako review  # Work backlog packet

Tesaki CLI

tesaki              # Interactive REPL
tesaki --loop N     # Run N missions autonomously
tesaki diagnose ID  # Debug a specific mission

Testing

cargo test              # All tests
cargo test -p namako_cli

Documentation Map

File	Purpose
_AGENTS/AGENT_GUIDE.md	Single entrypoint for AI agents
_WORKSPACE/RUNBOOK.md	Operational checklist for loop execution

Historical/archived docs are in _WORKSPACE/ARCHIVE/.

---

Namako: "sea cucumber" in Japanese — methodical, thorough, spec-driven.