CIFRA Platform - Документация для Claude Code

Проект: CIFRA Low-Code Platform
Тип: Platform / Product (разрабатываемый продукт)
Статус: Active Development
Версия: 2.0.0
Последнее обновление: 2025-11-13

🎯 Что такое CIFRA?

CIFRA - это платформа-конструктор, которая собирает приложения по текстовому описанию.

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

Пользователь пишет
текстовое описание
"Мне нужен интернет-магазин
с корзиной и оплатой"
        ↓
   CIFRA Platform
   (конструктор)
        ↓
Готовое веб-приложение
(код + БД + UI)

Кто что делает?

Platform v1 (workspace management)
        ↓
   МЫ разрабатываем (с помощью Platform v1)
        ↓
CIFRA v2 (конструктор приложений) ← ПРОДУКТ
        ↓
   Пользователи используют CIFRA
        ↓
Пишут текстовое описание
        ↓
CIFRA генерирует готовое приложение

Суть:
- Пользователь НЕ пишет код
- Пользователь пишет ТЕКСТОВОЕ ОПИСАНИЕ на естественном языке
- CIFRA автоматически собирает готовое приложение

📍 Расположение

ВАЖНО: Код CIFRA находится в КОРНЕ workspace:

/opt/claude-workspace/cifra/

Детали: См. projects/cifra/LOCATION.md

📚 Быстрая навигация

Документация проекта

CIFRA Platform (15 документов):
1. cifra/README.md - Точка входа
2. cifra/01_CIFRA_MASTER.md - Главный документ (начать здесь!)
3. cifra/02_CORE_CONCEPTS.md - Ключевые концепции
4. cifra/03_ARCHITECTURE.md - Архитектура
5. cifra/04_LANGUAGE_SPECIFICATION.md - Язык .cifra
6. cifra/05_DATA_LAYER.md - Данные и БД
7. cifra/06_SECURITY.md - Безопасность
8. cifra/07_API_AND_INTEGRATION.md - API
9. cifra/08_UI_AND_THEMES.md - UI и темы
10. cifra/09_MODULES_AND_PLUGINS.md - Модули
11. cifra/10_WORKFLOWS_AND_AUTOMATION.md - Workflows
12. cifra/11_DATA_MANAGEMENT.md - Управление данными
13. cifra/12_DEVELOPER_GUIDE.md - Для разработчиков
14. cifra/13_DEPLOYMENT.md - Развёртывание
15. cifra/14_TESTING_AND_QUALITY.md - Тестирование
16. cifra/15_REFERENCES.md - Справка

Управление проектом:
- projects/cifra/LOCATION.md - Где находится код
- projects/cifra/CLAUDE.md - Этот файл

🏗️ Структура проекта

16 AI Агентов - Как собирается приложение

Процесс сборки приложения по текстовому описанию:

1. Пользователь: "Мне нужен интернет-магазин"
        ↓
2. ORCHESTRATOR - координирует всех агентов
        ↓
3. ARCHITECT - проектирует архитектуру
        ↓
4. DESIGNER - создаёт UI/UX
        ↓
5. DEVELOPER - генерирует код
        ↓
6. TESTER - тестирует приложение
        ↓
7. DEPLOYER - развёртывает
        ↓
   Готовое приложение!

16 AI Агентов в CIFRA:

cifra/agents/
├── orchestrator/    ← МОЗГ: координирует весь процесс сборки
├── architect/       ← Проектирует архитектуру из описания
├── designer/        ← Создаёт UI/UX автоматически
├── developer/       ← Генерирует код приложения
├── tester/          ← Тестирует созданное приложение
├── deployer/        ← Развёртывает готовое приложение
├── documenter/      ← Создаёт документацию
├── security/        ← Проверяет безопасность
├── optimizer/       ← Оптимизирует код и БД
├── monitor/         ← Мониторит работу приложения
├── projector/       ← Планирует этапы разработки
├── administrator/   ← Управляет системой CIFRA
├── editor/          ← Редактирует сгенерированный код
├── logger/          ← Логирует процесс сборки
├── recovery/        ← Восстанавливает при ошибках
└── workspace/       ← Управляет workspace проекта

Каждый агент:
- Получает задачу от orchestrator
- Выполняет свою специализированную роль
- Возвращает результат
- Всё это АВТОМАТИЧЕСКИ, без участия человека

7 Доменов

cifra/domains/
├── 01_design/          ← Проектирование
├── 02_development/     ← Разработка
├── 03_testing/         ← Тестирование
├── 04_deployment/      ← Развёртывание
├── 05_monitoring/      ← Мониторинг
├── 06_workspace/       ← Управление workspace
└── 07_documentation/   ← Документирование

Каждый домен:
- docs/guide.md - Руководство по домену

Протокол интеграции

cifra/shared/
└── INTEGRATION_PROTOCOL.md  ← Как агенты общаются между собой

🎯 Типичные задачи

Работа с документацией CIFRA

# Читаем главный документ
cat /opt/claude-workspace/cifra/01_CIFRA_MASTER.md

# Изучаем архитектуру
cat /opt/claude-workspace/cifra/03_ARCHITECTURE.md

# Смотрим спецификацию языка
cat /opt/claude-workspace/cifra/04_LANGUAGE_SPECIFICATION.md

Работа с агентами

# Изучить агента orchestrator
cat /opt/claude-workspace/cifra/agents/orchestrator/APP.md

