Ressonância com o Arcogi Handbook

O Handbook e o Public Method possuem funções diferentes.

HANDBOOK
princípios · fundamentos · conceitos · rationale

ADAPT PUBLIC METHOD
práticas · papéis · artefatos · gates · critérios · exemplos

ADAPT LICENSED EXECUTION
agentes · skills · workflows · validators · evals · automações

Regra de ressonância

Cada princípio público relevante deve possuir pelo menos uma expressão operacional no método: prática, artefato, gate, métrica, papel ou controle. Cada elemento metodológico deve apontar para um princípio ou problema reconhecido, evitando componentes órfãos.

Crosswalk

O repositório inclui src/data/handbook-crosswalk.yaml e um template público. O crosswalk registra:

• princípio e seção do handbook;
• fase e módulo do método;
• práticas relacionadas;
• artefatos e gates;
• métrica ou sinal;
• fronteira pública, licenciada e interna;
• status de implementação.

Disciplina de mudanças

Uma mudança de handbook pode exigir revisão do método. Uma mudança metodológica que altera interpretação de um princípio deve abrir proposta de conformance. O crosswalk é versionado junto com a release pública.

Limite da versão 0.1

Os IDs atuais do crosswalk são candidatos públicos. Antes de declarar conformidade canônica, precisam ser reconciliados com a versão ratificada do Handbook. A documentação já está estruturada para essa reconciliação, mas não deve inventar correspondência normativa inexistente.

Resultado esperado

A ressonância evita quatro falhas:

1. o Handbook prometer algo que o método não operacionaliza;
2. o método introduzir práticas sem fundamento;
3. o framework executável automatizar controles não documentados;
4. a oferta comercial vender resultado incompatível com a operação.