iterion

โ† Documentation index ยท โ† Iterion

Examples

The examples/ directory ships a curated set of proven, productized bots and one actively-developed workflow.

Extensions. Iterion runs workflows from .bot files; packaged bundles use .botz. Any other extension is rejected at the CLI, server, dispatcher, and studio boundaries (pkg/dsl/workflowfile is the single source of truth).

๐Ÿค– Productized bots (folder-per-bot under 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

๐Ÿงช Minimal DSL demos

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).

๐Ÿšง In active development

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.