revisão e complementação da documentação do projeto

RI/docs/AS-BUILT.en-us.md

@@ -11,10 +11,9 @@ the RI, see [`How-To.md`](How-To.md). For those who will **evaluate/adapt** the
 scenario, see [`Assumptions.md`](Assumptions.md) and
 [`Production-Recommendations.md`](Production-Recommendations.md).
 
-This document succeeds the planning backlog `docs/RI-PLANNING.md` (removed from the repository
+Individual architectural decisions are recorded in [`../../docs/adr/`](../../docs/adr/)
-after the completion of milestone M4, with history preserved in git) — the factual information
+(ADR-001 through ADR-025); the assumptions and reasoning behind them are synthesized in
-from that backlog that is still relevant to whoever uses the finished product was migrated here,
+[`Assumptions.md`](Assumptions.md).
-to `Assumptions.md`, and to `Production-Recommendations.md`.
 
 ## Status
 
@@ -31,8 +30,8 @@ Registry.
 ## Epic index
 
 Every `EP-XX-TXX` that appears in comments/docstrings in the source code references one of these
-epics. This table is what replaces `docs/RI-PLANNING.md` §8.6 as the context source for those
+epics. This table is the authoritative reference for these labels — consult it whenever a
-references.
+comment/docstring cites an `EP-XX-TXX` without further context.
 
 | Epic | Title | Main module/test |
 |---|---|---|
@@ -167,7 +166,7 @@ exchange).
 ### Auditing, correlation and observability (EP-08)
 
 **Responsibility:** `audit/models.py` defines `EventEnvelope` with a 3-category taxonomy adopted