# Посмотреть инструкции для AI
cat /opt/claude-workspace/cifra/agents/developer/ai/instructions.md

Работа с доменами

# Изучить домен development
cat /opt/claude-workspace/cifra/domains/02_development/docs/guide.md

🔧 Разработка CIFRA

Как мы разрабатываем CIFRA?

С ПОМОЩЬЮ Platform v1:

1. Запуск Claude Code
   Claude Code → CLAUDE.md (START MENU)

2. Выбор проекта
   Scope: 3. Project Project: cifra Mode: Design / Code / Full

3. Работа
   - Platform v1 управляет контекстом
   - Мы редактируем документацию CIFRA
   - Разрабатываем агентов
   - Создаём домены
   - Пишем спецификации

4. Результат
   - CIFRA становится готовой платформой
   - Которую будут использовать конечные пользователи
   - Для создания своих приложений

📊 Что уже есть?

✅ Готово:
- 15 документов платформы
- 16 AI агентов (структура)
- 7 доменов (структура)
- Протокол интеграции
- Архивы старых версий

🚧 В разработке:
- Детализация работы агентов
- Реализация протокола интеграции
- Примеры использования .cifra
- Тесты платформы
- Deployment guide

📋 Запланировано:
- Полная имплементация агентов
- Runtime для выполнения .cifra кода
- CLI инструменты
- Web IDE
- Документация для конечных пользователей

🔄 Взаимосвязь с другими проектами

Отличие от других проектов workspace

projects/
├── marketplace/           ← APPLICATION (Streamlit)
│   └── Использует: Platform v1 для разработки
│
├── @infra-dev-pro/       ← INFRASTRUCTURE (серверы)
│   └── Использует: Platform v1 для управления
│
├── @infra-dev-prod-rf/   ← INFRASTRUCTURE (серверы)
│   └── Использует: Platform v1 для управления
│
└── cifra/                ← PLATFORM (продукт)
    └── Разрабатываем: С ПОМОЩЬЮ Platform v1
        └── Результат: Новая платформа для пользователей

CIFRA - особенный проект:
- Не просто приложение
- Не просто инфраструктура
- Это ПЛАТФОРМА, которую мы создаём

🎓 Обучение

Для новых разработчиков

Последовательность изучения:

1. Старт
   - Прочитать cifra/README.md
   - Прочитать cifra/01_CIFRA_MASTER.md

2. Концепции
   - cifra/02_CORE_CONCEPTS.md - основы
   - cifra/03_ARCHITECTURE.md - архитектура

3. Язык .cifra
   - cifra/04_LANGUAGE_SPECIFICATION.md - синтаксис
   - Примеры использования

4. Агенты и домены
   - Изучить orchestrator
   - Понять протокол интеграции
   - Пройтись по доменам

5. Практика
   - Создать простое .cifra приложение
   - Протестировать агентов
   - Написать документацию

🛠️ Инструменты разработки

Для работы с CIFRA используем:

• Platform v1 - управление workspace
• Git - версионирование
• Markdown - документация
• YAML - конфигурация
• Python - код агентов (будет)
• JavaScript/TypeScript - Web IDE (будет)

📝 Правила работы

При редактировании документации

1. ✅ Обновлять дату в документе
2. ✅ Следовать структуре 15 документов
3. ✅ Не дублировать информацию
4. ✅ Ссылаться на другие документы
5. ✅ Сохранять старые версии в archive/

При работе с агентами

1. ✅ Каждый агент - отдельная папка
2. ✅ APP.md - описание агента
3. ✅ ai/instructions.md - инструкции для AI
4. ✅ Следовать протоколу интеграции

При работе с доменами

1. ✅ Каждый домен - своя область ответственности
2. ✅ Нет пересечений между доменами
3. ✅ docs/guide.md - полное руководство

🔗 Полезные ссылки

Внутри workspace:
- /opt/claude-workspace/cifra/ - код CIFRA
- /opt/claude-workspace/platform/ - Platform v1 (инструмент)
- projects/cifra/LOCATION.md - где лежит код

Документация Platform v1:
- /opt/claude-workspace/CLAUDE.md - START MENU
- /opt/claude-workspace/README.md - описание workspace
- /opt/claude-workspace/platform/CLAUDE_WORKFLOW.md - логика работы Claude

📊 Статус разработки

Размер проекта: 4.3 MB

Прогресс:
- Документация: 80% (15 документов готовы)
- Агенты: 20% (структура готова, нужна имплементация)
- Домены: 30% (структура + гайды)
- Протокол: 50% (описан, нужно тестирование)
- Runtime: 0% (не начат)
- Тесты: 10% (только концепция)

Команда:
- Claude Code + Platform v1 = инструмент разработки
- Человек = архитектор и владелец продукта

🎯 Следующие шаги

Приоритет #1:
1. Детализировать работу orchestrator агента
2. Реализовать базовый протокол интеграции
3. Создать простой пример .cifra приложения
4. Протестировать взаимодействие агентов

Приоритет #2:
1. Разработать Runtime для .cifra
2. Создать CLI инструменты
3. Начать Web IDE
4. Написать туториалы для пользователей

Приоритет #3:
1. Полная имплементация всех 16 агентов
2. Тестирование всех доменов
3. Deployment на production
4. Публичный релиз

Версия: 1.0
Дата: 2025-11-13
Статус: Active Development
Начать работу: Прочитать cifra/01_CIFRA_MASTER.md