# Btp

> Use when designing, building, or troubleshooting solutions on SAP Business Technology Platform — subaccounts, Cloud Foundry, Kyma, CAP, HANA Cloud, XSUAA, destinations, or any BTP service.

- **Type:** Skill
- **Install:** `agentstack add skill-vigneshbarani24-sap-superpowers-btp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vigneshbarani24](https://agentstack.voostack.com/s/vigneshbarani24)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vigneshbarani24](https://github.com/vigneshbarani24)
- **Source:** https://github.com/vigneshbarani24/sap-superpowers/tree/main/skills/modules/btp
- **Website:** https://sap-superpowers.vercel.app/

## Install

```sh
agentstack add skill-vigneshbarani24-sap-superpowers-btp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# BTP (SAP Business Technology Platform)

Enforces secure, portable, multi-tenant-aware BTP architecture — no hard-coded credentials, no monolithic subaccount designs, no skipped security configurations.

## Content Routing

| Topic | Section |
|-------|---------|
| Subaccount design | Subaccount Architecture |
| CF vs Kyma choice | Runtime Decision |
| CAP development | CAP Patterns |
| Security / XSUAA | Security Patterns |
| HANA Cloud | HANA Cloud Patterns |
| Destinations | Destination Service |

## Iron Laws

1. **ALWAYS CONSIDER MULTI-TENANCY FROM DAY ONE.** Retrofitting multi-tenancy is 3-5x the effort of designing it in. Every BTP solution must document its tenancy model (single vs. multi) before architecture is approved.
2. **NEVER HARD-CODE CREDENTIALS.** No passwords, client secrets, or connection strings in code, config files, or environment variables set manually. All credentials live in the Credential Store, Destination Service, or Secret Store (Kyma). Hard-coded credentials will be rotated, and your app will break at 2am.
3. **ALWAYS USE THE DESTINATION SERVICE FOR BACKEND CONNECTIVITY.** Direct URL construction bypasses certificate management, load balancing, and the principal propagation chain. Destination Service is mandatory for all S/4HANA, on-prem, and external system calls.
4. **NEVER SKIP XSUAA SCOPE CHECKS.** An application that doesn't enforce scopes grants every authenticated user admin-level access. Define roles, role collections, and scopes in `xs-security.json` before the first protected endpoint is written.
5. **NEVER DEPLOY TO PRODUCTION WITHOUT A SEPARATE SUBACCOUNT.** Dev / Test / Prod are separate subaccounts, not separate spaces in the same subaccount. Shared subaccounts share entitlements, quotas, and blast radius.

## Rationalization Table

| Agent Will Try To... | Why It Seems Reasonable | Why It Fails | Counter |
|---|---|---|---|
| Put credentials in `default-env.json` | "It's only for local dev, not production" | `default-env.json` gets committed to git; rotated credentials break local envs for everyone | Use `cf env` export or `.env` in `.gitignore`; use Credential Store for real secrets |
| Use one subaccount for all landscapes | "Simpler to manage, fewer accounts" | Single subaccount = single quota pool; a runaway dev workload can starve production | Iron Law 5: Separate subaccounts are architecture, not bureaucracy |
| Skip `xs-security.json` scope design | "We'll add security after the PoC works" | XSUAA app registration cannot be easily retrofitted; scope names become API contracts | Define scopes on day one; they are cheap to define, expensive to change |
| Build on CF because it's familiar | "We've always used CF" | Kyma is mandatory for some scenarios (event mesh, complex Kubernetes workloads); choose based on requirements | See Runtime Decision section; document the choice with criteria |
| Use `hdi-shared` plan for production | "It's the easy HANA Cloud option" | `hdi-shared` is for dev/test; production requires dedicated HANA Cloud instance with HA config | Check service plan before provisioning; document the plan choice in architecture |

## Red Flags

- "I'll add the security config later..." → XSUAA scopes are an architecture decision. Define them now.
- "The credentials are just for the PoC..." → PoCs become production. Hard-code once, regret forever.
- "We can use the same subaccount for dev and prod..." → Iron Law 5 violation. Separate subaccounts are non-negotiable.
- "Let me just call the S/4HANA URL directly..." → Iron Law 3 violation. Use the Destination Service.
- "Multi-tenancy isn't needed for this project..." → Document that decision explicitly and get sign-off; don't assume it.

Before any BTP solution design or code: (1) Confirm subaccount landscape (dev/test/prod separation). (2) Confirm runtime choice (CF or Kyma) with documented rationale. (3) Confirm tenancy model. (4) Confirm all credentials will go through Destination Service or Credential Store. No architecture diagram or code until these four decisions are documented.

