Fireteam
martinnaithani/FireteamФайловый протокол координации для AI-агентов в проекте. Папка `.fireteam/` даёт агенту постоянную память: контекст миссии, состояние задач и чекпоинты. Без сервера и базы данных — только markdown-файлы.
Установка
git clone https://github.com/martinnaithani/Fireteam.gitREADME
🔥 Fireteam
Ваш AI-агент забывает всё при завершении сессии. Fireteam решает эту проблему.
Папка .fireteam/ в вашем проекте даёт AI-агенту постоянную память — контекст миссии, состояние задач, чекпоинты прогресса и структурированные заметки, которые сохраняются после перезапуска сессий, при исчерпании контекста и после сбоев. Без сервера. Без базы данных. Только markdown-файлы.
Работает с Claude Code, Codex, Antigravity, Cursor, Aider, Windsurf — с любым инструментом, который умеет читать файлы.
Впервые здесь? Прочитайте Руководство по началу работы — без жаргона, шаг за шагом.
Установка
Скачайте Claude Skill и загрузите в Claude:
Claude.ai: Settings → Capabilities → Skills → Upload fireteam-skill.zip
Claude Code: Поместите папку skill/fireteam/ в директорию skills
Затем просто скажите:
"Set up a fireteam for this project"
Всё. Claude настраивает миссию, разбивает работу на задачи и начинает выполнение. При завершении или сбое сессии всё сохраняется. Следующая сессия продолжает с того места, где остановилась.
Зачем нужен Fireteam
Каждая AI-сессия начинается с нуля. Агент не знает, что вы строили вчера, какие решения были приняты и что ещё предстоит сделать. Каждый раз вы тратите первые 10 минут на повторное объяснение контекста.
Fireteam даёт вашему агенту постоянную проектную память:
.fireteam/
├── MISSION.md ← что и зачем мы строим
├── BOARD.md ← задачи и их статус
├── INTEL.md ← стек, пути к файлам, API-контракты, ключевые решения
├── tasks/OBJ-001.md ← каждая задача с цепочкой целей и критериями приёмки
├── handoffs/ ← структурированные заметки между задачами
├── checkpoints/ ← сохранённое состояние сессии (каждые 15 мин)
└── memory/ ← ежедневный журнал событий
Агент читает эти файлы при старте сессии. Он знает миссию, видит что сделано, находит следующую задачу и продолжает работу. Без повторных объяснений.
Как это работает
Сессия 1:
Агент читает PRD → создаёт миссию, задачи, доску
Работает над OBJ-001 → строит API, сохраняет чекпоинты
Завершает OBJ-001 → пишет заметки передачи, отмечает выполненным
Начинает OBJ-002 → контекстное окно заполняется, сессия завершается
Последний чекпоинт: OBJ-002 на 60%
Сессия 2 (новая сессия, чистый контекст):
Агент читает .fireteam/ → знает миссию, видит что OBJ-001 выполнен
Читает чекпоинт → OBJ-002 на 60%, продолжает с этого места
Читает передачу от OBJ-001 → имеет API-контракт
Завершает OBJ-002 → пишет передачу, начинает OBJ-003
...продолжает до полного завершения
Ключевая идея: ваш агент уже умеет читать и писать файлы. Fireteam использует файловую систему как слой памяти, который сохраняется между сессиями.
Что умеет скилл
Claude Skill обучает Claude полному протоколу. Он автоматически адаптируется к вашему проекту:
| Ситуация | Что сказать |
|---|---|
| Новый проект | "Set up a fireteam for this PRD" (вставьте требования) |
| Существующая кодовая база | "Add fireteam to this project" (сначала сканирует код) |
| Продолжить работу | "Continue my fireteam" (читает .fireteam/, продолжает работу) |
| После сбоя | "Resume my fireteam agent" (проверяет состояние, затем возобновляет) |
| Сохранить прогресс | "Write a checkpoint" |
| Новая фича в существующем проекте | "Set up a fireteam for this feature" (вставьте спецификацию + читает код) |
Основной протокол
Прогрессивные чекпоинты — состояние сохраняется каждые 15 минут во время работы. Сессии прерываются — работа сохраняется. Сбои отнимают минуты, не часы.
Передачи (Handoffs) — структурированные заметки между задачами: что построено, расположение файлов, API-контракты, что делать дальше. Когда агент начинает следующую задачу (даже в новой сессии), он читает передачу и имеет полный контекст.
Цепочки целей (Goal Chains) — каждая задача содержит: Миссия → Цель → Задача → Зачем это важно. Агент всегда знает зачем он что-то делает, а не только что.
Heartbeat — каждая сессия начинается с: миссия → intel → доска → чекпоинты → передачи → «какой мой наивысший приоритет?». Стабильная ориентация менее чем за 10 секунд.
Восстановление после сбоя — скажите "resume my fireteam agent". Агент проверяет файлы, статус git и чекпоинты, чтобы убедиться в том, что реально выполнено, прежде чем продолжить. Никогда не предполагает, что предыдущая сессия что-то завершила.
Несколько агентов (когда это нужно)
Для крупных проектов Fireteam масштабируется до 2–6 агентов, работающих параллельно в отдельных терминалах. Одни и те же файлы .fireteam/ координируют их взаимодействие:
Терминал 1 (Backend): читает миссию, берёт OBJ-001, строит API
↓ пишет передачу с API-контрактом
Терминал 2 (Frontend): читает передачу, берёт OBJ-002, строит на основе реального API
↓ оба независимо сохраняют чекпоинты
Терминал 3 (Deploy): ждёт зависимостей, берёт OBJ-003, деплоит
Каждый агент имеет SOUL-файл (идентичность роли), атомарно захватывает задачи (без дублирования работы) и общается через передачи и потоки коммуникаций. Протокол берёт координацию на себя — вам не нужно копировать контекст между терминалами.
Большинству проектов это не нужно. Один агент, циклически выполняющий задачи с чекпоинтами, покрывает 80% случаев. Мультиагентный режим нужен только при реальной необходимости в параллелизме.
Интеграции с инструментами
./fireteam.sh integrate claude-code # CLAUDE.md + авто-хуки + настройки
./fireteam.sh integrate cursor # .cursor/rules/fireteam.mdc
./fireteam.sh integrate aider # CONVENTIONS.md
./fireteam.sh integrate windsurf # .windsurfrulesИнтеграция с Claude Code включает хуки жизненного цикла:
- Старт сессии → автоматический брифинг миссии (цели, передачи, статус)
- Завершение сессии → напоминание о чекпоинте
Ручной heartbeat не нужен — хуки берут это на себя.
CLI
./fireteam.sh task "Build a login page" # создать задачу
./fireteam.sh checkpoint # сохранить прогресс
./fireteam.sh status # показать текущее состояние
./fireteam.sh handoff OBJ-001 # создать передачу
./fireteam.sh board # показать доску задачСтруктура файлов
.fireteam/
├── MISSION.md ← контекст проекта и цели
├── BOARD.md ← все задачи и статусы
├── INTEL.md ← технический стек и ключевые решения
├── AGENTS.md ← реестр агентов (для мультиагентного режима)
├── tasks/
│ ├── OBJ-001.md ← детали задачи, цепочка целей, критерии приёмки
│ └── OBJ-002.md
├── handoffs/
│ └── OBJ-001-to-002.md ← контекст между задачами
├── checkpoints/
│ └── 2024-01-15-1430.md ← сохранённое состояние сессии
├── memory/
│ └── 2024-01-15.md ← ежедневный журнал
└── agents/ ← SOUL-файлы агентов (мультиагентный режим)
Лицензия
MIT — используйте свободно.