This is the AGENTS.md for the SAP Developers Tutorials platform codebase. AI coding agents (Claude Code, Cursor, Copilot, Aider) working in this repo should read this file and CLAUDE.md.
- Hugo static site (hugo/) for tutorial pages, missions, groups
- CAP Node.js backend (srv/) on SAP HANA Cloud
- Vue 3 public-facing apps (hugo-apps/, app/display-app/)
- SAPUI5/Fiori Elements admin shell (app/admin-shell/)
- BTP Cloud Foundry deployment via MTA
Read CLAUDE.md for the full project guide — commands, architecture, gotchas, testing strategy. AGENTS.md is a pointer; CLAUDE.md is the canonical source.
- Hugo content under
hugo/content/tutorials/is generated — never hand-edit. Modify parsers inscripts/parsers/or upstream tutorials in thesap-tutorialsGitHub org. - Tutorial HTML is served from HANA BLOBs, not static files. After Hugo build, run
npm run publish-content. - Run
npm test(unit, in-memory SQLite) before committing.npm run test:hybridrequirescf login. - Use
cds-mcpto look up CDS definitions and CAP API docs before editing CDS or CAP code.
- Don't modify
hugo/content/tutorials/*.mddirectly. - Don't touch
gen/(CAP build output) — regenerate viacds build. - Don't bypass
@requires/@restrictannotations on services.