- **Single-writer rule** — only the Coder writes code, so agents never collide.
- **Off-topic plan check** — if the Architect's plan drifts from your request, the Coder follows *your request*, not the plan.
- **Right-sized team** — a one-line fix gets no council; a full-stack system gets all four. Token budget is checked up front (trivial ≈ 500 tokens … enterprise ≈ 30,000).
- **Summon it yourself** — *"konseyi topla"* ("gather the council").
- **Honest report** — a plain-language summary of who did what, including anything left unresolved.
→ [Full Council write-up (Turkish)](docs/konsey.md)
## 🚦 No "done" without proof — FinishGate
A task only closes with **live evidence**: an HTTP 200 from the running server, passing tests, or the
expected DOM in a headless browser. Otherwise the agent returns to a **self-healing loop**. If it gets
stuck, a stuck-detector hands control back to you.
## 🔀 Four modes
**Chat** (explain, answer) · **Plan** (no edits, just a roadmap) · **Autonomous** (plan → approve →
apply → verify) · **Bug Hunter** (root cause from logs and output).
## ⌨️ CLI highlights
```bash
numex "build a dark-themed todo app"
numex plan "add a payment module" # plan only
numex mission "make the tests pass" # long-running autonomous mission in sandboxed worktrees
numex undo # roll back the last turn
numex --offline "…" # local Ollama, no internet
numex uzak install # control your PC from your phone
```
Surgical diff-based patching · background process error interception · BM25 + AST code index · MCP
client · live tree progress.
## 🧠 Transparent memory
Every project gets a readable `.numex/` folder: RAG index, **audit trail** of every action, undo
checkpoints, learned errors, mission state and token usage. → [docs/numex-klasoru.md](docs/numex-klasoru.md)
## 🤝 Community
Bugs and ideas → [Issues](../../issues/new/choose) · Show what you built → [Discussions](../../discussions) ·
