type: index
aspect: guidance
title: "Руководства — Интегрированные инструкции"
version: 1.0.0
date: 2026-02-19

Руководства — Интегрированные инструкции

Комплексные руководства для агентов, инструментов и бизнес-процессов.

СОДЕРЖАНИЕ

Интегрированные руководства

Роли агентов

Инструменты

Рабочие процессы (workflows)

НАЗНАЧЕНИЕ

Руководства отвечают на вопрос "КАК РАБОТАТЬ В КОМПЛЕКСЕ?"

Этот аспект определяет:
- Как работать с агентами и ролями
- Как использовать инструменты
- Как выполнять бизнес-процессы
- Как интегрировать разные части платформы

КЛЮЧЕВЫЕ КОНЦЕПЦИИ

1. Руководство vs Стандарт

2. Уровни руководств

ИНТЕГРИРОВАННЫЕ РУКОВОДСТВА
    ↓ (объединяют)
РОЛИ АГЕНТОВ
    ↓ (используют)
ИНСТРУМЕНТЫ
    ↓ (реализуют)
РАБОЧИЕ ПРОЦЕССЫ

Примеры:
- Интегрированное: ../arh/guidance-project-management.md — весь цикл проекта
- Роль: roles/projector.md — роль Проектора в проектах
- Инструмент: tools/claude-code-modes.md — режимы работы
- Workflow: ../arh/it-projects.md — процесс IT-проекта

3. Фрактальность

Руководства применяют фрактальный подход:

Паттерн на уровне ПЛАТФОРМЫ
    ↓ (применяется к)
Паттерн на уровне ПРОЕКТА
    ↓ (применяется к)
Паттерн на уровне МОДУЛЯ

Подробнее: guidance-fractal-architecture.md

КАТЕГОРИИ РУКОВОДСТВ

Интегрированные руководства

Комплексные инструкции:
1. Fractal Architecture — фрактальная архитектура платформы
2. Infra Bot — инфраструктурный бот и автоматизация
3. Project Management — управление проектами от идеи до релиза

Применение:

1. Определить тип задачи (архитектура/инфра/проект)
2. Прочитать соответствующее руководство
3. Применить паттерны и стандарты
4. Следовать чеклистам

Роли агентов

Специализации AI-агентов:
1. Architect — методология, стандарты, теория
2. Coder — разработка, тестирование, код
3. Infra — серверы, деплой, мониторинг
4. Projector — проекты, фичи, координация
5. Terminal — CLI интерфейс, команды

Применение:

1. Определить текущую роль (по триггеру/контексту)
2. Прочитать roles/{role}.md
3. Следовать протоколу роли
4. Использовать инструменты роли

Инструменты

Специализированные инструменты:
1. Claude Code Modes — режимы работы (plan/code/review)
2. Documentation Tomography — анализ документации

Применение:

1. Выбрать инструмент для задачи
2. Прочитать tools/{tool}.md
3. Настроить параметры
4. Выполнить с инструментом

Рабочие процессы

Бизнес-процессы:
1. Business-IT Boundary — граница бизнес/IT
2. IT Projects — жизненный цикл IT-проекта
3. IT Solution Development — разработка решений
4. Project Creation System — система создания проектов

Применение:

1. Определить тип процесса
2. Прочитать workflows/{workflow}.md
3. Следовать этапам workflow
4. Проверить чеклисты

СВЯЗАННЫЕ АСПЕКТЫ

ПРИМЕНЕНИЕ

Создание нового проекта

1. Определить тип: ../arh/it-projects.md
2. Выбрать роль: roles/projector.md
3. Следовать процессу: ../arh/guidance-project-management.md
4. Использовать инструменты: tools/claude-code-modes.md

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

1. Определить роль: roles/README.md — выбрать агента
2. Прочитать роль: roles/{role}.md — понять ответственность
3. Следовать протоколу: Применить правила роли
4. Использовать инструменты: Инструменты роли

Инфраструктурные задачи

1. Прочитать руководство: guidance-infra-bot.md
2. Выбрать роль: roles/infra.md
3. Следовать стандартам: Применить политики безопасности
4. Автоматизация: Использовать бота

АВТОМАТИЗАЦИЯ

Чеклисты в руководствах

Каждое руководство включает чеклисты:

## ЧЕКЛИСТ

- [ ] Определить тип проекта
- [ ] Выбрать роль
- [ ] Прочитать стандарты
- [ ] Применить паттерны
- [ ] Проверить результат

Интеграция с CI/CD

Руководства могут быть автоматизированы:

# .github/workflows/guidance.yml
name: Apply Guidance

on: [workflow_dispatch]

jobs:
  project-creation:
    steps:
      - name: Read guidance
        run: cat 9-guidance/../arh/project-creation-system.md

      - name: Execute checklist
        run: ./scripts/apply_guidance.sh

МОНИТОРИНГ ПРИМЕНЕНИЯ

Метрики

Дашборд

ПРИМЕНЕНИЕ РУКОВОДСТВ:
┌─────────────────────────────────────┐
│ Проекты (по guidance):  ████████░░ 8/10 │
│ Инфра (автоматизация):  ███████░░░ 7/10 │
│ Роли (протокол):        █████████░ 9/10 │
└─────────────────────────────────────┘

СТАТИСТИКА

Файлов в 9-guidance/: 15 (14 руководств + 1 README)

Охват:
- ✅ Интегрированные руководства (3)
- ✅ Роли агентов (5)
- ✅ Инструменты (2)
- ✅ Рабочие процессы (4)

Статус: ФАЗА 9 завершена ✅

CHANGELOG

2026-02-19 — v1.0.0

• Применён стандарт именования: guidance-[object].md для корневых файлов
• Переименованы 14 файлов (3 root + 5 roles + 2 tools + 4 workflows)
• Создан README с группировкой по категориям
• Итого: 14 руководств + 1 README = 15 файлов

Версия: 1.0.0
Дата: 2026-02-19
Владелец: architect