uni/CLAUDE.md

CLAUDE.md - Agent Guidelines for Uni Slides (DHBW + HdM)

This project builds presentation decks for Marp, supporting multiple courses.

Courses

• 223015b - Dateiformate, Schnittstellen, Speichermedien (HdM, 6 Kapitel)
• 223015c - Internettechnologien (HdM, 3 Kapitel)
• dhbw - Technik I – Grundlagen IT (DHBW, 4 Kapitel)

Agent Restrictions

• Agent NEVER runs commands outside this folder
• Agent NEVER runs build/deploy commands without explicit user request
• Agent NEVER runs deploy commands (make deploy, scp, etc.) without explicit user permission
• Agent NEVER runs git checkout -- or git restore on files with uncommitted work. To undo specific changes, use targeted Edit operations instead.

Critical File Protection

Slide files in slides/*/*.md are main content files:

• ALLOWED: Adding slides, adjusting content, fixing typos, enhancing sections
• FORBIDDEN (without permission): Deleting slides, removing sections, bulk deletions
• Before ANY deletion: ALWAYS ask user for confirmation

Project Structure

slides/
├── 223015b/            # HdM: Dateiformate
├── 223015c/            # HdM: Internettechnik
└── dhbw/               # DHBW: Technik I
scripts/                # Shared scripts
themes/                 # Custom Marp themes
build/                  # Generated output (gitignored)

Build Commands

make hdm-dev         # HdM live server all (port 1312)
make hdm-dev-b       # HdM 223015b only (port 1313)
make hdm-dev-c       # HdM 223015c only (port 1314)
make dhbw-dev        # DHBW live server (port 1315)
make hdm-build       # Build all HdM courses
make dhbw-build      # Build DHBW course
make hdm-html        # HTML only (HdM)
make hdm-pdf         # PDF only (HdM)
make hdm-klausur     # Extract klausur slides → slides/*/klausurfolien.md
make hdm-deploy      # Deploy HdM (ASK FIRST!)
make dhbw-deploy     # Deploy DHBW (ASK FIRST!)
make deploy          # Deploy all (ASK FIRST!)

Nix Flake Commands

nix develop                           # Dev shell with all tools (node 22, npm, make)

Code Style Guidelines

File Structure

• Slides in slides/<course>/
• Assets in slides/<course>/assets/
• Always reference images as ./assets/filename.png

Naming Conventions

• Slide files: NN-topic.md (e.g., 01-grundlagen.md)
• Images: snake_case.jpg or kebab-case.jpg

Markdown Style

• Use ATX-style headers (# ## ###)
• Frontmatter for slide metadata
• Never include a final --- (creates empty slide)

Git Workflow

• Commit messages: ALWAYS lowercase
• NEVER add co-authoring lines or generated footers