flowcairn

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

Поручите задачу AI. Разберитесь в собственном коде.

Выполнение реальных задач и изучение решений в игровом 2D-мире.

Быстрый старт · Как это работает · Документация · Telegram автора

_{Актуальный интерфейс версии 0.5.1 на демонстрационных данных.}

Зачем Flowcairn

Когда AI пишет код, легко получить готовое решение и пропустить его логику. Flowcairn связывает рабочую задачу с разбором написанного кода: что изменилось, как движутся данные и почему части программы связаны именно так.

Внутри сохраняется граф исполнения с небольшими этапами, проверками и прогрессом. Снаружи — игровой мир: поручение в Гильдии, работа и книга кода в Мастерской, прошлые задачи в Архиве.

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

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

npm install -D flowcairn
npx flowcairn

Первый запуск предложит короткую настройку и откроет интерфейс в браузере.

Дальше: откройте Гильдию → опишите задачу → проверьте предложенный план и разрешения → начните выполнение.

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

Как это работает

Место	Что вы делаете	Что делает система
Гильдия	Описываете задачу и согласовываете границы работы	Анализирует задачу и предлагает план небольших этапов
Мастерская	Следите за работой, открываете код и учебный разбор	Выполняет разрешенные изменения, запускает проверки и сохраняет материал
Архив	Возвращаетесь к прошлым задачам и их материалам	Хранит версии задач, результаты и историю

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

Разбор в вашем темпе

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

В книге — сохраненный код, его изменения, объяснение выполнения и движения данных. Код доступен для чтения и копирования; писать его внутри Flowcairn не требуется. Подготовка AI-объяснения запускается отдельным действием, когда провайдер и разрешения позволяют это сделать.

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

Демонстрационная frontend-задача: поиск товаров на JavaScript. Пользователь вводит «рюкзак», затем «термос»; разбор объясняет, почему поздний ответ первого запроса не меняет выдачу. Данные учебные, внешний AI при съемке не запускался.

Следующий шаг разбора

Новый шаг открывается с начала. Обсуждаемые строки выделены внутри сохраненного кода; начало функции и окружающие строки остаются видны.

Чтение на узком экране

Объяснение и код открываются отдельно. При переключении сохраняются место чтения и черновик вопроса; продолжение выполнения находится в отдельном представлении.

Объяснение	Сохраненный код

Чтение не считается приемкой кода или доказательством освоенного навыка. Как проверить пользу обучения.

Ваш проект, ваш язык

Node.js нужен самому Flowcairn; язык исходников проекта не ограничен JavaScript. Для своего стека подключите команды проверок. Если нужного компилятора или проверки нет, система сообщает об ограничении.

Flowcairn поставляет Codex и Claude Code CLI. Их авторизация остается у выбранного клиента. Git и Docker для обычного запуска не требуются.

Текущая граница обучения: подготовка AI-разбора проверена для Codex 0.156.1/0.157.1 на macOS. Доступность обучения проверяется отдельно от исполнения задач. Совместимость и ограничения.

Контроль над выполнением

По умолчанию исполнитель меняет файлы текущего проекта после согласования плана. Коммиты, PR и публикация остаются отдельными действиями.

• План перед изменениями. Codex, Claude Code или Cursor читает исходники средствами выбранного клиента. Executor применяет согласованные изменения с проверкой путей и хешей.
• Проверки вашего проекта. Зарегистрированные команды запускаются локально. Непроверенные требования не считаются выполненными.
• Материал связан с версией кода. Сохраненные исходники и отчеты помогают вернуться к конкретному решению; устаревание материала показывается отдельно.

Граф и успешные тесты не гарантируют отсутствие любых ошибок. Flowcairn проверяет собственный контекст и артефакты на известные секреты, но не изолирует все действия внешнего клиента или команд проекта. Дополнительная Git worktree остается отдельной настройкой существующего адаптера npm scripts.

Что фактически проверено · Ограничения

Настройка, диагностика и устройство системы

• Как работает Flowcairn
• Конфигурация и подключение Skills
• Архитектура и контракт выполнения
• Решение проблем

Проверить доступность компонентов в установленном проекте:

npx flowcairn doctor

Участие и связь

Нашли ошибку или хотите предложить улучшение? Начните с помощи и правил участия. О проблемах безопасности сообщайте по инструкции.

Telegram автора — разработка Flowcairn и новости проекта. Подписка необязательна.

Лицензия MIT. Сведения о сторонних материалах — в THIRD_PARTY_NOTICES.md.