beats-pm-kit

OfficeBeats의 Beats PM Kit은 로컬 우선, 크로스 런타임 하네스로, 회의, 채팅, 이메일, 문서, 노트 등 산재한 제품 관리 컨텍스트를 평문 Markdown으로 로컬에 아카이빙하고, 검색 가능하게 만들며, 이를 AI 에이전트가 실행할 수 있는 워크스트림과 작업으로 변환합니다. README에 따르면, 이 키트 자체는 아무것도 업로드하지 않습니다. 구조와 개념 이 키트는 0. Incoming, 1. Company, 2. Products, 3. Meetings, 4. People, 5. Trackers, 6. Resources, 6. SOPs, 7. Partners, 8. Clients 등의 번호가 매겨진 볼트 분류 체계를 사용합니다. 여기에 .agent/는 표준 에이전트, 규칙, 스킬, 템플릿, 워크플로우를, system/은 스크립트, 테스트, 문서를 포함합니다. 표준 작업 상태는 5. Trackers/tasks/에 인간이 읽을 수 있는 Markdown 노트로 저장되며, TASK_MASTER.md와 워크스트림 노트는 이러한 파일을 기반으로 생성된 탐색 도구입니다. 단일 진실 원천 .agent/command-registry.json은 라우팅, 별칭, 실행 프로필, 런타임 정책을 관리하며, .agent/workflows/는 워크플로우 동작을, .agent/skills/는 재사용 가능한 PM 메서드를 관리합니다. 루트 어댑터 파일(AGENTS.md, CLAUDE.md, GEMINI.md, CODEX_COMMANDS.md), .omp/config.yml, 도구 무시 파일은 system/scripts/sync_cli_adapters.py에 의해 생성된 뷰로, 편집은 .agent/를 수정하고 재생성하는 방식으로 이루어집니다. 명령어와 컨텍스트 각 슬래시 명령어는 레지스트리를 통해 하나의 워크플로우 파일과 하나의 실행 프로필(Fast, Balanced, Deep)로 매핑되며, 런타임별 승격 수준(promoted, guarded, dispatch-only)을 갖습니다. 실행 루프는 라우팅, 제한된 컨텍스트 로드, 도구 사용, 체크포인트, 검증, 아티팩트 저장으로 구성되며, 초기 검색은 제한되고 원본 증거는 로컬에서 해시 주소로 관리됩니다. 지원되는 런타임 omp, Claude Code, OpenAI Codex CLI, Google Antigravity, Gemini CLI, GitHub Copilot, 그리고 선택적 Obsidian UI가 지원됩니다. 동작은 감지된 기능에 따라 선택되며, 모델 기본값은 런타임에서 상속되고, 알 수 없는 기능은 실패합니다. 시작하기와 워크플로우 설치는 git clone 후 ./install.sh를 실행하며, 이는 python3 system/scripts/bootstrap.py --agent --non-interactive를 래핑합니다. 부트스트랩은 저장소를 검증하고, 업그레이드 호환성 검사를 수행하며, 무시된 로컬 작업 공간 폴더를 생성하고, 템플릿을 시드하며, 런타임 어댑터를 동기화하고, 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)으로 그룹화됩니다. 자연어 입력도 지원됩니다. 로컬 유틸리티 반복적인 작업은 system/scripts/의 stdlib-only Python 스크립트로 위임됩니다. 여기에는 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(선택적 기능 활성화), upgrade_compat.py(마이그레이션), privacy_guard.py 및 adapter_guard.py(개인 정보 및 어댑터 보호)가 포함됩니다. 개인 정보 및 테스트 개인 정보는 로컬 우선으로, 개인 볼트 폴더는 gitignore되고 .gitkeep 파일로만 추적되며, 로컬 런타임 상태는 .beats/에 저장됩니다. 가드 스크립트는 개인 정보 유출과 어댑터 드리프트를 차단합니다. WATCHDOG.md는 조작된 인용문 금지, 명시적 사용자 승인, 표준 트래커 사용 등의 규칙을 정의합니다. 테스트는 system/tests/에 pytest 스타일로 존재하며, 레지스트리, 어댑터, 작업 저장소, 회의록 파이프라인, 가드, 호환성, 볼트 불변성을 다룹니다. 크레딧 Beats PM Kit은 일상적인 제품 작업에서 구축되었으며, MIT 라이선스의 i-have-adhd 프로젝트에서 영감을 받은 독립적인 출력 정책을 사용합니다.