Перестаньте терять контекст. Перестаньте блокироваться на задачах. Перестаньте поставлять баги. Эта проверенная в боях система превращает PRD в эпики, эпики в Gitlab Issues, а задачи в рабочий код - с полной прослеживаемостью на каждом этапе.

• Подоплёка
• Рабочий процесс
• Что делает это особенным?
• Почему Gitlab Issues?
• Основной принцип: Никакого кодинга наобум
• Архитектура системы
• Фазы рабочего процесса
• Справочник команд
• Система параллельного выполнения
• Ключевые особенности и преимущества
• Доказанные результаты
• Пример потока
• Начало работы
• Локально vs Удаленно
• Технические заметки
• Поддержите этот проект

Каждая команда сталкивается с одними и теми же проблемами:

• Контекст испаряется между сессиями, заставляя постоянно переоткрывать заново
• Параллельная работа создает конфликты когда несколько разработчиков работают с одним и тем же кодом
• Требования изменяются когда устные решения перекрывают письменные спецификации
• Прогресс становится невидимым до самого конца

Эта система решает всё это.

graph LR
    A[Создание PRD] --> B[Планирование эпика]
    B --> C[Декомпозиция задач]
    C --> D[Синхронизация с Gitlab]
    D --> E[Параллельное выполнение]

# Создайте комплексный PRD через управляемый мозговой штурм
/pm-prd-new memory-system

# Преобразуйте PRD в технический эпик с разбивкой задач
/pm-prd-parse memory-system

# Отправьте в Gitlab и начните параллельное выполнение
/pm-epic-oneshot memory-system
/pm-issue-start 1235

Большинство рабочих процессов Opencode работают изолированно - один разработчик работает с AI в своей локальной среде. Это создает фундаментальную проблему: AI-помощь в разработке становится изолированной.

Используя Gitlab Issues в качестве нашей базы данных, мы разблокируем что-то мощное:

• Множество экземпляров Claude могут работать над одним проектом одновременно
• Человеческие разработчики видят прогресс AI в реальном времени через комментарии к задачам
• Члены команды могут включиться в любое время - контекст всегда виден
• Менеджеры получают прозрачность без прерывания потока

• AI может начать задачу, человек может закончить (или наоборот)
• Обновления прогресса видны всем, не скрыты в логах чата
• Код-ревью происходит естественно через комментарии к PR
• Никаких "что делал AI?" встреч

• Добавление членов команды без трения при адаптации
• Множество AI агентов работают параллельно над разными задачами
• Распределенные команды остаются синхронизированными автоматически
• Работает с существующими Gitlab рабочими процессами и инструментами

• Нет отдельных баз данных или инструментов управления проектами
• Состояние задачи - это состояние проекта
• Комментарии - это аудиторская цепочка
• Метки обеспечивают организацию

Это не просто система управления проектами - это протокол сотрудничества, который позволяет человеку и AI агентам работать вместе в масштабе, используя инфраструктуру, которой ваша команда уже доверяет.

Каждая строка кода должна быть связана со спецификацией.

Мы следуем строгой 5-фазной дисциплине:

1. 🧠 Мозговой штурм - Думаем глубже, чем комфортно
2. 📝 Документация - Пишем спецификации, которые не оставляют места для интерпретации
3. 📐 Планирование - Проектируем с явными техническими решениями
4. ⚡ Выполнение - Строим точно то, что было указано
5. 📊 Отслеживание - Поддерживаем прозрачный прогресс на каждом этапе

Никаких ярлыков. Никаких предположений. Никаких сожалений.

