{"id":47825994,"url":"https://github.com/workshops-de/ki-agentic-software-engineer-slides","last_synced_at":"2026-04-03T19:42:08.254Z","repository":{"id":341741009,"uuid":"1171294621","full_name":"workshops-de/ki-agentic-software-engineer-slides","owner":"workshops-de","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-03T05:11:16.000Z","size":3721,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-03T08:35:08.378Z","etag":null,"topics":["agentic","ai","ai-workflows","ki","software","software-engineering"],"latest_commit_sha":null,"homepage":"https://workshops-de.github.io/ki-agentic-software-engineer-slides/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/workshops-de.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-03T04:22:13.000Z","updated_at":"2026-03-03T05:11:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/workshops-de/ki-agentic-software-engineer-slides","commit_stats":null,"previous_names":["workshops-de/ki-agentic-software-engineer-slides"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/workshops-de/ki-agentic-software-engineer-slides","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workshops-de%2Fki-agentic-software-engineer-slides","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workshops-de%2Fki-agentic-software-engineer-slides/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workshops-de%2Fki-agentic-software-engineer-slides/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workshops-de%2Fki-agentic-software-engineer-slides/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workshops-de","download_url":"https://codeload.github.com/workshops-de/ki-agentic-software-engineer-slides/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workshops-de%2Fki-agentic-software-engineer-slides/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31373833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T17:53:18.093Z","status":"ssl_error","status_checked_at":"2026-04-03T17:53:17.617Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic","ai","ai-workflows","ki","software","software-engineering"],"created_at":"2026-04-03T19:42:05.882Z","updated_at":"2026-04-03T19:42:08.236Z","avatar_url":"https://github.com/workshops-de.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Workshop Slides Template\n\nA template repository for creating workshop slides using [Slidev](https://sli.dev/) with integrated task management for the workshops.de platform.\n\n## 🚀 Quick Start\n\n### 1. Use This Template\n\nClick \"Use this template\" on GitHub to create a new repository.\n\n### 2. Clone and Setup\n\n```bash\ngit clone https://github.com/your-org/your-workshop-slides.git\ncd your-workshop-slides\nnpm install\n```\n\n### 3. Start Development\n\n```bash\nnpm run dev\n```\n\nOpen http://localhost:3030 to see your slides.\n\n## 📁 Project Structure\n\n```\n/\n├── 00-index.md                      # Main index with links to all lessons\n├── sources.md                       # Sources and references\n├── package.json                     # Dependencies and scripts\n├── scripts/\n│   └── build-all.sh                 # Build script for all lessons\n├── lessons/\n│   └── 01-example-lesson/           # Lesson folder\n│       ├── lesson.yml               # Lesson metadata (synced to platform)\n│       ├── 01-example-lesson.md     # Main slide deck entry point\n│       ├── slides/                  # Slide content organized by topic\n│       │   └── example-topic/\n│       │       ├── why.md           # 4-MAT: Why this matters\n│       │       ├── what.md          # 4-MAT: Core concepts\n│       │       ├── how.md           # 4-MAT: Practical steps\n│       │       ├── what-if.md       # 4-MAT: Edge cases \u0026 alternatives\n│       │       └── task.md          # Exercise slide\n│       └── tasks/                   # Task definitions (synced to platform)\n│           ├── 01-first-task/\n│           │   ├── task.yml         # Task metadata\n│           │   ├── body.md          # Main description\n│           │   ├── hint.md          # Hints (optional)\n│           │   └── trainer_hint.md  # Trainer notes (optional)\n│           └── 02-second-task/\n│               ├── task.yml\n│               ├── body.md\n│               ├── hint.md\n│               ├── bonus.md         # Bonus challenges (optional)\n│               └── assets/          # Task-specific images\n└── .cursor/\n    └── rules/\n        └── slidev-rules.mdc         # AI rules for slide creation\n```\n\n## 📝 Creating a New Lesson\n\n### 1. Create Lesson Folder\n\n```bash\nmkdir -p lessons/02-new-lesson/slides/topic-name\nmkdir -p lessons/02-new-lesson/tasks/01-first-task\n```\n\n### 2. Create lesson.yml\n\n```yaml\nname: New Lesson Title\nposition: 2\ntrainer: trainer@workshops.de\ngithub_code_url: https://github.com/org/code-repo\ngit_tag_starting: main\nslides_type: slidev\npdf_generation_enabled: true\nstackblitz_enabled: true\ncodesandbox_enabled: false\ndeprecated: false\n```\n\n### 3. Create Main Slide File\n\nCreate `lessons/02-new-lesson/02-new-lesson.md` with the Slidev frontmatter.\n\n### 4. Add Topic Slides\n\nCreate the 4-MAT structure:\n\n- `slides/topic-name/why.md`\n- `slides/topic-name/what.md`\n- `slides/topic-name/how.md`\n- `slides/topic-name/what-if.md`\n- `slides/topic-name/task.md`\n\n### 5. Add Tasks\n\nCreate a task folder with `task.yml` for metadata and separate `.md` files for content:\n\n```\ntasks/01-task-name/\n├── task.yml           # Metadata (title, position, category, etc.)\n├── body.md            # Main task description\n├── hint.md            # Hints for participants (optional)\n├── bonus.md           # Bonus challenges (optional)\n├── trainer_hint.md    # Notes for trainers (optional)\n└── assets/            # Task-specific images (optional)\n```\n\n**task.yml** - Only metadata:\n\n```yaml\ntitle: 'Task Title'\nposition: 1\ncategory: 'Basics'\npreparation: false\nestimated_time_in_minutes: 15\nalways_unlocked: false\ngit_tag_completed: solution-01-task-name\n```\n\n**body.md** - Main task description with full Markdown support.\n\n**hint.md** - Collapsible hints using `\u003cdetails\u003e` tags.\n\n**bonus.md** - Additional challenges for fast learners.\n\n**trainer_hint.md** - Notes visible only to trainers (common issues, time estimates, discussion points).\n\n\u003e **Note**: You can also include markdown content directly in `task.yml` using `body_markdown`, `hint_markdown`, etc., but separate files are recommended for better readability and editor support.\n\n### 6. Update Build Script\n\nAdd the new lesson to `scripts/build-all.sh`:\n\n```bash\necho \"📄 Building Lesson 02...\"\nnpx slidev build lessons/02-new-lesson/02-new-lesson.md --out dist/02-new-lesson --base /02-new-lesson/\n```\n\n### 7. Update package.json\n\nAdd dev/build scripts:\n\n```json\n{\n  \"scripts\": {\n    \"dev:02\": \"slidev lessons/02-new-lesson/02-new-lesson.md --open\",\n    \"build:02\": \"slidev build lessons/02-new-lesson/02-new-lesson.md --out dist/02-new-lesson\"\n  }\n}\n```\n\n## 🎓 4-MAT Teaching Structure\n\nEach topic follows the 4-MAT learning cycle:\n\n| Phase       | Purpose    | Content                               |\n| ----------- | ---------- | ------------------------------------- |\n| **WHY**     | Connection | Why this matters, real-world problems |\n| **WHAT**    | Conceptual | Core concepts, theory, definitions    |\n| **HOW**     | Practice   | Step-by-step implementation           |\n| **WHAT IF** | Creative   | Edge cases, alternatives, extensions  |\n\n## 📦 Available Scripts\n\n| Script             | Description                    |\n| ------------------ | ------------------------------ |\n| `npm run dev`      | Start development server       |\n| `npm run dev:01`   | Start dev server for lesson 01 |\n| `npm run build`    | Build all lessons              |\n| `npm run build:01` | Build lesson 01 only           |\n| `npm run export`   | Export slides to PDF           |\n| `npm run preview`  | Preview built slides           |\n\n## 🔗 Platform Integration\n\nThis template is designed to work with the workshops.de platform:\n\n- **lesson.yml**: Defines lesson metadata synced to the platform\n- **task.yml**: Defines task content synced to the platform\n- **GitHub Sync**: The platform can automatically sync content from this repository\n\n### Enabling GitHub Sync\n\n1. Set the `github_course_url` in your course settings on the platform\n2. Enable sync for the course\n3. The platform will automatically import lessons and tasks\n\n## 🎨 Customization\n\n### Theme\n\nChange the theme in your slide frontmatter:\n\n```yaml\n---\ntheme: seriph # or: default, apple-basic, etc.\n---\n```\n\n### Styling\n\nUse [UnoCSS](https://unocss.dev/) classes directly in your slides.\n\n## 📚 Resources\n\n- [Slidev Documentation](https://sli.dev/)\n- [UnoCSS](https://unocss.dev/)\n- [Mermaid Diagrams](https://mermaid.js.org/)\n- [Shiki Syntax Highlighting](https://shiki.matsu.io/)\n\n## 📄 License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkshops-de%2Fki-agentic-software-engineer-slides","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkshops-de%2Fki-agentic-software-engineer-slides","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkshops-de%2Fki-agentic-software-engineer-slides/lists"}