## Subaccount Architecture

**Hierarchy:** Global Account → Directories (optional grouping) → Subaccounts → Spaces (CF) / Namespaces (Kyma)

**Recommended Landscape:**
- `dev` subaccount — developer sandbox, liberal quotas
- `test` / `staging` subaccount — integration testing, mirrors prod entitlements
- `prod` subaccount — production, restricted access, alerting enabled

**Entitlement management:** Assign service plans per subaccount. Never share entitlements across landscapes by co-locating in one subaccount.

## Runtime Decision: CF vs Kyma

| Factor | Choose CF | Choose Kyma |
|--------|-----------|-------------|
| Primary language | Node.js, Java, Python | Any (container-based) |
| Complexity | Straightforward apps | Microservices, event-driven |
| Kubernetes needed | No | Yes |
| Event Mesh integration | Limited | Native |
| Custom runtime | Not supported | Full control |
| Operator model | Buildpacks | Helm charts |

## CAP Patterns

- **`cds.requires`** — declare service dependencies, never hard-code in handlers
- **`@restrict` annotations** — declarative authorization; supplement with `req.user.is()` in handlers
- **Hybrid testing:** `cds bind --to ` for local dev against real BTP services
- **CAP + HANA:** Use `@sap/hana-client` via `cds add hana`; never write raw HANA SQL in handlers
- **Multitenancy:** Use `@sap/cds-mtxs` extension; implement `onSubscribe` and `onUnsubscribe` handlers

## Security Patterns (XSUAA)

Key `xs-security.json` elements:
```
xsappname, tenant-mode (dedicated|shared), scopes, role-templates, role-collections
```

- **Principal propagation:** Set `forwardAuthToken: true` in destination for user context forwarding to S/4HANA
- **Service-to-service:** Use `grant-as-authority-to-apps` in scopes; bind both apps to same XSUAA instance
- **Token exchange:** Use `TokenExchange` grant type for on-behalf-of flows

## HANA Cloud Patterns

| Object | Pattern |
|--------|---------|
| HDI containers | One container per app; never share across apps |
| Calculation views | Use sparingly; prefer CDS or SQL views for maintainability |
| Full-text search | `CONTAINS` predicate with `FUZZY` option |
| Monitoring | HANA Cockpit → Performance → Thread Samples for slow query analysis |
| Backup | Automatic daily; verify recovery point objective matches SLA |

## Key BTP Services Reference

| Service | Purpose | Key Config |
|---------|---------|-----------|
| XSUAA | Authentication & authorization | `xs-security.json` |
| Destination Service | Backend connectivity | Destination config in BTP Cockpit |
| Connectivity Service | On-premise via Cloud Connector | `OnPremise` destination type |
| SAP Event Mesh | Async messaging | Queue/topic binding in `enterprise-messaging.json` |
| Alert Notification | Ops alerting | Conditions + actions in service config |
| Job Scheduling | Cron / one-time jobs | `jobscheduler` binding in `mta.yaml` |
| Audit Log | Compliance logging | Bind `auditlog` service; log via SDK |

## Verification

This skill is complete ONLY when ALL of the following are true:

- [ ] Subaccount landscape documented (dev/test/prod as separate subaccounts)
- [ ] Runtime choice (CF vs Kyma) documented with rationale
- [ ] Tenancy model documented and signed off
- [ ] Zero hard-coded credentials in code or `mta.yaml` — all via Destination Service or Credential Store
- [ ] `xs-security.json` scopes defined and reviewed
- [ ] Deployed app responds correctly to authentication + authorization checks (scope enforcement verified)

**Evidence required:** Architecture diagram showing subaccount structure; `xs-security.json` with defined scopes; deployment log showing successful bind to XSUAA and Destination Service.

## Next Skill

After BTP solution design, invoke: `abap-cloud` (if ABAP extension) or `integration-suite` (if integration required)
For security review, invoke: `security-grc`

## Related Skills

- `abap-cloud` — ABAP development on BTP ABAP Environment
- `integration-suite` — API and integration patterns
- `security-grc` — Security and authorization review

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vigneshbarani24](https://github.com/vigneshbarani24)
- **Source:** [vigneshbarani24/sap-superpowers](https://github.com/vigneshbarani24/sap-superpowers)
- **License:** MIT
- **Homepage:** https://sap-superpowers.vercel.app/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vigneshbarani24-sap-superpowers-btp
- Seller: https://agentstack.voostack.com/s/vigneshbarani24
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.