Конвейер промптов демонстрирует свойства метапрограммирования.

Разработчик задокументировал конвейер промптов, используемый для создания приложения Electron (Claude Code CLI, React, TypeScript, SQLite), который демонстрирует структурные свойства метаязыка программирования, включая типизированные входы/выходы, управление потоком выполнения, циклы, конечные автоматы и интерфейсы модулей.

Архитектура конвейера

Система работает в четырех отдельных этапах с типизированными контрактами между ними.

Этап 1: Статический анализ

Промпт repo-eval.md выполняет полное сканирование кодовой базы. Он читает каждый исходный файл, отслеживает графы зависимостей, отображает IPC-потоки от начала до конца и выдает структурированный отчет о результатах в issues.md. Каждая находка включает:

• Идентификатор раздела
• Заголовок
• Серьезность (Критическая/Высокая/Средняя/Низкая)
• Категория
• Пути к файлам с диапазонами строк
• Доказательства
• Оценка влияния
• Рекомендуемое исправление

Этап 2: Компиляция

Промпт address-issues.md анализирует вывод Этапа 1. Он группирует находки по сходству файлов, назначает номера промптов (FIX-01, FIX-02, ...), определяет зависимости между промптами и сортирует по серьезности. Результатом является каталог (prompts/arch/r{NNN}/), содержащий:

• FIX-NN.md — Самодостаточные промпты на исправление, указывающие цель, рассматриваемые находки, файлы для изменения, шаги реализации и критерии проверки.
• STATE.md — Трекер состояния выполнения со статусом для каждого промпта (ожидает/в процессе/готово/заблокировано), графом зависимостей, датами завершения и заметками о передаче.
• MASTER.md — Спецификация цикла выполнения.

Этап 3: Выполнение

MASTER.md служит циклом выполнения. На каждой итерации:

1. Читает STATE.md
2. Выбирает следующий ожидающий промпт, зависимости которого удовлетворены
3. Читает промпт
4. Читает все затронутые исходные файлы
5. Выполняет шаги реализации
6. Запускает проверку (tsc --noEmit, grep для удаленных шаблонов, проверки количества строк)
7. Обновляет STATE.md
8. Добавляет запись в журнал изменений, обновляет документацию по архитектуре
9. Возвращается к шагу 1

Этап 4: Упаковка

Промпт release-notes.md читает журнал изменений, запускает git log и git diff --stat по сравнению с последним тегом, категоризирует изменения и выдает отформатированные заметки о выпуске с рекомендацией по увеличению версии.

Ключевые свойства

Типизированные контракты: Схема вывода repo-eval является входным контрактом для address-issues. Схема вывода address-issues является входным контрактом для MASTER. Промпты FIX потребляют точный формат, который выдает address-issues. STATE.md имеет определенную схему, которую MASTER читает и записывает.

Автоматическая документация: Системный промпт (agents.md), прикрепленный к каждому контекстному окну Claude Code, включает протокол пост-выполнения: добавление записи в журнал изменений, обновление затронутой документации по архитектуре, обновление отслеживания состояния. Документация создается как побочный эффект выполнения промпта, устраняя распад контекста.

Промпты как ADR: Каждый FIX-NN.md функционирует как документ проектирования, рабочий заказ и запись архитектурных решений, фиксируя проблему, обоснование, план реализации и критерии проверки перед выполнением.

Результат

Один день работы этого конвейера дал:

• 2 полные оценки репозитория
• 17 исправлений ошибок за 2 раунда ревизий (условия гонки, архитектура потоков, управление параллельным состоянием)
• Декомпозиция сервиса: 1218 строк → 403 строки + 5 извлеченных сервисов
• 3 дополнительных исправления сбоев
• Переписывание README, проверенное по исходному коду
• 6-страничный веб-сайт GitHub Pages
• 21 запись в журнале изменений