Visitar URL original
tutorials-ims/AGENTS.md at main · sap-tutorials/tutorials-ims · GitHub
Skip to content

Latest commit

 

History

History
24 lines (19 loc) · 1.37 KB

AGENTS.md

File metadata and controls

24 lines (19 loc) · 1.37 KB

AGENTS.md

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.

Stack

  • 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

Authoritative guidance

Read CLAUDE.md for the full project guide — commands, architecture, gotchas, testing strategy. AGENTS.md is a pointer; CLAUDE.md is the canonical source.

Quick conventions

  • Hugo content under hugo/content/tutorials/ is generated — never hand-edit. Modify parsers in scripts/parsers/ or upstream tutorials in the sap-tutorials GitHub 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:hybrid requires cf login.
  • Use cds-mcp to look up CDS definitions and CAP API docs before editing CDS or CAP code.

Out of scope for codebase agents

  • Don't modify hugo/content/tutorials/*.md directly.
  • Don't touch gen/ (CAP build output) — regenerate via cds build.
  • Don't bypass @requires/@restrict annotations on services.