.opencode/
├── AGENTS.md          # Всегда включенные инструкции (скопируйте содержимое в файл AGENTS.md вашего проекта)
├── agents/            # Ориентированные на задачи агенты (для сохранения контекста)
├── commands/          # Определения команд
│   ├── context/       # Создание, обновление и подготовка контекста
│   ├── pm/            # ← Команды управления проектом (эта система)
│   └── testing/       # Подготовка и выполнение тестов (отредактируйте это)
├── context/           # Файлы контекста для всего проекта
├── epics/             # ← Локальное рабочее пространство PM (разместите в .gitignore)
│   └── [epic-name]/   # Эпик и связанные задачи
│       ├── epic.md    # План реализации
│       ├── [#].md     # Файлы отдельных задач
│       └── updates/   # Обновления в процессе работы
├── prds/              # ← PRD файлы PM
├── rules/             # Разместите здесь любые файлы правил, на которые вы хотите ссылаться
└── scripts/           # Разместите здесь любые файлы скриптов, которые вы хотите использовать

/pm-prd-new feature-name

Запускает комплексный мозговой штурм для создания Документа Требований Продукта, охватывающего видение, пользовательские истории, критерии успеха и ограничения.

Вывод: .opencode/prds/feature-name.md

/pm-prd-parse feature-name

Преобразует PRD в технический план реализации с архитектурными решениями, техническим подходом и маппингом зависимостей.

Вывод: .opencode/epics/feature-name/epic.md

/pm-epic-decompose feature-name

Разбивает эпик на конкретные, выполнимые задачи с критериями приемки, оценками усилий и флагами параллелизации.

Вывод: .opencode/epics/feature-name/[task].md

/pm-epic-sync feature-name
# Или для уверенных рабочих процессов:
/pm-epic-oneshot feature-name

Отправляет эпик и задачи в Gitlab как задачи с соответствующими метками и отношениями.

/pm-issue-start 1234  # Запуск специализированного агента
/pm-issue-sync 1234   # Отправка обновлений прогресса
/pm-next             # Получение следующей приоритетной задачи

Специализированные агенты реализуют задачи, сохраняя обновления прогресса и аудиторскую цепочку.

• /pm-init - Установка зависимостей и настройка Gitlab

• /pm-prd-new - Запуск мозгового штурма для новых требований продукта
• /pm-prd-parse - Преобразование PRD в реализационный эпик
• /pm-prd-list - Список всех PRD
• /pm-prd-edit - Редактирование существующего PRD
• /pm-prd-status - Показ статуса реализации PRD

• /pm-epic-decompose - Разбиение эпика на файлы задач
• /pm-epic-sync - Отправка эпика и задач в Gitlab
• /pm-epic-oneshot - Декомпозиция и синхронизация в одной команде
• /pm-epic-list - Список всех эпиков
• /pm-epic-show - Отображение эпика и его задач
• /pm-epic-close - Пометка эпика как завершенного
• /pm-epic-edit - Редактирование деталей эпика
• /pm-epic-refresh - Обновление прогресса эпика из задач

• /pm-issue-show - Отображение задачи и подзадач
• /pm-issue-status - Проверка статуса задачи
• /pm-issue-start - Начало работы со специализированным агентом
• /pm-issue-sync - Отправка обновлений в Gitlab
• /pm-issue-close - Пометка задачи как завершенной
• /pm-issue-reopen - Переоткрытие закрытой задачи
• /pm-issue-edit - Редактирование деталей задачи

• /pm-next - Показ следующей приоритетной задачи с контекстом эпика
• /pm-status - Общая панель управления проектом
• /pm-standup - Отчет ежедневного стендапа
• /pm-blocked - Показ заблокированных задач
• /pm-in-progress - Список задач в работе

• /pm-sync - Полная двусторонняя синхронизация с Gitlab
• /pm-import - Импорт существующих Gitlab Issues

• /pm-validate - Проверка целостности системы
• /pm-clean - Архивирование завершенной работы
• /pm-search - Поиск по всему содержимому

Традиционное мышление: Одна задача = Один разработчик = Одна задача

Реальность: Одна задача = Множество параллельных потоков работы

Одна задача "Реализовать аутентификацию пользователя" - это не одна задача. Это...

• Агент 1: Таблицы базы данных и миграции
• Агент 2: Слой сервиса и бизнес-логика
• Агент 3: API эндпоинты и middleware
• Агент 4: UI компоненты и формы
• Агент 5: Тестовые наборы и документация

Все работает одновременно в одном worktree.

Традиционный подход:

• Эпик с 3 задачами
• Последовательное выполнение

Эта система:

• Тот же эпик с 3 задачами
• Каждая задача разделяется на ~4 параллельных потока
• 12 агентов работают одновременно

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

Традиционный однопоточный подход:

• Главный разговор несет ВСЕ детали реализации
• Контекстное окно заполняется схемами базы данных, API кодом, UI компонентами
• В конечном итоге достигает пределов контекста и теряет согласованность

Подход с параллельными агентами:

• Главный поток остается чистым и стратегическим
• Каждый агент обрабатывает свой контекст изолированно
• Детали реализации никогда не загрязняют главный разговор
• Главный поток сохраняет обзор без утопания в коде

Ваш главный разговор становится дирижером, а не оркестром.

Что видит Gitlab:

• Чистые, простые задачи
• Обновления прогресса
• Статус завершения

Что происходит на самом деле локально:

• Задача #1234 распадается на 5 параллельных агентов
• Агенты координируются через Git коммиты
• Сложная оркестровка скрыта от взгляда

Gitlab не нужно знать КАК работа была выполнена - важно только то, что она ВЫПОЛНЕНА.

# Анализ того, что можно параллелизировать
/pm-issue-analyze 1234

# Запуск роя
/pm-epic-start memory-system

# Наблюдение за магией
# 12 агентов работают над 3 задачами
# Все в: ../epic-memory-system/

# Одно чистое слияние по завершении
/pm-epic-merge memory-system

Никогда больше не теряйте состояние проекта. Каждый эпик сохраняет свой контекст, агенты читают из .opencode/context/ и обновляются локально перед синхронизацией.

Поставляйте быстрее с множеством агентов, работающих одновременно. Задачи с пометкой parallel: true позволяют конфликтно-свободную параллельную разработку.

Работает с инструментами, которыми ваша команда уже пользуется. Задачи - это источник истины, комментарии обеспечивают историю, и нет зависимости от Projects API.

Правильный инструмент для каждой работы. Разные агенты для UI, API и базы данных. Каждый читает требования и автоматически публикует обновления.

Каждое решение задокументировано. PRD → Эпик → Задача → Issue → Код → Коммит. Полная аудиторская цепочка от идеи до производства.

Сфокусируйтесь на создании, а не на управлении. Интеллектуальный приоритет, автоматическая загрузка контекста и инкрементальная синхронизация по готовности.

Команды, использующие эту систему, сообщают:

• 89% меньше времени, потерянного на переключение контекста - вы будете использовать /compact и /clear намного меньше
• 5-8 параллельных задач вместо 1 ранее - редактирование/тестирование нескольких файлов одновременно
• 75% снижение количества багов - благодаря разбиению функций на детальные задачи
• До 3х раз быстрее поставка функций - в зависимости от размера и сложности функции

# Начать новую функцию
/pm-prd-new memory-system

# Просмотр и доработка PRD...

# Создать план реализации
/pm-prd-parse memory-system

# Просмотр эпика...

# Разбить на задачи и отправить в Gitlab
/pm-epic-oneshot memory-system
# Создает задачи: #1234 (эпик), #1235, #1236 (задачи)

# Начать разработку задачи
/pm-issue-start 1235
# Агент начинает работу, сохраняет локальный прогресс

# Синхронизировать прогресс с Gitlab
/pm-issue-sync 1235
# Обновления публикуются как комментарии к задаче

# Проверить общий статус
/pm-epic-show memory-system

1. Установите этот репозиторий в ваш проект:

   Unix/Linux/macOS

   cd path/to/your/project/
   curl -sSL https://gitlabci.my-org.ru/factoring/sandboxes/opencode-pm/-/raw/main/install/ccpm.sh?ref_type=heads | bash
   # или: wget -qO- https://gitlabci.my-org.ru/factoring/sandboxes/opencode-pm/-/raw/main/install/ccpm.sh?ref_type=heads | bash

   Windows (PowerShell)

   cd path/to/your/project/
   iwr -useb https://gitlabci.my-org.ru/factoring/sandboxes/opencode-pm/-/raw/main/install/ccpm.bat?ref_type=heads | iex

   ⚠️ ВАЖНО: Если у вас уже есть директория .opencode, клонируйте этот репозиторий в другую директорию и скопируйте содержимое клонированной директории .opencode в директорию .opencode вашего проекта.

   Смотрите полные/другие варианты установки в руководстве по установке ›

2. Инициализируйте систему PM:

   /pm-init

   Эта команда выполнит:

   • Установит Gitlab CLI (если необходимо)
   • Аутентифицирует с Gitlab
   • Создаст необходимые директории
   • Обновит .gitignore

3. Создайте AGENTS.md с информацией о вашем репозитории

   /init include rules from .opencode/AGENTS.md

   Если у вас уже есть файл AGENTS.md, выполните: /re-init чтобы обновить его с важными правилами из .opencode/AGENTS.md.

4. Подготовьте систему:

   /context-create

/pm-prd-new your-feature-name

Наблюдайте, как структурированное планирование превращается в рабочий код.

• Возвращается к спискам задач, если расширение не установлено
• Задачи-эпики автоматически отслеживают завершение подзадач
• Метки обеспечивают дополнительную организацию (epic:feature, task:feature)

• Задачи начинаются как 001.md, 002.md во время декомпозиции
• После синхронизации с Gitlab переименовываются в {issue-id}.md (например, 1234.md)
• Упрощает навигацию: задача #1234 = файл 1234.md

• Намеренно избегает сложности Gitlab Projects API
• Все команды сначала работают с локальными файлами для скорости
• Синхронизация с Gitlab явная и контролируемая
• Worktrees обеспечивают чистую git-изоляцию для параллельной работы
• Gitlab Projects могут быть добавлены отдельно для визуализации

Opencode PM был разработан на основе automazeio ccpm для разработчиков, которые поставляют, от разработчиков, которые поставляют.

Если Opencode PM помогает вашей команде поставлять лучшее программное обеспечение:

• ⭐ Поставьте звезду этому репозиторию чтобы показать свою поддержку