fix: Spec Agent Runtime

specs/en/SPEC-015-Adoption-and-Eligibility-Criteria.md

@@ -0,0 +1,168 @@
+# SPEC-015 — Adoption and Eligibility Criteria
+
+## Agent Platform OCI
+
+Version: 1.0.0
+
+
+---
+
+## Reading guide
+
+each SPEC is organizada for servir tanto como Contract arquitetural quanto como guia practical of adoção.
+
+The document structure is:
+
+1. Concept.
+2. Problem addressed.
+3. When to use.
+4. When not to use.
+5. Architecture.
+6. Implementation.
+7. Examples.
+8. Common errors.
+9. Acceptance criteria.
+
+---
+
+
+# 1. Concept
+
+criteria of adoção definem when a projeto must use a Agent Platform OCI and quais Requirements minimum precisa atender for entrar em Development, homologação and Production.
+
+# 2. Problem addressed
+
+without criteria claros:
+
+- qualquer caso simples vira Agent;
+- projetos without owner entram on the platform;
+- canais entram without Contract;
+- Agents entram without dataset;
+- Production ocorre without evaluator;
+- Operations fica without dashboard/Alert.
+
+# 3. Casos indicados
+
+| Caso | Example |
+| --- | --- |
+| Agents conversational | Atendimento, suporte, backoffice. |
+| Multiagentes | Handoff between domínios. |
+| Agents with tools | Consulta/ação em sistemas. |
+| Agents with RAG | Uso of documentos and Policies. |
+| Ambientes regulados | Necessidade of Governance and auditoria. |
+| Canais corporativos | Web, WhatsApp, Voice, URA, CRM. |
+
+
+# 4. Casos No indicados
+
+| Caso | Motivo |
+| --- | --- |
+| CRUD simples | API REST without IA. |
+| ETL batch | Pipeline of Data. |
+| Job agendado simples | without interação. |
+| service utilitário | Validation/formatação simples. |
+| integration without Decision | Proxy API without raciocínio. |
+
+
+# 5. criteria of Input of negócio
+
+before iniciar:
+
+- business owner;
+- technical owner;
+- objective;
+- Scope;
+- outside of Scope;
+- canais;
+- sistemas;
+- documentos;
+- criteria of success;
+- Risks.
+
+# 6. criteria of Architecture
+
+required:
+
+- GatewayRequest;
+- ChannelResponse;
+- BusinessContext;
+- health/readiness;
+- logs;
+- traces;
+- dataset;
+- evaluator;
+- certification.
+
+# 7. criteria of Security
+
+required:
+
+- Authentication;
+- Authorization;
+- secrets external;
+- máscara of PII;
+- auditoria;
+- Review of Risk.
+
+# 8. criteria of quality
+
+required:
+
+- Tests unitários;
+- Tests of integration;
+- dataset;
+- evaluator;
+- thresholds;
+- certification.
+
+# 9. criteria of Operations
+
+required:
+
+- Metrics;
+- dashboards;
+- Alerts;
+- runbook;
+- rollback;
+- SLO.
+
+# 10. Process of exceção
+
+Exceptions permitidas:
+
+- without RAG;
+- without MCP;
+- without Memory;
+- without handoff;
+- without canal External.
+
+Toda exceção Must record:
+
+```yaml
+exception:
+  reason: "Agente não usa documentos"
+  approved_by: architecture
+  expires_at: 2026-12-31
+```
+
+# 11. Checklist of adoção
+
+- [ ] Business owner definido.
+- [ ] Technical owner definido.
+- [ ] Scope definido.
+- [ ] Casos outside of Scope definidos.
+- [ ] GatewayRequest definido.
+- [ ] BusinessContext definido.
+- [ ] Security definida.
+- [ ] Dataset criado.
+- [ ] Evaluator configured.
+- [ ] Certification planejada.
+- [ ] Observability planejada.
+
+# 12. Acceptance criteria
+
+- [ ] Projeto elegível for plataforma.
+- [ ] Requirements minimum atendidos.
+- [ ] Exceptions documentadas.
+- [ ] Plano of homologação definido.
+- [ ] criteria of Production definidos.