touchstone

O Touchstone estabelece uma base para desenvolvedores solo que dirigem múltiplos agentes de IA em projetos GitHub. Ele oferece dois componentes centrais: prompts de orientação que instruem os agentes sobre padrões de fluxo de trabalho (ramificação primeiro, commits de preocupação única, resolução obrigatória de descobertas e conformidade com portões) e ferramentas de push (uma CLI que impõe padrões corretos de uso do GitHub). O sistema padroniza o fluxo de desenvolvimento através da adoção do tipo 'configure e esqueça', onde os repositórios permanecem corretos sem intervenção adicional. A CLI valida as verificações declaradas do projeto, verifica as reivindicações do rastreador, aplica a política do GitHub e fornece quatro operações limitadas de PR (abrir, status, mesclar, responder). Ela explicitamente não prepara, comita ou envia código, e nunca substitui a decisão de mesclagem do GitHub. Cada operação inclui caminhos de recuperação documentados usando git/gh bruto. O Touchstone opera com três princípios: restringir a entrega ao branch padrão via regras do GitHub (rejeitando pushes diretos/forçados/não revisados), tornar o estado legível através das superfícies nativas do GitHub (git, PRs, issues) e manter regras consistentes em todos os projetos e agentes. Uma regra operacional chave exige que a imposição ocorra na camada que pode realmente impô-la (o GitHub trata de conjuntos de regras/verificações obrigatórias, enquanto os scripts apenas observam e sequenciam). O portão de mesclagem implementa um sistema de veredito de cabeça exata: o fluxo de trabalho review-gate só tem sucesso para um veredito limpo e confiável vinculado à cabeça atual do PR. A instalação ocorre via Homebrew (macOS) ou scripts de lançamento independentes de plataforma. A adoção envolve declarar fatos do projeto e aplicar a política auditada do GitHub através de comandos documentados.