โ Documentation index ยท โ Iterion
The examples/ directory ships a curated set of
proven, productized bots and one actively-developed workflow.
Extensions. Iterion runs workflows from
.botfiles; packaged bundles use.botz. Any other extension is rejected at the CLI, server, dispatcher, and studio boundaries (pkg/dsl/workflowfileis the single source of truth).
examples/)All bots below are also wired as embedded dispatcher assignees by
pkg/cli/dispatch_defaults.go, so
iterion dispatch (with no config) recognises their names out of the box.
See the catalogue and decision tree in
bots/whats-next/skills/iterion-bot-catalog.md.
| Persona | Bot | Description |
|---|---|---|
| ๐งญ Nexie | whats-next/ |
Operator-loop bot: explore โ elicit โ roadmap โ materialise the chosen next_action as kanban issues; pairs with iterion dispatch |
| ๐ ๏ธ Featurly | feature_dev/ |
Self-driven feature development bot: plan โ implement โ review โ refine loop with judge gates |
| ๐ฟ Billy | branch_improve_loop/ |
Branch-scope variant of the alternating improve loop with auto-commit between iterations |
| ๐ Willy | whole_improve_loop/ |
Alternating Claude/GPT review-and-fix pattern with cross-family streak detection (whole-repo scope) |
| ๐ Doki | docs-refresh/ |
Detect & fix doc/code drift across README, CLAUDE.md, and docs/**/*.md (alternating Claude/GPT review with a mechanical coverage gate) |
| ๐ Revi | review_pr/ |
Read-only cross-family code review; publishes findings to the native board (no fix, no commit) |
| ๐ก๏ธ Seki | sec-audit-source/ |
Source-code SAST audit (gitleaks/trivy/semgrep/gosec/bandit) with per-repo cross-run FP memory โ see docs/security-bots.md |
| ๐ฆ Depsy | sec-audit-deps/ |
Supply-chain malware/CVE audit on installed deps (npm/pip/go/โฆ) + host-wide package cache โ see docs/security-bots.md |
Small, self-contained .bot files that each isolate one feature:
| Example | Shows |
|---|---|
human-in-the-loop.bot |
A human node as the entry โ pauses instantly and renders an interaction form (no LLM). Companion to human-in-the-loop.md. |
clarify/main.bot |
A read-only facilitator agent using interaction: llm (auto-answers, never blocks). |
| Persona | Bot | Description |
|---|---|---|
| โฌ๏ธ Renovacy | secured-renovacy/ (.botz bundle) |
Autonomous, security-aware dependency upgrades for any stack (yarn/npm/pnpm/pip/poetry/uv/cargo/go/bundler/composer/maven). Run via iterion run bots/secured-renovacy/ or against the packed archive iterion bundle pack bots/secured-renovacy && iterion run bots/secured-renovacy.botz. |