Flatbread — скилл
Flatbread хранит решения, находки и ограничения проекта Markdown-файлами в Git, а скилл Proof дает агентам общую долгую память
- 69 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл дает агенту писать Markdown-файлы с записями в репозиторий
- Команда установки скачивает пакет npm и добавляет его в devDependencies
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/flatbreadОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл дает агенту писать Markdown-файлы с записями в репозиторий
- Команда установки скачивает пакет npm и добавляет его в devDependencies
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Flatbread превращает Markdown и YAML-файлы репозитория в записи именованных коллекций, связанных между собой через `refs` в flatbread.config.js. Граф проверяется до чтения, а читают его по GraphQL, через сгенерированный TypeScript или ограниченные команды CLI. Файлы остаются источником правды, с обычными ветками, ревью и историей Git. Для агентов предназначен пакет Proof. Команда npx --yes flatbread@latest proof install-skill скачивает свежий CLI, закрепляет его точную версию в devDependencies и копирует скилл Proof. Агент фиксирует в репозитории Issues, Findings, Decisions, Constraints и Risks внутри Effort, то есть цельной линии работы. Каждая запись лежит в отдельном Markdown-файле, поэтому следующая сессия и коллеги читают те же причины, смотрят их в `pull` `request` и видят, как менялось решение. Команда npx flatbread proof bootstrap --verify проверяет настройку и печатает JSON со статусом ready. Запись создает proof `write` с JSON-описанием, чтение дает proof `list`, например с фильтром --status `active`. Второй сценарий использования: сайты, документация и внутренние инструменты на связанных файлах, с командой flatbread start --watch и GraphQL на порту 5057.
Для кого. Командам и одиночным разработчикам, у которых долгая работа идет через много сессий Claude Code или Codex и причины решений теряются в чатах.
Подходит, если
- Задача на несколько недель, и каждая новая сессия агента начинает без контекста прошлых решений
- Причины выбора библиотеки должны пройти ревью в `pull` `request` вместе с кодом
- Коллегам нужно прочитать те же находки и ограничения, что видит агент
- Сайт или документация собираются из Markdown со связями между записями, например посты и авторы
- Нужны ограниченные команды CLI, из которых агент читает граф вместо всего репозитория
Не подходит, если
- Проект не на Node: Flatbread требует Node 20.19 или новее
- Нужна внешняя база с запросами по большому объему данных: файлы здесь единственное хранилище
- Достаточно одного файла с заметками вроде CLAUDE.md: схема коллекций и `refs` окажется лишней
- Нужен захват памяти из чатов автоматически: записи агент создает сам по правилам скилла
Пример запроса к агенту
Подключи Proof к проекту, создай Effort «Выбор поискового индекса» и запиши первое ограничениеОграничения
- Требуется Node 20.19 или новее для каждого пакета.
- Модель Proof подключают вручную: в flatbread.config.js добавляют proofContent(), а в .gitignore две строки для рабочего состояния.
- Проверка proof bootstrap только осматривает проект и ничего не правит.
- GraphQL в проекте лишь один из способов чтения, а сгенерированный TypeScript-слой в README назван прототипом и по-прежнему выполняет запросы через GraphQL.
- Отдельной команды flatbread dev нет: dev- и build-скрипты оборачивают командой flatbread start.
Как отключить. Удалите скилл Proof из папки скиллов агента, уберите proofContent() из flatbread.config.js и пакет flatbread из devDependencies. Записи в Markdown остаются в репозитории обычными файлами.
Частые вопросы
Что такое Proof во Flatbread?
Proof — пакет для долгой памяти агентов. Агент записывает Issues, Findings, Decisions, Constraints и Risks в Markdown-файлы внутри Effort. Они лежат в вашем репозитории и не зависят от закрытого чата или облака.
Как поставить Proof в проект?
Выполните npx --yes flatbread@latest proof install-skill. Команда закрепит версию CLI в devDependencies и скопирует скилл. Затем подключите proofContent() в конфиг и проверьте установку командой npx flatbread proof bootstrap --verify.
Нужен ли GraphQL, чтобы пользоваться Proof?
Нет. Агенты читают данные ограниченными командами CLI, например npx flatbread proof `list` --status `active`, и получают JSON с путем к дайджесту в Markdown. GraphQL нужен второму сценарию, сайтам и приложениям.
Какие записи ведет агент в Proof?
Issues, Findings, Decisions, Constraints и Risks внутри Effort, то есть одной цельной линии работы. Каждая запись лежит отдельным Markdown-файлом, и ее видно в истории Git и в `pull` `request`.
Какая версия Node нужна?
Node 20.19 или новее для каждого опубликованного пакета Flatbread. Команда proof install-skill закрепляет точную версию CLI в devDependencies проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыomnistack-agent ставит четыре скилла для Claude Code, Copilot, Cursor и Codex: отладка, ревью кода, безопасность и общая инженерия
Набор скиллов против ИИ-халтуры: аудит интерфейса и типографики, ревью изменений, релизы, документация и SEO.
Два скилла для Codex и Claude Code: prd ведет живой документ с чеклистом внедрения, review смотрит на решения глазами пользователя
Builder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
Одиннадцать скиллов для Claude Code и Codex: аудит тестов, очистка git worktree, страницы планов, расшифровка записей экрана и вход через 1Password
planr хранит задачи агентной разработки в Markdown-файлах Git и показывает, что готово, заблокировано и ждет решения
Коротко о README
README делит пользователей на два пути: память для кодинг-агентов через Proof и связанный контент для приложений. Каждый путь дан пошагово с командами, затем описано устройство движка: источник находит файлы, трансформер делает записи, content группирует их в коллекции, `refs` связывают, граф проверяется и отдается через GraphQL, TypeScript или команды Proof.