From 24c02f52b0fb538d3369d7f0d90fe396e8b02d53 Mon Sep 17 00:00:00 2001
From: Rodrigo Patote <47055922+patote85@users.noreply.github.com>
Date: Thu, 24 Sep 2026 07:58:12 -0300
Subject: [PATCH 1/3] agent-friendly L2-3: honest CONTRIBUTING (make
 verify/check)

---
 CONTRIBUTING.md | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0d1bf0b..98dfa29 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,7 +1,17 @@
 # Contributing
 
-1. Crie branch feature/nome
-2. Faça commits claros
-3. Abra PR para main
+## Local checks
 
-Gerado por Grok Capitão.
\ No newline at end of file
+```bash
+pip install -r requirements.txt -r requirements-dev.txt
+pip install -r cdk/requirements.txt   # for synth
+make verify   # HTTP contracts (prove-it-works)
+make check    # lint + typecheck + all tests + cdk synth (no deploy)
+```
+
+## Pull requests
+
+1. Branch from `main`.
+2. Keep PRs small and focused.
+3. CI must be green (`lint`, `test`, `verify`, `synth`) before merge.
+4. No deploy from CI; production deploy requires CAB.

From 6a265f314b9ee2e4f971f8e61bcf32a3d675a18c Mon Sep 17 00:00:00 2001
From: Rodrigo Patote <47055922+patote85@users.noreply.github.com>
Date: Thu, 24 Sep 2026 07:58:18 -0300
Subject: [PATCH 2/3] agent-friendly L2-3: delete AI_GENERATION.md

---
 AI_GENERATION.md | 7 -------
 1 file changed, 7 deletions(-)
 delete mode 100644 AI_GENERATION.md

diff --git a/AI_GENERATION.md b/AI_GENERATION.md
deleted file mode 100644
index 6d17932..0000000
--- a/AI_GENERATION.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Geração por IA
-
-Projeto gerado por Grok (xAI) no modo Capitão absoluto.
-
-Usou Agent Toolkit for AWS (MCP Server), Powertools, GitHub connected tools, etc.
-
-Processo: Branches feature, code review, merges controlados.
\ No newline at end of file

From 2ae1de351d4d1766262efa0fec6b485d36fae11e Mon Sep 17 00:00:00 2001
From: Rodrigo Patote <47055922+patote85@users.noreply.github.com>
Date: Thu, 24 Sep 2026 07:58:31 -0300
Subject: [PATCH 3/3] agent-friendly L2-3: strip README self-report fluff

---
 README.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/README.md b/README.md
index 3e4c281..c962ddf 100644
--- a/README.md
+++ b/README.md
@@ -3,18 +3,12 @@
 ## Visão Geral
 API serverless para solicitação de exclusão de cliente com geração de QR Code Pix para pagamento de tarifa.
 
-**Este projeto segue rigorosamente os Karpathy Claude Guidelines**.
-
 ## Melhorias Implementadas
 - Tabela DynamoDB criada via CDK
 - Configuração via env vars
 - Health Check endpoint
 - Throttling no API Gateway
 
-**Code Review:** Aprovado seguindo Karpathy Guidelines.
-
-**Merge realizado para main.**
-
 ## Architecture Decision Records
 
 - [ADR-001 — Unificar exclusão Pix (CDK + Lambda)](docs/adr/ADR-001-unificar-exclusao-pix.md) — **Accepted** (CAB 2026-09-20). Este repo é o canônico; `aws-api-gateway-cdk` será arquivado após migrar o stack. Access pattern Dynamo: pointer `LATEST`. Auth (PR3): Cognito JWT.