# ABAP for Agents: pacotes de regras para Cursor, Claude Code e Copilot em SAP ABAP

Regras prontas para Cursor, Claude Code, GitHub Copilot, Windsurf e qualquer agente AGENTS.md, escritas por um programador ABAP e verificadas contra a documentação da própria SAP.

- Comprar o pack: 29 € (Preço de lançamento; 39 € depois do lançamento): https://abapforagents.lemonsqueezy.com/checkout/buy/e9c8fa44-8976-4003-9b78-17ad170d2803
- Versão lite grátis no GitHub: https://github.com/abapforagents/abap-for-agents-lite

## O problema: em ABAP, os LLMs erram com toda a confiança

- **Objetos inventados**: Módulos de função, BAPIs e views CDS que não existem ou não estão libertados para ABAP Cloud.
- **Release errado**: `INTO TABLE @DATA(...)` em 7.40 SP05, `+=` em 7.50, `define view` em vez de view entities.
- **Bugs silenciosos de dados**: FOR ALL ENTRIES com tabela vazia lê a tabela inteira. `SELECT SINGLE` sem a chave completa.
- **Quebras em RAP e cloud**: `COMMIT WORK` em behavior pools, `sy-datum` e `WRITE` em ABAP Cloud.

## O que inclui

- **10 regras focadas**: Guardrails base, sintaxe por release, ABAP SQL, ABAP Cloud e clean core A-D, RAP/CDS, Clean ABAP, instruções obsoletas, ABAP Unit, S/4HANA vs ECC, autoverificação de LLM.
- **4 skills de tarefas**: Criar um BO RAP managed · refatorar um report legado para Clean ABAP · escrever testes ABAP Unit com test doubles · revisão de código clean core.
- **Todas as ferramentas, uma fonte**: AGENTS.md, CLAUDE.md + skills, Cursor .mdc, instruções e prompt files do Copilot, regras e workflows do Windsurf, prompts simples para ChatGPT / chat do Joule.
- **Curto de propósito**: A investigação mostra que ficheiros de contexto inchados prejudicam os agentes. Os ficheiros sempre ativos ficam abaixo das 200 linhas; o resto carrega por tipo de ficheiro.
- **Fontes incluídas**: Cada regra liga ao styleguide Clean ABAP, à ABAP Keyword Documentation, aos cheat sheets da SAP ou ao Cloudification Repository.
- **Gerador incluído**: Acrescenta as regras da tua casa (prefixos, namespaces, BAPIs permitidas) e gera todos os formatos com um comando.

## Preço

Pagamento único · atualizações v1.x grátis · uso ilimitado em projetos próprios e de clientes. Pode acrescer IVA conforme o país.

- As 10 regras + 4 skills
- Inglês e português
- Cursor, Claude Code, Copilot, Windsurf, Codex
- Gerador + SOURCES.md
- Atualizações v1.x incluídas

### Lite grátis (MIT)

- 5 regras base + 1 skill de revisão
- EN + PT, todos os formatos
- Repositório público no GitHub

## Example

Resultado típico da AI:

```abap
SELECT * FROM vbak INTO TABLE lt_vbak
  FOR ALL ENTRIES IN lt_keys      " empty? reads ALL rows
  WHERE vbeln = lt_keys-vbeln.
CALL FUNCTION 'Z_GET_ORDER_STATUS' " invented FM
  EXPORTING iv_vbeln = lv_vbeln.
COMMIT WORK.                       " inside a RAP handler
```

Com o ABAP for Agents:

```abap
IF keys IS NOT INITIAL.
  SELECT vbeln, erdat, gbstk       " S/4: status in VBAK
    FROM vbak
    FOR ALL ENTRIES IN @keys
    WHERE vbeln = @keys-vbeln
    INTO TABLE @DATA(orders).      " 7.40 SP08+
ENDIF.
" No COMMIT in RAP: the framework owns the LUW.
```

## Perguntas frequentes

### Funciona com o SAP Joule?

As regras são para Cursor, Claude Code, GitHub Copilot, Windsurf e agentes AGENTS.md. No chat do Joule usa os prompts simples incluídos. A SAP não documenta se o Joule lê ficheiros de regras.

### Funciona com ECC ou só com S/4HANA e ABAP Cloud?

Com ambos. A regra base obriga o agente a definir primeiro o produto, o release e a versão da linguagem, e a tabela de releases mantém o código 7.40/7.50 sem sintaxe mais recente.

### A AI pode ignorar as regras na mesma?

Pode. As regras orientam, não impõem. Servem para cortar erros repetidos, mas o ATC e o ABAP Unit continuam a ser a tua barreira, e as regras mandam o agente corrê-los via servidor MCP quando existe.

### É seguro usar com o servidor MCP do ADT?

As regras mandam os agentes usar o MCP só em leitura (consultar objetos, correr verificações) e nunca usar ferramentas de escrita sem o teu consentimento explícito.

### Posso usar em projetos de clientes?

Sim, em projetos próprios e de clientes sem limite. Só não podes revender nem republicar o pack.

### Tem ligação à SAP?

Não. É um produto independente. SAP, ABAP e S/4HANA são marcas registadas da SAP SE.