-from the Agent Platform OCI reference (ADR-022): **IC** (Client Interaction/business journey,
+from the Agent Platform OCI reference (ADR-022): **IC** (Control Indicator/business journey,
 e.g. `client_authenticated`, `tool_call_allowed`), **NOC** (operational/availability error, e.g.
 `pdp_unavailable`), **GRL** (guardrail/governance, e.g. `tool_call_denied`,
 `tools_list_filtered`, `bypass_attempt_detected`). Every event recursively sanitizes any key

RI/docs/AS-BUILT.md

@@ -9,10 +9,9 @@ Público-alvo: quem vai **integrar com ou estender** a RI. Para quem vai **rodar
 [`How-To.md`](How-To.md). Para quem vai **avaliar/adaptar** a RI para um cenário real, ver
 [`Assumptions.md`](Assumptions.md) e [`Production-Recommendations.md`](Production-Recommendations.md).
 
-Este documento sucede o backlog de planejamento `docs/RI-PLANNING.md` (removido do
+Decisões arquiteturais individuais estão registradas em [`../../docs/adr/`](../../docs/adr/)
-repositório após a conclusão do marco M4, com histórico preservado no git) — a informação
+(ADR-001 a ADR-025); as premissas e razões por trás delas estão sintetizadas em
-factual desse backlog que ainda é relevante para quem usa o produto acabado foi migrada para
+[`Assumptions.md`](Assumptions.md).
-cá, para `Assumptions.md` e para `Production-Recommendations.md`.
 
 ## Status
 
@@ -29,8 +28,8 @@ real para o Registry.
 ## Índice de épicos
 
 Cada `EP-XX-TXX` que aparece em comentários/docstrings do código-fonte referencia um destes
-épicos. Esta tabela é o que substitui `docs/RI-PLANNING.md` §8.6 como fonte de contexto para
+épicos. Esta tabela é a referência autoritativa para essas siglas — consulte-a sempre que um
-essas referências.
+comentário/docstring citar um `EP-XX-TXX` sem contexto adicional.
 
 | Épico | Título | Módulo/teste principal |
 |---|---|---|
@@ -164,7 +163,7 @@ backend. 7 testes (4 unit com `httpx.MockTransport`, 3 e2e contra Keycloak real,
 ### Auditoria, correlação e observabilidade (EP-08)
 
 **Responsabilidade:** `audit/models.py` define `EventEnvelope` com uma taxonomia de 3 categorias
-adotada da referência Agent Platform OCI (ADR-022): **IC** (Interação de Cliente/negócio-jornada,
+adotada da referência Agent Platform OCI (ADR-022): **IC** (Indicador de Controle/negócio-jornada,
 ex. `client_authenticated`, `tool_call_allowed`), **NOC** (operacional/erro de disponibilidade,
 ex. `pdp_unavailable`), **GRL** (guardrail/governança, ex. `tool_call_denied`,
 `tools_list_filtered`, `bypass_attempt_detected`). Todo evento sanitiza recursivamente qualquer

RI/docs/interfaces/audit-events.en-us.md

@@ -48,7 +48,7 @@ rather than a taxonomy of its own:
 
 | Category | Meaning | `event_type` examples |
 |---|---|---|
-| `ic` | Customer Interaction / business journey — the call progressed normally | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
+| `ic` | Control Indicator / business journey — the call progressed normally | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
 | `noc` | Operational/error — an availability failure, not a policy decision | `pdp_unavailable`, `backend_credential_unavailable` |
 | `grl` | Guardrail/governance — an entitlement/policy boundary was applied or tested | `tool_call_denied`, `tools_list_filtered`, `tool_call_require_approval`, `approval_granted`, `bypass_attempt_detected`, `journey_ended_after_denial` |
 

RI/docs/interfaces/audit-events.md

@@ -48,7 +48,7 @@ em vez de uma taxonomia própria:
 
 | Categoria | Significado | Exemplos de `event_type` |
 |---|---|---|
-| `ic` | Interação de Cliente / negócio-jornada — a chamada progrediu normalmente | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
+| `ic` | Indicador de Controle / negócio-jornada — a chamada progrediu normalmente | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
 | `noc` | Operacional/erro — falha de disponibilidade, não uma decisão de política | `pdp_unavailable`, `backend_credential_unavailable` |
 | `grl` | Guardrail/governança — uma fronteira de entitlement/política foi aplicada ou testada | `tool_call_denied`, `tools_list_filtered`, `tool_call_require_approval`, `approval_granted`, `bypass_attempt_detected`, `journey_ended_after_denial` |
 

RI/services/example_mcp_servers/sales_domain/server.py

@@ -3,9 +3,9 @@
 Read-only tools (risk tier R1, see README.md §17): customer.search,
 customer.get, order.get, inventory.check. Write tools (R2): quote.create,
 quote.update. Backed by static mock data -- this server is deliberately
-"dumb": it never authorizes anything (see `docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md`).
+"dumb": it never authorizes anything (see
-Authorization happens exclusively upstream, in the Gateway/PEP (EP-05)
+`docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md`). Authorization happens
-before a call ever reaches this process.
+exclusively upstream, in the Gateway/PEP (EP-05) before a call ever reaches this process.
 
 Run directly for local development:
 

RI/src/emcp_bus/audit/models.py

@@ -3,7 +3,7 @@
 Adopts the IC/NOC/GRL taxonomy from the Agent Platform OCI reference
 (ADR-022, docs/research/hoshikawa-agent-platform-oci.md) as the
 `EventEnvelope.category` classification, rather than inventing a parallel
-one: IC (Interação de Cliente/negócio-jornada), NOC (operacional/erro), GRL
+one: IC (Indicador de Controle/negócio-jornada), NOC (operacional/erro), GRL
 (guardrail/governança). `decision_id`/`policy_decision_id`/`entitlement_version`
 (ADR-017, EP-08-T03) travel as first-class correlation fields on every event,
 not as opaque payload keys, so a consumer can join events across the chain
@@ -27,7 +27,7 @@ class EventCategory(StrEnum):
     """README.md §27 event classes, mapped onto the Hoshikawa IC/NOC/GRL vocabulary."""
 
     IC = "ic"
-    """Interação de Cliente / negócio-jornada: the call progressed normally
+    """Indicador de Controle / negócio-jornada: the call progressed normally
     (e.g. `client_authenticated`, `tool_call_allowed`)."""
 
     NOC = "noc"

docs/adr/ADR-001-teto-de-privilegio-do-agente.md

@@ -1,7 +1,7 @@
 # ADR-001: Fronteira de MaximumEntitlement no MCP Client
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-002-enforcement-no-gateway.md

@@ -1,7 +1,7 @@
 # ADR-002: MCP Gateway como PEP unico
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-003-reautorizacao-de-tools-call.md

@@ -1,7 +1,7 @@
 # ADR-003: Reautorizacao independente em tools/call
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-004-contexto-nunca-eleva-privilegio.md

@@ -1,7 +1,7 @@
 # ADR-004: Contexto agentico nunca eleva privilegio
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-005-cache-privado-de-tools-list.md

@@ -1,7 +1,7 @@
 # ADR-005: Cache privado de tools/list
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-006-sem-token-passthrough.md

@@ -1,7 +1,7 @@
 # ADR-006: Proibicao de token passthrough
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-007-backend-nao-exposto-diretamente.md

@@ -1,7 +1,7 @@
 # ADR-007: Backend nunca exposto diretamente ao client
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-008-segmentacao-por-dominio-e-risco.md

@@ -1,7 +1,7 @@
 # ADR-008: Segmentacao de clients por dominio e risk tier
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-009-risk-tiers-de-capabilities.md

@@ -1,7 +1,7 @@
 # ADR-009: Risk tiers R0-R4 para capabilities
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-010-governanca-do-registry.md

@@ -1,7 +1,7 @@
 # ADR-010: Governanca do Global Capability Registry
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-011-pipeline-de-publicacao.md

@@ -1,7 +1,7 @@
 # ADR-011: Pipeline obrigatorio de publicacao de capabilities
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-012-entitlement-manager-como-autoridade.md

@@ -1,7 +1,7 @@
 # ADR-012: Entitlement Manager como autoridade unica de MaximumEntitlement
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-013-contrato-de-profile-intelligence.md

@@ -1,7 +1,7 @@
 # ADR-013: Contrato plugavel de Profile Intelligence
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-014-perfil-nunca-amplia-entitlement.md

@@ -1,7 +1,7 @@
 # ADR-014: Perfil nunca amplia entitlement
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-015-nba-nao-e-autorizacao.md

@@ -1,7 +1,7 @@
 # ADR-015: NBA como decisao de orquestracao, nao de autorizacao
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-016-contrato-de-dispatch-handoff.md

@@ -1,7 +1,7 @@
 # ADR-016: Contrato de dispatch/handoff do Agent Runtime
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-017-correlacao-ponta-a-ponta.md

@@ -1,7 +1,7 @@
 # ADR-017: Correlacao ponta a ponta via IDs versionados
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-018-stack-de-implementacao.md

@@ -1,7 +1,7 @@
 # ADR-018: Stack de implementacao da RI
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-019-identity-extension.md

@@ -1,10 +1,9 @@
 # ADR-019: MCP Client identity -- production extension point (mTLS / workload identity)
 
 **Status:** Documented (spike), not implemented in the RI (EP-01-T04, `could`).
-**Related:** this ADR is the canonical record of this decision -- no longer generated from
+**Related:** this ADR is the canonical record of this decision. See `RI/docs/AS-BUILT.md` and
-`docs/RI-PLANNING.md` (removed from the repository after M4 completed; history preserved in
+`RI/docs/interfaces/identity-oidc.md` for implementation and validation context. Also relevant:
-git). See `RI/docs/AS-BUILT.md` and `RI/docs/interfaces/identity-oidc.md` for implementation and
+README.md §19, RF-02, Axiom 2.
-validation context. Also relevant: README.md §19, RF-02, Axiom 2.
 
 ## Context
 

docs/adr/ADR-020-downstream-identity.md

@@ -1,7 +1,7 @@
 # ADR-020: Downstream identity: token exchange ou service account isolado
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-021-escopo-langgraph-langfuse.md

@@ -1,7 +1,7 @@
 # ADR-021: Escopo de LangGraph e Langfuse na RI
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-022-referencia-hoshikawa-agent-platform-oci.md

@@ -1,7 +1,7 @@
 # ADR-022: Referencia operacional: Agent Platform OCI (Hoshikawa)
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md

@@ -1,7 +1,7 @@
 # ADR-023: Autorizacao de tools nunca vem de campo declarado no payload
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-024-posicionamento-multiagente.md

@@ -1,7 +1,7 @@
 # ADR-024: Posicionamento do E-MCP-BUS frente a plataformas multiagente externas
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto
 

docs/adr/ADR-025-engine-do-pdp.md

@@ -1,7 +1,7 @@
 # ADR-025: OPA/Rego como engine do PDP
 
 **Status:** Aceito.
-**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
+**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`.
 
 ## Contexto