touchstone

Touchstone establece una base para desarrolladores individuales que dirigen múltiples agentes de IA en proyectos de GitHub. Ofrece dos componentes principales: indicaciones que instruyen a los agentes sobre estándares de flujo de trabajo (ramificación primero, commits de un solo propósito, resolución obligatoria de hallazgos y cumplimiento de puertas), y herramientas de push (una CLI que aplica patrones correctos de uso de GitHub). El sistema estandariza el flujo de desarrollo mediante adopción 'configurar y olvidar', donde los repositorios permanecen correctos sin intervención adicional. La CLI valida comprobaciones declaradas del proyecto, verifica afirmaciones del tracker, aplica política de GitHub y proporciona cuatro operaciones de PR limitadas (abrir, estado, fusionar, responder). Explícitamente no prepara, confirma ni sube código, y nunca reemplaza la decisión de fusión de GitHub. Cada operación incluye rutas de recuperación documentadas con comandos git/gh en bruto. Touchstone opera bajo tres principios: restringir entregas a la rama predeterminada mediante reglas de GitHub (rechazando pushes directos/forzados/sin revisar), hacer el estado legible mediante interfaces nativas de GitHub (git, PRs, issues), y mantener reglas consistentes en todos los proyectos y agentes. Una regla clave exige que la aplicación ocurra en la capa capaz de hacerlo (GitHub gestiona reglas/comprobaciones requeridas, mientras scripts solo observan y secuencian). La puerta de fusión implementa sistema de veredicto exacto en la cabeza: el flujo de revisión solo tiene éxito para veredicto limpio de confianza vinculado a la cabeza actual de la PR. Instalación mediante Homebrew (macOS) o scripts independientes de plataforma. La adopción implica declarar hechos del proyecto y aplicar políticas de GitHub auditadas mediante comandos documentados.