beats-pm-kit

Beats PM Kit (el arnés de PM agente de Beats) es un proyecto de OfficeBeats que empaqueta un arnés local-first y multiplataforma para flujos de trabajo de gestión de productos respaldados por evidencia. Archiva el contexto disperso del producto — reuniones, hilos de chat, correos electrónicos, documentos y notas — como Markdown puro localmente, lo hace buscable y lo triangula en flujos de trabajo y tareas que un agente de IA puede ejecutar. El README afirma que el kit en sí no sube nada. Estructura y conceptos El kit utiliza una taxonomía de almacén numerado: 0. Entrada, 1. Compañía, 2. Productos, 3. Reuniones, 4. Personas, 5. Rastreadores, 6. Recursos, 6. SOPs, 7. Socios, 8. Clientes, más .agent/ para agentes canónicos, reglas, habilidades, plantillas y flujos de trabajo, y system/ para scripts, pruebas y docs. El estado canónico de las tareas reside en 5. Trackers/tasks/ como notas de Markdown legibles por humanos con IDs estables, enlaces de evidencia, progreso y decisiones; TASK_MASTER.md y las notas de flujo de trabajo se describen como navegación generada sobre esos archivos, no como una segunda fuente de verdad. Fuente única de verdad .agent/command-registry.json posee el enrutamiento, los alias, los perfiles de ejecución y la política de runtime; .agent/workflows/ posee el comportamiento del flujo de trabajo; .agent/skills/ posee métodos de PM reutilizables. Los archivos de adaptador raíz (AGENTS.md, CLAUDE.md, GEMINI.md, CODEX_COMMANDS.md), .omp/config.yml y los archivos de ignoración de herramientas son vistas generadas producidas por system/scripts/sync_cli_adapters.py — editar .agent/ y regenerar es la vía prevista, ya que los archivos generados editados a mano son sobrescritos por diseño. Comandos y contexto Cada comando de barra se resuelve a través del registro en un archivo de flujo de trabajo y un perfil de ejecución (Rápido, Balanceado o Profundo), y lleva un nivel de promoción por runtime: los comandos promovidos se envían como habilidades nativas, los comandos protegidos requieren confirmación, y el resto son solo de despacho. El bucle de ejecución documentado es enrutar, cargar contexto limitado, actuar con herramientas, hacer checkpoint, verificar, persistir artefacto; la recuperación inicial está limitada y la evidencia bruta permanece direccionable por hash localmente, con contexto compactado trazable de vuelta a los archivos fuente. Runtimes compatibles Se enumeran puntos de entrada para omp, Claude Code, OpenAI Codex CLI, Google Antigravity, Gemini CLI, GitHub Copilot, y una UI de Obsidian opcional sobre el mismo almacén. El README dice que el comportamiento se selecciona por capacidades detectadas positivamente en lugar de una jerarquía de proveedores, los valores predeterminados del modelo se heredan del runtime, y las capacidades desconocidas fallan de forma cerrada. Empezando y flujos de trabajo La configuración es un git clone más ./install.sh, un envoltorio delgado alrededor de python3 system/scripts/bootstrap.py --agent --non-interactive. Bootstrap verifica el repositorio, ejecuta una puerta de compatibilidad de actualización en los espacios de trabajo existentes, crea carpetas de espacio de trabajo local ignoradas, siembra plantillas, sincroniza adaptadores de runtime, instala ganchos de git cuando es posible, y ejecuta verificaciones de privacidad y salud del adaptador. Los usuarios luego abren la carpeta en un runtime y ejecutan /start o /help. Los flujos de trabajo se agrupan en entrada y evidencia (/paste, /find, /memory, /context, /chat e integraciones de mensajería), reuniones (/meet, /transcript, /prep, /boss), planificación y estrategia (/plan, /create, /deck, /discover, /interview, /intel, /prioritize, /sprint, /retro), seguimiento (/track, /day, /week, /handoff), comunicación y documentos (/sop, /office-cli, /review, /challenge, /improve-plan), calidad y mantenimiento (/accuracy, /regression, /build, /vibe, /maintain, /update, /vacuum, /archive) y configuración/orquestación (/start, /help, /obsidian, /pack, /team, /fan-out). También se admite la entrada de lenguaje natural. Utilidades locales El trabajo repetible se delega a scripts de Python solo con stdlib en system/scripts/, incluyendo vault_query.py para consultas de solo lectura limitadas sobre tareas, etiquetas y citas; context_router.py para la recuperación de texto completo indexado a través de carpetas de evidencia local; task_store.py y task_intake_fast.py para escrituras canónicas de notas de tareas e ingesta rápida; transcript_pipeline.py para preparar, validar y procesar transcripciones de reuniones; pm_decision_router.py para clasificar la entrada desordenada de PM antes de la ejecución; obsidian_bridge.py para usar la carpeta del kit como un almacén de Obsidian; pack_manager.py para habilitar capacidades opcionales inactivas como Trello; upgrade_compat.py para preflight y migración reversible de configuraciones heredadas; y privacy_guard.py / adapter_guard.py para bloquear fugas de contenido privado y deriva del adaptador generado. Privacidad y pruebas La postura de privacidad es local-first: las carpetas personales del almacén están ignoradas por git y rastreadas solo a través de archivos de esqueleto .gitkeep, con el estado del runtime local en un .beats/ ignorado. Los scripts de guardia (privacy_guard.py --tree, adapter_guard.py --mode check) bloquean el contenido privado, las rutas personales, las cadenas similares a tokens, las transcripciones y la deriva del adaptador de los commits compartidos. WATCHDOG.md define reglas de asesoramiento como no fabricar citas, IDs o fechas, aprobación explícita del usuario para envíos salientes, y mantener el estado de las tareas en rastreadores canónicos. El README añade la advertencia de que el kit nunca sincroniza archivos con un servicio en la nube, pero el runtime de IA elegido procesa los prompts y las salidas de las herramientas bajo la configuración de ese proveedor. Créditos Beats PM Kit está construido a partir del trabajo diario de gestión de productos; la política de salida de acción-primero se describe como un enfoque redactado de forma independiente inspirado en el proyecto i-have-adhd con licencia MIT, sin ningún plugin o código de gancho upstream incluido.