Imported from NickMele/armada (
AGENTS.md). Install upstream withnpx skills add NickMele/armada. Copyright stays with the author.
Armada
A macOS app that dispatches coding agents against git repositories and verifies their work before advancing them. Rust daemon, Electron app, one repo.
- Read
cargo xtask verify-foundationsas a delta againstmain, not as a colour. Red is legitimate — read what each line names, and never chase green. - The acceptance test is a milestone's own claim, written before the code.
docs/practices/acceptance-tests.md. - v1 is deleted. A bare file path in a doc means
git show v1-final:<path>. - Cite an issue to a person as its full link, so it opens from the terminal.
A bare
#123stays bare inside the repo — docs autolink and gates parse it. - Never edit the checkout at
main. Cut a worktree on a branch before the first edit, and land it as a pull request..claude/skills/agent-worktrees/.
| Looking for | Go to |
|---|---|
| What Armada is for, and what it is not | docs/scope.md |
| A binding rule — architecture, errors, config, design, prompts | docs/contracts/ |
| Rust, Bridge, or the seam between them | docs/practices/ |
| What is open, and what is waiting on it | docs/OPEN.md, generated |
| A value — tokens, icons, settings | packages/, crates/config/settings.toml |
| What was measured, and what was not | docs/spikes/ |
| What is being built, and in what order | GitHub issues, grouped by milestone |
| What a thing is, and how it is used | docs/concepts/, docs/journeys/ |
| Skills and subagents | .claude/skills/, .claude/agents/ |
Everything written down is in docs/INDEX.md, and the gate refuses one that is
not. ARCHITECTURE.md is the map. CLAUDE.md symlinks here — a copy drifts.
This file routes. It does not explain. Anything longer than a pointer belongs in a contract, a practice doc or a skill. 50 lines is refused, 40 asks.