https://www.loom.com/share/de2d7abbb7104649842b2ec1f53dfde4

Основные фичи

• Явный FSM-пайплайн: fetch -> context -> plan -> implement -> verify -> pr -> done. Процесс можно продолжать после рестарта и отлаживать по стадиям.
• Отдельная стадия context: анализ репозитория, языков, манифестов, релевантных файлов, тестовых команд и памяти прошлых задач.
• Стадия plan до реализации. Если задача неясная, агент возвращает NEED_VERIFICATION, пайплайн блокируется и задает вопросы в issue.
• Реализация в отдельном git worktree на ветке foundry/task-{id}.
• Retry-loop implement -> verify -> implement: новая попытка получает отчет предыдущей верификации.
• Двухуровневый verify: сначала детерминированные команды (ruff, pytest, npm test), потом LLM-review по diff.
• PR feedback runner читает requested changes, комментарии и failing CI checks, затем дорабатывает ту же PR-ветку.
• Observability: append-only event log в SQLite, FastAPI, SSE и React UI с live-потоком стадий, событий, токенов и I/O.
• Pluggable backends: stub, claude_cli, codex_cli, opencode_cli.
• Safety layer: scrubbed env, safe agent mode, запрет опасных команд, sanity check перед PR, лимит файлов, checkpoint diff перед retry.
• Repo memory сохраняет touched files, verify commands и common failures для следующих задач.

Failure modes

• Rate-limit / 429 / 529 от LLM API. Ловится по stderr, есть backoff 30/60/120s до трех попыток.
• Verify UNCLEAR: LLM-review не вернул PASS или FAIL, задача уходит в BLOCKED.
• gh push падает на уже существующей ветке foundry/task-{id}; это infra failure и re-queue.
• Safe mode Claude иногда блокирует shell-команду в plan-stage, агент не находит обход и возвращает невалидный план.
• opencode_cli не стримит инкрементальные события, UI видит только финальный stage_finished.
• Git-конфликты при push не решаются автоматически.