architect/projects/project-processor/PROJECT.md

type: system-project
domain: algorithms
name: project-processor
status: active
phase: 9
created: 2026-01-15
updated: 2026-03-26
template: BASE

project-processor — Рекурсивный алгоритм исполнения проектов

Универсальный алгоритм для Claude: как читать, понимать и исполнять любой проект платформы.

Текущая версия: v8.0
Целевая версия: v8.1 (добавить PREPARE + COMPRESS)

Проблема

Версия v8.0 не имеет:
- Шага PREPARE (подготовка контекста)
- Механизма COMPRESS (сжатие перед рекурсией)
- Трёхрежимной логики (SMALL/MEDIUM/LARGE проекты)
- Синхронизированных путей .task-stack/
- STANDARDS_REGISTRY рядом с TEMPLATE_REGISTRY

Архитектурные решения

Алгоритм v8.0 (текущий)

[0] INIT
  ← читать CLAUDE.md иерархии
  ← читать task.yaml (если есть)
  ← определить тип проекта

[1] ANALYZE
  ← понять цель и границы
  ← найти все зависимости
  ← оценить размер

[2] PLAN
  ← декомпозировать на шаги
  ← определить порядок
  ← оценить время

[3] EXECUTE
  ← выполнить шаги
  ← обновлять task.yaml на каждом шаге

[4] VERIFY
  ← проверить результат
  ← запустить тесты если есть

[5] REPORT
  ← отчёт о выполнении
  ← обновить task.yaml (status: done)

[∞] RECURSE
  ← если есть подпроекты → повторить с [0]

Целевой алгоритм v8.1

[-1] PREPARE (НОВЫЙ)
  ← проверить CLAUDE.md иерархии
  ← прочитать STANDARDS_REGISTRY
  ← прочитать TEMPLATE_REGISTRY
  ← определить режим: SMALL / MEDIUM / LARGE

[0] INIT
  ← читать task.yaml
  ← восстановить контекст из CACHE.yaml (если есть)

[1] ANALYZE ... (без изменений)

[2] PLAN
  ← декомпозировать
  ← если LARGE → создать контекстблоки (→ ПМ)

[3] EXECUTE ... (без изменений)

[COMPRESS] (НОВЫЙ — перед рекурсией)
  ← сжать текущий контекст
  ← записать в CACHE.yaml
  ← передать в дочерний вызов

[4] VERIFY ... (без изменений)
[5] REPORT ... (без изменений)
[∞] RECURSE → с COMPRESS

Трёхрежимная логика

Режим Критерий Поведение
SMALL < 5 файлов, < 30 мин Прямое исполнение
MEDIUM 5-20 файлов, 30-120 мин Контекстблоки, без ПМ
LARGE > 20 файлов, > 2 часов ПМ → декомпозиция → кодер

Реестры

# TEMPLATE_REGISTRY — шаблоны для разных типов проектов
templates:
  BASE: architect/templates/BASE/
  IT: architect/templates/@biz-example/

# STANDARDS_REGISTRY — стандарты которые применяются
standards:
  naming: architect/standards/6-naming/naming-files.md
  structure: architect/standards/structure/
  formats: architect/standards/5-format/

Файлы состояния

project/
├── task.yaml     ← задачи и состояние (человек + AI читают)
└── CACHE.yaml    ← сжатый контекст (только AI пишет/читает)

task.yaml — оперативное состояние:
- current step
- done / next
- decisions

CACHE.yaml — кэш рекурсии:
- compressed context
- key decisions summary
- dependency graph snapshot

Карта документов

Документ Что изменить Статус
system/agents/protocols/PROJECT_PROCESSOR_v8.md Добавить PREPARE + COMPRESS ⏳
system/agents/protocols/PROJECT_PROCESSOR_v8.md Трёхрежимная логика ⏳
architect/standards/structure/ STANDARDS_REGISTRY ⏳

Роадмап

v1.0–v7.x ✅

v8.0 ✅ (2026-01)

v8.1 ⏳ (2026-03-26)

v9.0 (будущее)

Связанные проекты