flowcairn

Flowcairn еще в разработке !

AI выполняет задачу. Вы видите план, проверки и свой код.

Локальный инструмент для разработки с AI: превращает поручение в согласованный план, выполняет работу с учетом зависимостей и показывает, чем подтвержден результат.

Пакет в npm

Смотреть запись работы · Быстрый старт · Документация

Это запись работающего интерфейса. Ответы AI подставные; Executor, изменение файла, процессы проверок и отчеты настоящие. GIF показывает шесть кадров, полное видео и данные запуска хранятся в репозитории. Это не демонстрация live inference.

От поручения до проверенного результата

AI написал код — но что он изменил, почему считает работу законченной и сможете ли вы разобраться в решении завтра? Flowcairn связывает эти вопросы в один процесс:

• Опишите результат. Система исследует проект, выделяет требования и неизвестные.
• Проверьте план. Видны работы, зависимости, область записи и способы проверки. Изменения начинаются после согласования.
• Следите за выполнением. Герои Мастерской отражают реальные состояния узлов. Ошибка проверки вызывает ограниченное исправление или останавливает работу.
• Посмотрите доказательства. Для каждого обязательного требования нужны допустимая проверка и актуальные данные. Зеленый узел или общий ответ AI сами по себе недостаточны.
• Разберите свой код. В книге сохранены исходники, версии и контекст. Объяснение доступно по возможностям выбранного AI-клиента.

Один сценарий целиком

В записи система получает задачу: сохранить число 2 в counter.json и проверить его существующим verify.mjs.

Момент	Что действительно произошло
План	До согласования файл содержит 0
Ошибка	Первая правка записала 1; проверка ожидала 2 и завершилась с exit 1
Результат	Исправление записало 2; проверка прошла, Executor рассчитал PROVEN после подставного review
Изменение исходника	Внешнее изменение на 3 сняло подтверждение текущего результата

Где здесь граф

План — направленный граф: узел знает свои зависимости (needs), разрешенную работу и проверки. Executor управляет переходами и не пропускает обязательные проверки. Главный интерфейс — 2D-мир; технические подробности доступны в книге диагностики. Это не редактор ReactFlow.

Схема упрощает внутренний граф. Учебная пауза зависит от режима; отсутствие проверки, неопределенность и устаревшие данные не становятся PASS. Подробный контракт.

Учитесь на коде своей frontend-задачи

Пример: исправить поиск товаров, чтобы старый ответ сервера не заменял новую выдачу. После изменения кода вы открываете его сохраненную версию и разбираете именно это решение.

• Проследите данные. Ввод → search(query) → запрос → await → проверка актуальности → обновление списка.
• Свяжите объяснение со строками. Почему после «рюкзак» → «термос» на экране остается последняя выдача? Книга показывает значения request и latest и подсвечивает защиту от старого ответа.
• Объясните последствие правки. Что сломается, если убрать эту же защиту из catch? Сформулируйте ответ своими словами, сверяясь со своим кодом.

Затем — ваша попытка объяснить решение: вопрос привязан к тому же фрагменту, код остается перед глазами.

Посмотреть следующий шаг разбора и мобильную книгу

Обработка ошибки старого запроса · Чтение кода на телефоне

Кадры сняты с текущего интерфейса книги на подготовленном frontend-уроке. Учебные данные и черновик ответа заданы для съемки; внешний AI не вызывался, ответ не отправлялся. Это отдельный пример обучения, а не продолжение задачи со счетчиком из видео выше.

Разбор доступен после этапа или после всей задачи. Чтение и ответы не меняют PROVEN; продолжение после учебной паузы — отдельная команда. Эффективность обучения проверяется отдельно.

Быстрый старт

В корне своего проекта, с Node.js 22:

npx flowcairn

Пройдите короткую настройку, авторизуйте выбранный AI-клиент и откройте Гильдию. Опишите задачу, проверьте план и разрешения, затем начните выполнение. Git и package.json не обязательны для direct-запуска.

Новые проекты используют developer workflow: задачи с поведением или риском проходят отдельное read-only review плана до разрешения правок. Для обязательной проверки поведения нужен свежий scenario report; настройка existing runners описана в профилях проверок.

Если браузер нужно открыть вручную:

npx flowcairn --no-open

Установка · Первая задача · Проверки других языков · Решение проблем

Клиенты и текущие ограничения

• Codex, Claude Code, Cursor подключаются через официальные CLI и их авторизацию. Codex и Claude Code поставляются с проверенными базовыми версиями; Cursor Agent CLI устанавливается отдельно.
• Целевые ОС — macOS и native Windows; Linux/WSL исключены. Локальная проверка macOS не подтверждает Windows. Актуальные прогоны и границы — в VERIFICATION.
• Claude Code и Cursor проверялись через native-no-inference и симуляторы без авторизованных аккаунтов. Это не live inference. Учебная генерация имеет отдельные ограничения по клиентам, версиям и ОС.
• Проверки запускаются локально с правами пользователя. Flowcairn не добавляет универсальную файловую песочницу и не заменяет permission controls AI-клиента.
• Эффективность обучения и производительность на целевом оборудовании требуют отдельной приемки. Все ограничения.

Документация и участие

Как работает · Developer workflow · Архитектура · AI-клиенты · Skills · Участие · Безопасность

Для разработки:

npm ci --ignore-scripts
npm test
npm run build
npm run test:ui

Происхождение медиа · Исследование оформления · Воспроизведение записи. Лицензия MIT. Сторонние материалы и лицензии.