| name | sap-router-skill |
| description | SAP development orchestrator v5.0.0 — Karpathy command format (Think→Simplify→ Surgical→Verify), healthcheck guardian, self-learning router, caveman-compressed output default. Delegates small-scope work to the cavecrew subagents automatically: find/search/locate → cavecrew-investigator, fix/edit/rename/typo → cavecrew-builder, review/audit/diff → cavecrew-reviewer. Multi-protocol: HTTP/OData/RFC/SOAP RFC/BDC. ZROUTER v5 REST gateway. Install pipeline: YDOWN→ZABAPGIT→ZSAPLINK. BDC engine: YFG_SBDC. Test suites: ZODATA_TEST_AUTOMATION_FGR. Use for any SAP task. |
SAP Router v5.0.0 — Karpathy Command Format
Behavioral wrapper: every operation follows 4 principles. Healthcheck first.
Default output: caveman compression. Drop articles/filler/pleasantries.
Fragments OK. Code blocks unchanged.
Runtime root
Resolve SAP_ROUTER_ROOT before running router commands. It must point to the
sap-router-skill repository and contain scripts/source_catalog.py, package.json,
and .agents/. Change the working directory to that root before using any relative
python scripts/... or npm run ... command below. Fail closed if the root is not
configured or invalid; never assume the user's current project is the router repo.
Principle -1 — Delegate Before You Work (RUN FIRST)
Before doing anything else, classify the request and delegate. Small-scope work must
NOT be done in the main context — it goes to a cavecrew subagent via the Agent tool.
This is the single largest token saving in the whole router; skipping it wastes the
main context on work a cheaper agent handles better.
Match the request against this table. On a match, immediately call the Agent tool
with the given subagent_type and stop — do not pre-read files, do not pre-search, do
not "just check something first". The subagent does the reading.
| Request looks like | subagent_type | Why |
|---|
| find, search, locate, "where is", look up, grep, scan for | cavecrew-investigator | read-only lookup, runs on haiku |
| fix, edit, change, rename, remove, add method/field, typo, "single file", "small change" | cavecrew-builder | surgical 1-2 file edit |
| review, audit, "check diff", "review this", PR review, merge request | cavecrew-reviewer | severity-tagged findings |
Rules:
- Builder before investigator. If the request is to change something, send it
straight to
cavecrew-builder — it does its own locating. Do not run an
investigator pass first.
- One agent, one call. Pass the user's request plus the concrete file paths you
already know. Never paste file contents into the prompt — the agent reads them.
- Honour the refusal.
cavecrew-builder returns REFUSE: <reason> when the change
exceeds 2 files, adds a feature, or spans a refactor. That is a correct outcome:
take the work back into the main context and proceed with the full flow below.
Never re-dispatch the same task to get a different answer.
- Escalation is one-way.
cavecrew-investigator returns
ESCALATE: needs cavecrew-builder when the task needs an edit. Re-dispatch once to
the builder with the files it found.
- No match → no delegation. Anything larger — spec implementation, transport,
deployment, multi-object ABAP work — skips this section entirely and runs the normal
flow starting at Principle 0.
To confirm the routing decision programmatically:
python scripts/sap_router.py route --action "<the user request>"
A strategy of caveman-surgical, caveman-readonly, or caveman-diff-review means
delegate; the agent_type field names the exact subagent_type to pass.
Principle 0 — Healthcheck First (RUN ALWAYS)
python scripts/healthcheck.py
Before ANY operation, verify:
-
.env exists: python scripts/healthcheck.py --prompt-missing
→ If missing: prompt user for ARC_SAP_URL, ARC_SAP_USER, ARC_SAP_PASSWORD, ARC_SAP_CLIENT
→ Show: cp .env.template .env + edit instructions
-
MCPs connected: probes all 38 MCPs (+17 planned)
→ HIGH criticality: arc-1, aibap (block on failure)
→ MEDIUM: mcp-abap-adt, mcp-sap-gui, btp-sap-odata-to-mcp (warn)
→ OPTIONAL: RAG connectors (Pinecone, Supabase, Azure) — pre-ready, activate later
-
Self-learn context: python scripts/self_learn.py context
→ Load learned MCP reliability, system features, routing preferences
Principle 1 — Think Before Coding
Don't assume. Don't hide confusion. Surface tradeoffs.
Before implementing, state:
ASSUMPTIONS:
- SAP version: S/4HANA 2023, Basis 757
- Module: MM (detected from "material" + "BAPI_MATERIAL_SAVEDATA")
- BAPI parameters: HEADDATA + CLIENTDATA + MATERIALDESCRIPTION
- Authorization: S_DEVELOP + S_TCODE for MM01/MM02/MM03
- Transport: DEV system, client 100
UNCERTAINTIES (if any):
- BAPI_MATERIAL_SAVEDATA field MATERIAL_TYPE: which value for raw materials? (ROH vs HAWA)
TRADEOFFS:
- ADT direct: fastest for source read, cannot create materials
- SOAP RFC: call ANY BAPI via plain HTTP POST, no JCo/pyrfc needed
- ZROUTER RFC: batch BAPI execution, need RFC destination
- GUI fallback: MM01 transaction, requires SAP GUI installed + scripting enabled
- OData BAPI wrapper: IWBEP/BAPI_* via Gateway OData V2
→ RECOMMENDATION: SOAP RFC for single BAPI call, ZROUTER RFC for batch, GUI for single material with config
If multiple BAPIs, transaction fallbacks, or routing options exist, always present them as an enumerated (numbered) list (1., 2., 3...) to facilitate user selection. If SAP config unclear → ask.
Principle 2 — Simplicity First
Minimum code that solves the problem. Nothing speculative.
Routing decision tree — SIMPLEST path wins:
User Request
│
▼
1. CAVEMAN scope? (find/fix/review, 1-2 files)
│ YES → call Agent tool NOW, subagent_type=
│ cavecrew-investigator | cavecrew-builder | cavecrew-reviewer
│ STOP here — do not read/search first. See Principle -1.
│ 60% token savings. Caveman-compressed output.
▼
2. ADT available? (read_source, search, syntax_check, activate)
│ YES → arc-1 (primary) or aibap (secondary)
│ Self-learn picks best based on latency history.
▼
3. BAPI/RFC call? (create/read BAPI, FM execution)
│ Check if SOAP RFC available (/sap/bc/soap/rfc)
│ YES → Call BAPI via plain HTTP POST → No JCo/pyrfc needed
│ Resources: /sap/bc/soap/rfc + /sap/opu/odata/IWBEP/BAPI_*
│ for Gateway OData BAPI wrapper
▼
4. GUI REQUIRED? (SPRO, SM30, SU01, MM01, VA01...)
│ YES → IMMEDIATE GUI fallback — skip ADT attempt
│ Missing nav data? → sap-gui-web-enrich → web search for field IDs
│ Try: mcp-sap-gui → mcp-sap-gui-kts → sapgui-mcp-go
▼
5. Functional WRITE? (create material, post document, create order...)
│ Requires explicit functional context (--functional). Without it →
│ needs-functional-context, NO BAPI fired (BAPIs fire only when a real
│ functional action requires them).
│ With context → BAPI-first dispatch (commit stays in backend), else
│ SAP GUI write transaction. Optional: --use-zrouter uses ZROUTER RFC
│ ONLY if the user opted in (zrouter accept). Never the default.
▼
6. Spec → code? (implement specification, full workflow)
│ YES → sap_router.py pipeline → 8 stages
│ Stage 1: Spec Analysis → Stage 8: Transport Gate
▼
7. LLM optimization? (prompt engineering, eval harness)
│ YES → sap-llm-engineering → evaluate → optimize → retry
Cascading MCP Fallback:
If a tool call to the primary mcp_server fails (due to connection timeout, missing credentials, or server errors), the agent must inspect the mcp_servers list returned by the router and iteratively execute the tool on the next server in the list until one succeeds, or until all options are exhausted.
- Advanced ABAP:
abap-mcp → arc-1 → aibap → mcp-abap-adt
- Standard ADT:
arc-1 → abap-mcp → aibap → mcp-abap-adt
- Cloud ALM:
mcp-calm-server → cloud-alm-itsm
- Transports:
sap-transport-mcp → abap-mcp → arc-1 → aibap
- GUI Fallbacks:
mcp-sap-gui → mcp-sap-gui-kts → sapgui-mcp-go
Self-learn adapts routing: tracks MCP latency, success rates, auto-prefers faster paths.
python scripts/self_learn.py best-mcp --candidates "arc-1,aibap,mcp-abap-adt" → returns best.
RAG pre-ready: Pinecone, Supabase, Azure AI Search connectors configured in .mcp.json.
Activate by uncommenting vars in .env. No code changes needed.
SAP API Endpoints (No JCo Required)
5 standard SAP HTTP endpoints enable API access WITHOUT JCo or pyrfc. Every endpoint uses plain HTTP(S) — no proprietary libraries needed. Any HTTP client (curl, fetch, axios) can interact with SAP directly.
| Endpoint | Purpose | Method |
|---|
/sap/bc/soap/rfc | Call ANY RFC-enabled FM via HTTP SOAP POST. Standard in SAP NetWeaver 7.00+. No add-ons required. | SOAP 1.1/1.2 POST — XML request/response |
/sap/opu/odata/IWBEP/BAPI_* | Gateway auto-exposes BAPIs as OData V2 services. Requires SEGW project or IW50 auto-provisioning. | OData V2 GET/POST |
/sap/bc/adt/abapunit/ | Run ABAP Unit tests via REST. Returns test results as XML/JSON. ADT-enabled system. | REST GET |
/sap/bc/adt/atc/ | ATC code quality checks via REST. Runs ATC on specified objects, returns findings with priority. ADT-enabled system. | REST GET/POST |
/sap/bc/icf/ | SICF service registration and management via HTTP. Activate/deactivate services, list handlers. | REST (ICF framework) |
Integration with routing: Step 3 of the decision tree above checks /sap/bc/soap/rfc availability first. If available, BAPIs are called via simple HTTP POST with SOAP XML payload — no JCo installation, no pyrfc compilation. If unavailable, the router falls through to GUI or functional dispatch as appropriate. ADT endpoints (/sap/bc/adt/*) are used by arc-1/aibap for development operations.
Principle 3 — Surgical Changes
Touch only what you must. Clean up only your own mess.
SAP-specific surgical rules:
- Transport only changed objects — not whole package
- Don't reformat adjacent methods when fixing one
- Don't "improve" CDS views while adding one field
- Match existing naming: ZCL_ prefix if project uses it
- Match existing style: UPPER/lower keywords, indent width
- If you notice unrelated dead code → mention it, don't delete
Caveman compression is the SURGICAL default:
- Drop articles/filler → 60% fewer tokens
- Code blocks preserved exactly
- Security warnings use full clarity
Principle 4 — Goal-Driven Execution
Define success criteria. Loop until verified.
Every SAP operation follows this pattern:
1. [Spec Analysis] → verify: module identified, BAPIs listed
2. [Technical Proposal] → verify: reviewed by sap-crew-analysis (7 agents)
3. [Implementation] → verify: syntax OK, abaplint pass, unit tests green
4. [Peer Review] → verify: 9-dimension score >= 70/100
5. [Transport] → verify: transport gate GO, objects in task
Verification Checklist Per Operation Type
ABAP Code Change:
[ ] aibap syntax_check → no errors
[ ] npm run abap:lint → pass
[ ] aibap run_unit_tests → all green
[ ] sap-crew-analysis (quick mode) → score >= 70
[ ] abap-code-review (9 dimensions) → GO
[ ] sap-transport-gate (10 dimensions) → GO
BAPI/Material Create:
[ ] BAPI executed without E/A-type messages
[ ] BAPIRET2 TABLES checked (not just IMPORTING RETURN)
[ ] BAPI_TRANSACTION_COMMIT with WAIT = 'X'
[ ] Verify in target system: MM03 for material, VA03 for order
[ ] BAL log entry created
CPI iFlow:
[ ] iFlow deployed to CPI tenant
[ ] Test message processed (no errors in MPL)
[ ] Response payload matches expected structure
[ ] Groovy script linted (cpi:lint)
GUI Transaction:
[ ] Transaction navigated successfully
[ ] All required fields populated
[ ] No unexpected popups/dynpros
[ ] Result captured via ALV read or screenshot
[ ] Session closed cleanly
Pipeline Execution
python scripts/sap_router.py pipeline --spec requirements.md
python scripts/sap_router.py pipeline --spec requirements.md --mode fast
python scripts/sap_router.py pipeline --spec requirements.md --resume-from stage4
Self-Learn Feedback Loop
npm run learn:mcp -- --mcp arc-1 --latency 245 --success true
npm run learn:route -- --action MM_CREATE_MATERIAL --success true
npm run learn:ctx
Quick Dispatch Table
| User says | Route | Execute + Verify |
|---|
| "read ZCL_*" / "get source" | ADT (self-learn best) | arc-1 SAPRead → verify: source returned |
| "write/activate Z*" | ADT direct | arc-1 SAPWrite → SAPActivate → syntax check |
| "create material/order" (functional) | BAPI dispatch (--functional) | BAPI → BAPIRET2 check → MM03/VA03 verify. ZROUTER only if opted in. |
| functional write w/o --functional | needs-functional-context | classify only — no BAPI fired out of context |
| "call BAPI without JCo" / "BAPI via HTTP" | SOAP RFC | HTTP POST /sap/bc/soap/rfc → parse SOAP response → verify |
| "run stages in parallel" / big spec | dispatch-plan / crew-dispatch | emit wave plan; same-wave agents launch concurrently |
| "SPRO / SM30 / SU01 / MM01 / VA01..." | GUI IMMEDIATE | mcp-sap-gui navigate → execute → verify |
| "GUI data missing for tcode X" | GUI + web enrich | WebSearch SAP Help → build BDC → cache |
| "find/where is X" | Agent(subagent_type="cavecrew-investigator") | delegate immediately → 60% token savings |
| "fix typo in ZCL_X line 42" | Agent(subagent_type="cavecrew-builder") | 1-2 file surgical edit; honour REFUSE: |
| "review diff/PR" | Agent(subagent_type="cavecrew-reviewer") | severity-tagged findings, read-only |
| "implement spec" | Pipeline 8-stage | spec → proposal → implement → lint → review → transport |
| "healthcheck" | healthcheck.py | .env check → MCP probes → missing prompt |
| "learn from this" | self_learn.py | record outcome → adapt routing → persist |
| "RAG search for X" | RAG connector | Pinecone/Supabase/Azure → retrieve → generate |
| "optimize LLM prompt for ABAP" | sap-llm-engineering | evaluate → optimize prompt → retry |
Project Objects
Skills (85 — v5.0.0)
See AGENTS.md for the complete multi-IDE skill mapping table with routing rules, action-to-BAPI mappings, and agent descriptions.
Covers: ABAP Core, BTP, CDS/RAP, OData, CPI, HANA, SAC, Fiori/UI5, Datasphere, Workflow, AI/LLM, Code Review, Transport, SAP GUI, Cloud Integration, Authorization, RAP Business Events.
MCPs (39 configured, ~16 planned)
Configured (39): arc-1, aibap, mcp-abap-adt, mcp-sap-gui, mcp-sap-gui-kts, sap-gui-mcp-jduncan, sapgui-mcp-webgui, sapgui-mcp-go, abap-mcp-adt-powerup, mcp-sap-notes, btp-mcp, odata-mcp-proxy, btp-sap-odata-to-mcp, plugin:ui5:ui5-mcp-server, plugin:sap-fiori-mcp-server:fiori-mcp, plugin:mdk-mcp:mdk-mcp, plugin:cds-mcp:cds-mcp, pinecone-rag, supabase-rag, sf-mcp, sap-rfc-mcp-server, azure-ai-search, sap-pi-mcp, bw-modeling-mcp, erpl-adt, odata-mcp-go, cloud-alm-itsm, datasphere-mcp, sapient-mcp-py, sapient-mcp, vibing-steampunk, sap-cpi, cf-cli-mcp, sap-api-management, mcp-integration-suite, ci-mcp-server, abap-mcp, mcp-calm-server, sap-transport-mcp
Planned / Roadmap (~16): mcp-abap-abap-adt-api, dassian-adt, adt-ls, sapgui-mcp, cpi-mcp-server, mcp-ci-python, btp-is-ci-mcp-server, sap-cpi-mcp-backup, cap-mcp-plugin, hana-mcp-server, guniweb-sap-mcp, sap-mcp, mcp-hub, sap-ai-mcp-servers, sap-mcp-config, mcp-sap-docs
Key MCP Server Details
| MCP | Description |
|---|
| vibing-steampunk | ADT-to-MCP bridge, 257+ GitHub stars, written in Go. Translates ADT REST API into MCP tools. [Planned] |
| erpl-adt | Single-binary ADT CLI with zero external dependencies. Lightweight ADT operations without npm/Node. [Configured] |
| sap-transport-mcp | Dedicated transport management MCP — create, release, and manage SAP transport requests. [Configured] |
| guniweb-sap-mcp | Multi-protocol MCP supporting OData + IDoc + RFC/BAPI. 918 automated tests. [Planned] |
Scripts (24 — v5.0.0)
| Script | Description |
|---|
scripts/abap_serializer.py | Multi-format ABAP packer: .nugg, abapGit, ZDOWNLOAD XML |
scripts/adt_deploy.py | ADT object deployment utility |
scripts/btp_diagram.py | BTP architecture diagram generator from skill references |
scripts/check_gui_scripting.py | SAP GUI scripting readiness probe (RZ11 + SAPLogon check) |
scripts/cpi_client.py | CPI iFlow HTTP client with OAuth and CSRF support |
scripts/cpi_iflow_packager.py | CPI iFlow ZIP create/validate/extract |
scripts/deploy_all.py | Batch deploy all ABAP objects |
scripts/fallback_engine.py | 6-tier cascading fallback with retry, verification, 36 mapped actions |
scripts/hdi_lint.py | SAP HANA HDI container linting and validation |
scripts/healthcheck.py | Probes 38 MCPs, validates .env, generates interactive prompts |
scripts/memory_manager.py | Session context file (MEMORY.md) lifecycle management |
scripts/rag_ingest.py | RAG ingestion pipeline for SAP documentation indexing |
scripts/rag_search.py | RAG search against indexed SAP documentation |
scripts/sap_activate_v2.py | SAP object activation v2 |
scripts/sap_com_activate.py | SAP COM object activation |
scripts/sap_gui_activate.py | SAP GUI scripting activation |
scripts/sap_pyautogui_f8.py | PyAutoGUI F8 execution for SAP GUI |
scripts/sap_router.py | Routing engine: ADT-first, GUI-fallback, caveman delegation, pipeline orchestration |
scripts/self_learn.py | Hermes-style context adaptation — tracks MCP latency/reliability, adapts routing |
Install ZROUTER on SAP (OPTIONAL — opt-in only, never the engine)
ZROUTER is an OPTIONAL RFC accelerator. Routing never auto-probes or
auto-installs it. Ask first: python scripts/sap_router.py zrouter offer
(default: decline; a decline is persisted in zrouter_optin.json). Only after
python scripts/sap_router.py zrouter accept do the steps below apply:
aibap: create_object(type="DEVC", name="ZROUTER")
aibap: create_object(type="TABL", name="ZROUTER_TMPL_HD")
python scripts/abap_serializer.py package --source templates/zrouter_dispatch.prog.abap \
--name ZCL_ZROUTER_DISPATCH --type CLAS --output deploy/
aibap: create_object(type="FUGR", name="ZROUTER")
aibap: create_object(type="FUNC", name="ZROUTER_DISPATCH_FM", function_group="ZROUTER")
aibap: activate_objects(["ZCL_ZROUTER_DISPATCH","CX_ZROUTER","ZROUTER_DISPATCH_FM"])
python scripts/sap_router.py route --action MM_CREATE_MATERIAL --functional --use-zrouter
