beats-pm-kit

Beats PM Kit (агентная среда Beats для управления продуктами) — это проект OfficeBeats, упаковывающий локальную, кросс-платформенную среду для рабочих процессов управления продуктами, основанных на доказательствах. Он архивирует разрозненный контекст продукта — встречи, чаты, электронные письма, документы и заметки — в виде простого Markdown локально, делает его доступным для поиска и преобразует в рабочие потоки и задачи, с которыми может работать агент AI. В README указано, что сам набор не загружает ничего на сервер. Структура и концепции Набор использует пронумерованную таксономию хранилища: 0. Входящие, 1. Компания, 2. Продукты, 3. Встречи, 4. Люди, 5. Трекеры, 6. Ресурсы, 6. SOP, 7. Партнеры, 8. Клиенты, плюс .agent/ для канонических агентов, правил, навыков, шаблонов и рабочих процессов, и system/ для скриптов, тестов и документации. Каноническое состояние задач хранится в 5. Trackers/tasks/ в виде читаемых человеком заметок Markdown со стабильными ID, ссылками на доказательства, прогрессом и решениями; TASK_MASTER.md и заметки рабочих потоков описаны как сгенерированная навигация по этим файлам, а не второй источник истины. Единый источник истины .agent/command-registry.json отвечает за маршрутизацию, псевдонимы, профили выполнения и политику платформы; .agent/workflows/ содержит поведение рабочих процессов; .agent/skills/ содержит многоразовые методы управления продуктами. Корневые файлы адаптеров (AGENTS.md, CLAUDE.md, GEMINI.md, CODEX_COMMANDS.md), .omp/config.yml и файлы игнорирования инструментов являются сгенерированными представлениями, созданными system/scripts/sync_cli_adapters.py — редактирование .agent/ и перегенерация является предполагаемым путем, поскольку вручную отредактированные сгенерированные файлы перезаписываются по дизайну. Команды и контекст Каждая команда слэша проходит через реестр к одному файлу рабочего процесса и одному профилю выполнения (Быстрый, Сбалансированный или Глубокий), и имеет уровень продвижения для каждой платформы: продвинутые команды поставляются как родные навыки, защищенные команды требуют подтверждения, а остальные используются только для отправки. Описанный цикл выполнения включает маршрутизацию, загрузку ограниченного контекста, выполнение действий с инструментами, контрольную точку, проверку и сохранение артефакта; начальное извлечение ограничено, а сырые доказательства остаются локально адресуемыми по хэшу, с уплотненным контекстом, отслеживаемым до исходных файлов. Поддерживаемые платформы Точки входа перечислены для omp, Claude Code, OpenAI Codex CLI, Google Antigravity, Gemini CLI, GitHub Copilot и опционального UI Obsidian над тем же хранилищем. В README говорится, что поведение выбирается по положительно обнаруженным возможностям, а не по иерархии поставщиков, настройки модели наследуются от платформы, а неизвестные возможности приводят к отказу. Начало работы и рабочие процессы Настройка представляет собой клонирование git плюс ./install.sh, тонкую обертку вокруг python3 system/scripts/bootstrap.py --agent --non-interactive. Bootstrap проверяет репозиторий, запускает проверку совместимости при обновлении на существующих рабочих пространствах, создает игнорируемые локальные папки рабочих пространств, заполняет шаблоны, синхронизирует адаптеры платформ, устанавливает git-хуки при возможности и запускает проверки конфиденциальности и здоровья адаптеров. Затем пользователи открывают папку на платформе и запускают /start или /help. Рабочие процессы сгруппированы на прием и доказательства (/paste, /find, /memory, /context, /chat и интеграции с сообщениями), встречи (/meet, /transcript, /prep, /boss), планирование и стратегию (/plan, /create, /deck, /discover, /interview, /intel, /prioritize, /sprint, /retro), отслеживание (/track, /day, /week, /handoff), коммуникации и документы (/sop, /office-cli, /review, /challenge, /improve-plan), качество и обслуживание (/accuracy, /regression, /build, /vibe, /maintain, /update, /vacuum, /archive) и настройку/оркестрацию (/start, /help, /obsidian, /pack, /team, /fan-out). Также поддерживается ввод на естественном языке. Локальные утилиты Повторяемая работа делегируется скриптам Python только со стандартной библиотекой в system/scripts/, включая vault_query.py для ограниченных запросов только на чтение по задачам, меткам и цитатам; context_router.py для индексированного полнотекстового поиска по локальным папкам с доказательствами; task_store.py и task_intake_fast.py для записи канонических заметок о задачах и быстрого приема; transcript_pipeline.py для подготовки, проверки и обработки стенограмм встреч; pm_decision_router.py для классификации нечеткого ввода PM перед выполнением; obsidian_bridge.py для использования папки набора в качестве хранилища Obsidian; pack_manager.py для включения неактивных опциональных возможностей, таких как Trello; upgrade_compat.py для предварительной проверки и обратимой миграции устаревших конфигураций; и privacy_guard.py / adapter_guard.py для блокировки утечки приватного контента и дрейфа сгенерированных адаптеров. Конфиденциальность и тестирование Позиция по конфиденциальности — локальная: личные папки хранилища игнорируются git и отслеживаются только через скелетные файлы .gitkeep, с локальным состоянием платформы в игнорируемой .beats/. Скрипты защиты (privacy_guard.py --tree, adapter_guard.py --mode check) блокируют приватный контент, личные пути, строки, похожие на токены, стенограммы и дрейф адаптеров, от общих коммитов. WATCHDOG.md определяет правила советника, такие как отсутствие выдуманных цитат, ID или дат, явное одобрение пользователя для отправки наружу и хранение состояния задач в канонических трекерах. В README добавляется оговорка, что сам набор не синхронизирует файлы с облачным сервисом, но выбранная платформа AI обрабатывает подсказки и выходы инструментов по собственным настройкам этого поставщика. Тесты находятся в system/tests/ в стиле pytest и покрывают реестр, адаптеры, хранилище задач, конвейер стенограмм, защиту конфиденциальности и адаптеров, совместимость при обновлении и инварианты хранилища. Благодарности Beats PM Kit построен на основе ежедневной работы по продукту; политика вывода с приоритетом действий описана как самостоятельно сформулированный подход, вдохновленный проектом i-have-adhd с лицензией MIT, без включенных плагинов или хуков upstream.