From 83e0bc5b8ffb2471aa272694768fc44b76d70262 Mon Sep 17 00:00:00 2001 From: Gerald Fruhmann Date: Mon, 8 Jun 2026 14:01:34 +0200 Subject: [PATCH] =?UTF-8?q?chore:=20v2.0.0=20release=20=E2=80=94=20docs=20?= =?UTF-8?q?cleanup=20+=20plugin=20version=20bump?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/skill-research-basis.md: new permanent reference (academic & industry sources per skill) replacing the work-in-progress academic-basis.md - docs/gap-analysis.md + docs/academic-basis.md: removed (all gaps resolved, content preserved in Git history) - CLAUDE.md: updated to reflect full codebase (24 skills, plugin structure, docs/ directory, install command) - README.md: docs/ directory added to repo structure - CHANGELOG.md: [Unreleased] -> [2.0.0], version links updated - plugin.json: v1.3.0 -> v2.0.0 Co-Authored-By: Claude Sonnet 4.6 --- CHANGELOG.md | 16 +- CLAUDE.md | 68 +++-- README.md | 7 +- docs/academic-basis.md | 393 ------------------------- docs/gap-analysis.md | 106 ------- docs/skill-research-basis.md | 112 +++++++ plugins/dev/.claude-plugin/plugin.json | 2 +- 7 files changed, 175 insertions(+), 529 deletions(-) delete mode 100644 docs/academic-basis.md delete mode 100644 docs/gap-analysis.md create mode 100644 docs/skill-research-basis.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 78a313e..c745665 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,12 +7,23 @@ Format: [Semantic Versioning](https://semver.org). Dates: YYYY-MM-DD. ## [Unreleased] +--- + +## [2.0.0] — 2026-06-08 + ### Added - `design-iac`: Infrastructure as Code design grounded in Kief Morris "Infrastructure as Code" (O'Reilly 2021) and NTNU IIKG3005 — IaC principles (immutable infra, idempotency, snowflake anti-pattern), module design, remote state management, drift detection and remediation, GitOps workflow, IaC testing (3 reference files) - `tool-perf`: Performance engineering grounded in MIT 6.172 (Leiserson/Shun, Bentley Rules) and Brendan Gregg "Systems Performance" (USE Method, flamegraphs) — USE Method resource checklist, profiling tool selection by stack, flamegraph reading guide, Bentley Rules (5 categories), before/after benchmark workflow (3 reference files) - `design-migration` — schema evolution: Added Kleppmann "Designing Data-Intensive Applications" Kap. 4+11 coverage — Forward/Backward Compatibility rules, Dual-Write problem and solutions, Change Data Capture (CDC/Debezium), Avro Schema Registry, Expand-Contract pattern; new `references/schema-evolution.md` -- plugin.json: 22 → 24 skills (v1.2.0 → v1.3.0); meta-help renumbered 1–24 +- plugin.json: 22 → 24 skills, v1.2.0 → v2.0.0; meta-help renumbered 1–24 +- `docs/skill-research-basis.md`: new reference document — academic & industry sources per skill (replaces work-in-progress `docs/academic-basis.md`) +- CLAUDE.md: updated to reflect full plugin structure (24 skills, docs/ directory, plugin install command) + +### Removed + +- `docs/gap-analysis.md`: all items resolved — content lives in Git history +- `docs/academic-basis.md`: replaced by `docs/skill-research-basis.md` - `design-observability`: Observability architecture skill grounded in Google SRE Books (Beyer et al.) and Observability Engineering (Majors/Fong-Jones) — SLO/SLI/Error-Budget, Golden Signals, OpenTelemetry tracing, Burn Rate alerting, Incident Response + blameless postmortem (4 reference files) - `design-cicd`: CI/CD pipeline design grounded in "Accelerate" (Forsgren/Humble/Kim) and "Continuous Delivery" (Humble/Farley) — pipeline architecture, Blue-Green/Canary/Feature Flags decision tree, DORA metrics with benchmarks, Trunk-Based Development (3 reference files) @@ -92,7 +103,8 @@ Format: [Semantic Versioning](https://semver.org). Dates: YYYY-MM-DD. --- -[Unreleased]: https://github.com/gerfru/dev-best-practices/compare/v1.2.0...HEAD +[Unreleased]: https://github.com/gerfru/dev-best-practices/compare/v2.0.0...HEAD +[2.0.0]: https://github.com/gerfru/dev-best-practices/compare/v1.2.0...v2.0.0 [1.2.0]: https://github.com/gerfru/dev-best-practices/compare/v1.1.0...v1.2.0 [1.1.0]: https://github.com/gerfru/dev-best-practices/compare/v1.0.0...v1.1.0 [1.0.0]: https://github.com/gerfru/dev-best-practices/releases/tag/v1.0.0 diff --git a/CLAUDE.md b/CLAUDE.md index 502bd3a..1190816 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,47 +1,65 @@ # Dev Best Practices -Dieses Repo enthaelt Best-Practice-Regeln fuer Software-Projekte -- typischerweise groessere Applikationen (RAG-Systeme, AI Agents, Data Pipelines, etc.) mit Web-Frontend. -Drei Stufen: **Essential** (kompakt, fuer CLAUDE.md), **Thematisch** (ausfuehrlichere Regeln), **Reference** (detailliert, fuer Menschen). +Dieses Repo enthaelt Best-Practice-Regeln fuer Software-Projekte (RAG-Systeme, AI Agents, Data Pipelines, Full-Stack Web Apps) und ein **Claude Code Plugin** mit 24 Skills. ## Repo-Struktur ```text -reference/ # Detaillierte Dokumentation zum Nachschlagen - app-best-practices.md # Security, Auth, API, DB, Monitoring, OWASP - github-best-practices.md # CI/CD, Linting, Testing, Docker, Code Review - architecture-best-practices.md # Schichten, Patterns, Infra, 12-Factor - -claude/ # Kondensierte Regeln fuer Claude Code / Vibe-Coding - essential-rules.md # ~80 Zeilen -- in Projekt-CLAUDE.md einfuegen - app-rules.md # ~170 Zeilen (aus 860) - github-rules.md # ~210 Zeilen (aus 780) - architecture-rules.md # ~190 Zeilen (aus 1180) +.claude-plugin/ + marketplace.json # Macht dieses Repo als Marketplace installierbar + +plugins/dev/ + .claude-plugin/ + plugin.json # Plugin-Metadaten (name: "dev", version: "2.0.0") + commands/ # Slash-Command-Definitionen (eine Datei pro Skill) + skills/ # Skill-Workflow-Definitionen (auto-triggered) + rules/ # Mirror von claude/*.md (wird von Skills als Referenz genutzt) + +claude/ # Kondensierte Regeln fuer Claude Code + essential-rules.md # ~80 Zeilen -- in Projekt-CLAUDE.md einfuegen + app-rules.md # App-Regeln im Detail + github-rules.md # GitHub / CI-Regeln im Detail + architecture-rules.md # Architektur-Regeln im Detail + +reference/ # Detaillierte Dokumentation zum Nachschlagen + app-best-practices.md # Security, Auth, API, DB, Monitoring, OWASP + github-best-practices.md # CI/CD, Linting, Testing, Docker, Code Review + architecture-best-practices.md # Schichten, Patterns, Infra, 12-Factor + +docs/ + skill-research-basis.md # Akademische & Industrie-Quellen pro Skill + +scripts/ + validate-skills.sh # Plugin-Struktur-Validator (CI + pre-commit) ``` -## Verwendung in Projekten - -### Standard: essential-rules.md in Projekt-CLAUDE.md kopieren +## Plugin-Skills (24) -Reicht fuer die meisten Projekte. ~80 Zeilen, kompakt genug neben projektspezifischem Kontext. +```text +DESIGN: design-app, design-secure, design-api, design-data, design-migration, + design-ux, design-llm, design-observability, design-cicd, design-iac +REVIEW: review-app, review-arch, review-secure, review-ux, review-llm +TOOLS: tool-debug, tool-test, tool-style, tool-a11y, tool-perf +META: meta-help, meta-install, meta-drift, meta-sync, meta-create-skill +``` -### Mehr Detail noetig? +Navigationsmenue: `/dev:meta-help` -Einzelne Sections aus den thematischen Files (`app-rules.md`, `github-rules.md`, `architecture-rules.md`) selektiv ergaenzen. +## Verwendung in Projekten -### Global (optional) +**Plugin installieren:** `claude plugin install dev@gerald-dev-best-practices` -Regeln die IMMER gelten in `~/.claude/CLAUDE.md` ablegen: +**Nur Regeln (ohne Plugin):** `claude/essential-rules.md` in Projekt-CLAUDE.md kopieren, oder `/dev:meta-install` verwenden. -- Linting/Formatting-Standards -- Git-Workflow -- Security-Grundregeln +**Mehr Detail:** Sections aus `claude/app-rules.md`, `claude/github-rules.md`, `claude/architecture-rules.md` selektiv ergaenzen. ## Pflege - `reference/` aktualisieren wenn sich Best Practices aendern - `claude/` synchron halten (nur Regeln, keine Erklaerungen) -- `essential-rules.md` ist die Single Source of Truth fuer das Kompaktformat -- Nach Regel-Aenderungen Mirror aktualisieren: `cp claude/*.md plugins/dev/rules/` +- Mirror aktualisieren nach Regel-Aenderungen: `cp claude/*.md plugins/dev/rules/` +- Neuen Skill hinzufuegen: `/dev:meta-create-skill` +- Quellen und akademische Basis: `docs/skill-research-basis.md` diff --git a/README.md b/README.md index 2f4f1ea..720208b 100644 --- a/README.md +++ b/README.md @@ -85,8 +85,8 @@ Or just describe what you need in natural language — Claude picks the right sk plugins/dev/ .claude-plugin/ - plugin.json Plugin metadata (name: "dev") - commands/ Slash-command definitions + plugin.json Plugin metadata (name: "dev", version: "2.0.0") + commands/ Slash-command definitions (one file per skill) skills/ Skill workflow definitions (auto-triggered) rules/ Mirror of claude/*.md (used by skills as reference) @@ -101,6 +101,9 @@ reference/ Detailed docs for humans github-best-practices.md CI/CD, linting, testing, Docker, code review architecture-best-practices.md Layers, patterns, infra, 12-Factor +docs/ + skill-research-basis.md Academic & industry sources per skill + scripts/ validate-skills.sh Plugin structure validator (CI + pre-commit) ``` diff --git a/docs/academic-basis.md b/docs/academic-basis.md deleted file mode 100644 index 01b9b50..0000000 --- a/docs/academic-basis.md +++ /dev/null @@ -1,393 +0,0 @@ -# Akademische Basis — Neue Skills - -Stand: 2026-06-08 | Alle Kurs-URLs verifiziert und Inhalte gefetched. - ---- - -## Topic 1: AI / LLM Engineering → `design-llm` + `review-llm` - -### Stanford CS224N — Natural Language Processing with Deep Learning (Winter 2026) - -**Professoren:** Diyi Yang, Yejin Choi (früher: Christopher Manning) -**URL:** https://web.stanford.edu/class/cs224n/ -**Slides:** Öffentlich (PDFs per Lecture auf der Course-Page) - -| Datum | Lecture | -|---|---| -| Jan 6 | History of NLP | -| Jan 8 | Word Vectors | -| Jan 13 | Backpropagation and Neural Network Basics | -| Jan 15 | Language Models and RNNs | -| Jan 20 | Transformers | -| Jan 22 | Final Projects: Practical Tips | -| Jan 27 | **Pretraining (Scaling, Systems, Data)** | -| Jan 29 | **Post-training (RLHF, SFT, DPO)** | -| Feb 3 | **Efficient Adaptation (Prompting + PEFT / LoRA)** | -| Feb 5 | **Agents, Tool Use, and RAG** | -| Feb 10 | **Benchmarking and Evaluation** | -| Feb 12 | Reasoning 1 | -| Feb 17 | Reasoning 2 | -| Feb 19 | Guest: Tokenization and Multilinguality (Julie Kallini) | -| Feb 24 | Guest: Interpretability (Been Kim) | -| Feb 26 | Social and Broader Impacts of NLP (Risks) | -| Mar 3 | Guest: Multimodality (Luke Zettlemoyer) | -| Mar 5 | Guest: LoRA and Fine-tuning (John Schulman) | -| Mar 10 | Open Questions in NLP 2026 | - -**Für design-llm relevant:** Lectures 7–11 (Post-training, PEFT, RAG, Agents, Evaluation) - ---- - -### CMU 11-667 — Large Language Models: Methods and Applications (Spring 2026) - -**URL:** https://cmu-llms.org/schedule/ -**Slides:** Öffentlich (Google Cloud Storage PDFs) - -| Datum | Lecture | -|---|---| -| Jan 13 | Origins of LLMs | -| Jan 15 | Natural language understanding vs. generation | -| Jan 20 | **The science of prompting** | -| Jan 22 | **Deciding when to finetune and finetuning efficiently** | -| Jan 27 | Learning representations and embeddings | -| Jan 29 | **Retrieval 1: Storing and retrieving knowledge** | -| Feb 3 | **Retrieval 2: RAG and deep research** | -| Feb 5 | **Retrieval 3: RAG and deep research (continued)** | -| Feb 10 | Deep research | -| Feb 12 | Task-Oriented Dialogue | -| Feb 17 | **Tool-use, chitchat, personas, and companionship** | -| Feb 19 | Writing and ideation assistants | -| Feb 24 | **LLMs for evaluation: Synthetic data, simulation, AI-as-judge** | -| Feb 26 | **Multi-agent systems** | -| Mar 10 | **Harms caused by LLM applications** | -| Mar 12 | **Attacking LLMs and LLM applications** | -| Mar 17 | Code-writing assistants (guest: Zora Wang) | -| Apr 7 | Numbers | -| Apr 16 | **Deployment** | - -**Für design-llm relevant:** Prompting, Finetune-Entscheidung, RAG (3 Lectures), Tool-Use, Multi-Agent, Deployment, Evaluation - ---- - -### Berkeley CS294/194-196 — Large Language Model Agents (Fall 2024) - -**Instructor:** Dawn Song (UC Berkeley) — Gastvortragsformat -**URL:** https://rdi.berkeley.edu/llm-agents/f24 -**Slides + Videos:** Öffentlich (PDFs + YouTube per Lecture) - -| Datum | Lecture | Speaker | YouTube | -|---|---|---|---| -| Sep 9 | LLM Reasoning | Denny Zhou (Google DeepMind) | https://youtu.be/QL-FS_Zcmyo | -| Sep 16 | LLM Agents: Brief History and Overview | Shunyu Yao (OpenAI) | https://youtu.be/RM6ZArd2nVc | -| Sep 23 | Agentic AI Frameworks & AutoGen / Multimodal Knowledge Assistant | Chi Wang + Jerry Liu (LlamaIndex) | https://youtu.be/OOdtmCMSOo4 | -| Sep 30 | Enterprise Trends for Generative AI | Burak Gokturk (Google) | https://youtube.com/live/Sy1psHS3w3I | -| Oct 7 | **Compound AI Systems & the DSPy Framework** | Omar Khattab (Databricks) | https://youtube.com/live/JEMYuzrKLUw | -| Oct 14 | **Agents for Software Development** | Graham Neubig (CMU) | https://youtube.com/live/f9L9Fkq-8K4 | -| Oct 21 | AI Agents for Enterprise Workflows | Nicolas Chapados (ServiceNow) | https://youtube.com/live/-yf-e-9FvOc | -| Oct 28 | Neural & Symbolic Decision Making | Yuandong Tian (Meta AI) | https://youtube.com/live/wm9-7VBpdEo | -| Nov 4 | Project GR00T: Generalist Robotics | Jim Fan (NVIDIA) | https://youtube.com/live/Qhxr0uVT2zs | -| Nov 18 | Open-Source and Science in Foundation Models | Percy Liang (Stanford) | https://youtube.com/live/f3KKx9LWntQ | -| Nov 25 | **Measuring Agent Capabilities + Anthropic's RSP** | Ben Mann (Anthropic) | https://youtube.com/live/6y2AnWol7oo | -| Dec 2 | **Safe & Trustworthy AI Agents** | Dawn Song (UC Berkeley) | https://youtube.com/live/QAgR4uQ15rc | - -**Für design-llm relevant:** Compound AI Systems, Agents for Software Development, Safety/Guardrails (Anthropic RSP), Evaluation - ---- - -### MIT 6.5940 — TinyML and Efficient Deep Learning Computing (Fall 2024) - -**Professor:** Song Han -**URL:** https://hanlab.mit.edu/courses/2024-fall-65940 -**Slides + Videos:** Öffentlich (Dropbox + YouTube) - -LLM-spezifisches Kapitel (Chapter II): - -| # | Datum | Lecture | -|---|---|---| -| 12 | Oct 17 | **Transformer and LLM** | -| 13 | Oct 22 | **Efficient LLM Deployment** | -| 14 | Oct 24 | **LLM Post Training (Quantization etc.)** | -| 15 | Oct 29 | **Long Context LLM** | - -**Für design-llm relevant:** Inference-Optimierung, Quantization, Long-Context-Handling, Deployment-Tradeoffs - ---- - -### Kanonische Bücher — AI/LLM Engineering - -| Buch | Autor | Verlag | Relevanz | -|---|---|---|---| -| Build a Large Language Model from Scratch | Sebastian Raschka | Manning, 2024 | Implementation-Tiefe | -| Designing Machine Learning Systems | Chip Huyen | O'Reilly | Produktion, RAG-Design, Monitoring | -| Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks | Lewis et al. (2020) | arXiv:2005.11401 | RAG — kanonisches Originalpaper | - ---- - -## Topic 2: Observability / SRE → `design-observability` - -**Kernaussage:** Kein Uni-Kurs erreicht die Qualität der Google SRE-Bücher für dieses Thema. Bücher sind hier die primäre Quelle. - -### MIT 6.5840 — Distributed Systems (Spring 2026) - -**Professoren:** Robert Morris, Frans Kaashoek (Guest: Russ Cox) -**URL:** https://pdos.csail.mit.edu/6.824/schedule.html -**Materials:** Lecture Notes (.txt) + Papers öffentlich - -| # | Lecture | Relevanz für Observability | -|---|---|---| -| 1 | Introduction to MapReduce | Grundlage verteilter Systeme | -| 4 | Paxos | Konsistenz-Grundlage | -| 6–7 | Fault Tolerance: Raft (1 & 2) | Fehlertoleranz-Mechanismen | -| 8 | Consistency and Linearizability | Konsistenzmodelle | -| 11 | Distributed Transactions | ACID in verteilten Systemen | -| 15 | Verification of Distributed Systems | Formale Verifikation | -| 16 | Cache Consistency: Memcached at Facebook | Caching in Produktion | -| 17 | AWS Lambda (Marc Brooker, Amazon) | Serverless Reliability | - -**Einschränkung:** Kein SLO/SLI/Error-Budget, kein Incident-Response, kein Alerting-Design. - -### CMU 18-749 — Building Reliable Distributed Systems - -**URL:** https://courses.ece.cmu.edu/18749 -**Materials:** Nicht öffentlich (kein Syllabus abrufbar) - -**Abgedeckte Themen (Kursbeschreibung):** -- Fault-tolerant Design: Replikation, Group Communication, Datenbanken -- Fault-Recovery: Detection, Logging, Checkpointing, Failure Diagnosis -- Fault-Klassen: Crashes, Communication Errors, Software Upgrades -- Real-world Incident Case Studies (large-scale downtime) -- Cloud-Computing-Platform Reliability -- Projekt: Design + Implementierung + empirische Evaluation eines zuverlässigen Systems - -### Kanonische Bücher — Observability / SRE - -Diese Bücher sind definitiv besser als jeder Uni-Kurs für dieses Thema: - -| Buch | Autor | Verlag | Relevanz | Frei? | -|---|---|---|---|---| -| Site Reliability Engineering | Beyer, Jones, Petoff, Murphy | O'Reilly, 2016 | SLO/SLI, Error Budgets, Monitoring, On-Call, Incident Management | ✅ sre.google/sre-book | -| The Site Reliability Workbook | Beyer et al. | O'Reilly, 2018 | Implementierung von SLO/Error-Budget-Policies | ✅ sre.google/workbook | -| Building Secure & Reliable Systems | Google | O'Reilly, 2020 | Reliability als Design-Eigenschaft | ✅ sre.google/books | -| Observability Engineering | Charity Majors, Liz Fong-Jones, George Miranda | O'Reilly, 2022 | Distributed Tracing, Structured Logging, 3 Pillars in Praxis | ❌ Kauf | - ---- - -## Topic 3: CI/CD Pipeline Design → `design-cicd` - -**Kernaussage:** Wie bei SRE — Industrie-Bücher (insbes. "Accelerate") sind besser als jeder Uni-Kurs. - -### CMU 17-636 — DevOps: Engineering for Secure Development and Deployment - -**URL:** https://mse.s3d.cmu.edu/applicants/course-offerings.html (Suche: 17-636) -**Materials:** Nicht öffentlich - -**Abgedeckte Themen:** -- Cloud-Infrastruktur und Container-Management (Docker, Kubernetes) -- Virtual Machines, Container, Netzwerke -- Internet Security Mechanisms, Credential Management -- Produktions-Monitoring durch Log Collection und Analyse -- Case Studies: MLOps und regulierte Umgebungen - -**Einschränkung:** Kein DORA-Metrics-Framework, kein Trunk-Based-Development, kein Deployment-Strategy-Design (Blue-Green, Canary, Feature Flags) als explizite Themen. - -### UC Berkeley / Jez Humble — LAPM (Lean/Agile Product Management) - -**Status:** Domain `lapm.continuousdelivery.com` zum Zeitpunkt der Recherche nicht erreichbar (refused connection). Kurs möglicherweise eingestellt. - -**Inhalt bekannt aus:** Jez Humble's Bücher (unten), die das gleiche Material abdecken. - -### Kanonische Bücher — CI/CD - -| Buch | Autor | Verlag | Relevanz | Frei? | -|---|---|---|---|---| -| Continuous Delivery | Jez Humble, David Farley | Addison-Wesley, 2010 | Deployment-Pipeline-Architektur, Release-Strategien, Environment-Design | ❌ | -| Accelerate | Forsgren, Humble, Kim | IT Revolution, 2018 | DORA-Metriken (empirisch belegt), Trunk-Based-Dev, CD als Prädiktor | ❌ | -| The DevOps Handbook | Kim, Humble, Debois, Willis | IT Revolution, 2016 | Three Ways, praktische Implementierung | ❌ | -| DORA State of DevOps Report 2024 | DORA Research Team | Google | Aktuelle Metriken, 24 DevOps-Capabilities | ✅ dora.dev | - ---- - -## Topic 4: Accessibility → `tool-a11y` - -### CMU HCII 05-332 / 05-632 — Introduction to Accessibility and Assistive Technology - -**Professor:** Patrick Carrington -**URL:** https://hcii.cmu.edu/course/introduction-accessibility-and-assistive-technology -**Materials:** Nicht öffentlich (12 Units, Herbstsemester) - -**Abgedeckte Themen:** -- Accessibility-Theorie, Geschichte, Policy und Praxis in Computing -- Disability Studies und HCI-Perspektive -- Web Accessibility (insbes. Blind/Low-Vision) -- Designing für Hearing Loss, Motor Impairments, kognitive Einschränkungen, Neurodiversität -- Permanent / situational / temporary disabilities — universelles Design-Prinzip -- Assistive Technologies: TTS, Speech Recognition, OCR, Predictive Typing, Tactile Displays -- Wie Behinderung Mainstream-Technologien geprägt hat (Speech Recognition als AT-Ursprung) - -### W3C WAI — Digital Accessibility Foundations (edX, gratis) - -**URL:** https://www.w3.org/WAI/courses/foundations-course/ -**Dauer:** 16–20 Stunden, selbst-getaktet. Verfügbar bis mindestens November 2026. -**Materials:** Öffentlich auf edX (kostenloser Audit) - -| Modul | Sektionen | Inhalt | -|---|---|---| -| 1: What is Web Accessibility | 2 | Definitionen, Missverständnisse | -| 2: People and Digital Technology | 5 | Disability-Typen, Interaktion mit Assistive Technology, Videos: Low Vision, Text Wrapping | -| 3: Business Case and Benefits | 2 | Marktreichweite, rechtliches Risiko, Innovation | -| 4: Principles, Standards, and Checks | 5 | **WCAG-Anforderungen bis AAA**, Barrieren evaluieren, non-technische + technische Guidance, Headings/Motion-Videos | -| 5: Getting Started with Accessibility | 2 | Integration in Design-Prozess, Integration in Entwicklungsprozess | - -### Normative Standards + Kanonische Quellen - -| Quelle | Typ | Relevanz | Frei? | -|---|---|---|---| -| W3C WCAG 2.2 | Standard | Die normative Quelle — 78 Success Criteria in 3 Levels (A/AA/AAA) | ✅ w3.org/WAI/WCAG22 | -| W3C WAI Curricula on Web Accessibility | Framework | Modul-Struktur für Developer, Designer, Content Authors | ✅ w3.org/WAI/curricula/ | -| Deque University | Training | WCAG 2.2 spezifisch + Screen-Reader-Testing (NVDA, JAWS, VoiceOver) + Audit-Methodik | ❌ | -| EU EN 301 549 | Norm | Europäischer Standard, mappt auf WCAG — direkt relevant für EU Accessibility Act (ab Juni 2025) | ✅ | - ---- - -## Topic 5: Infrastructure as Code → `design-iac` - -### NTNU IIKG3005 — Infrastructure as Code - -**URL:** https://www.ntnu.edu/studies/courses/IIKG3005 -**Credits:** 7.5 ECTS | Sprache: Norwegisch -**Nächster Start:** Herbst 2026 -**Materials:** Nicht öffentlich (Pflichtübungen + 3h Klausur) - -**Learning Outcomes:** - -*Wissen:* -- Infrastruktur-Management mit Software-Development-Prinzipien -- IaC-Konzepte und Tools -- Große Public-Cloud-Plattformen - -*Fähigkeiten:* -- IT-Infrastruktur per Code provisionieren und verwalten -- Versionskontrolle für Infrastruktur -- Informierte Tool-Auswahl treffen -- Änderungen in Produktion über versionierte Repositories einbringen - -*Kompetenzen:* -- DevOps-Philosophie und -Kultur -- IaC-Implementierungen troubleshooten - -**Hinweis:** Einziger dedizierter akademischer Kurs zu IaC weltweit (ETH Zürich Cloud Computing deckt kein IaC ab). - -### Kanonische Bücher — Infrastructure as Code - -| Buch | Autor | Verlag | Relevanz | Frei? | -|---|---|---|---|---| -| Infrastructure as Code | Kief Morris | O'Reilly, 2nd ed. 2021 | Design-Prinzipien (tool-agnostisch): Dynamic Infrastructure, Drift, GitOps, Testing | ❌ | -| Terraform: Up & Running | Yevgeniy Brikman | O'Reilly, 3rd ed. 2022 | Terraform-spezifisch: Modul-Design, State Management, Terratest | ❌ | -| GitOps and Kubernetes | Yuen, Miell et al. | Manning, 2021 | GitOps als Operational Pattern über IaC | ❌ | - ---- - -## Topic 6: Performance Engineering → `tool-perf` - -### MIT 6.172 — Performance Engineering of Software Systems (Fall 2018) - -**Professoren:** Charles Leiserson, Julian Shun -**URL:** https://ocw.mit.edu/courses/6-172-performance-engineering-of-software-systems-fall-2018/ -**Materials:** Vollständig öffentlich auf MIT OCW — alle 23 Lectures, Slides (PDFs), Videos - -| # | Lecture | -|---|---| -| 1 | Introduction and Matrix Multiplication | -| 2 | **Bentley Rules for Optimizing Work** | -| 3 | Bit Hacks | -| 4 | Assembly Language and Computer Architecture | -| 5 | C to Assembly | -| 6 | Multicore Programming | -| 7 | Races and Parallelism | -| 8 | Analysis of Multithreaded Algorithms | -| 9 | What Compilers Can and Cannot Do | -| 10 | **Measurement and Timing** | -| 11 | Storage Allocation | -| 12 | Parallel Storage Allocation | -| 13 | The Cilk Runtime System | -| 14 | **Caching and Cache-Efficient Algorithms** | -| 15 | Cache-Oblivious Algorithms | -| 16 | Nondeterministic Parallel Programming | -| 17 | Synchronization Without Locks | -| 18 | Domain Specific Languages and Autotuning | -| 19 | Leiserchess Codewalk | -| 20 | Speculative Parallelism & Leiserchess | -| 21 | Tuning a TSP Algorithm | -| 22 | Graph Optimization | -| 23 | High Performance in Dynamic Languages | - -**Einschränkung:** Low-Level Perf (CPU, Cache, Parallelism). Kein Web-Scale Load Testing, kein Queuing-Theory, kein Capacity Planning. - ---- - -### CMU 15-721 — Advanced Database Systems (Spring 2024) - -**Professor:** Andy Pavlo -**URL:** https://15721.courses.cs.cmu.edu/spring2024/schedule.html -**Materials:** Alle Slides (PDFs) + Videos öffentlich - -| # | Datum | Lecture | -|---|---|---| -| 01 | Jan 22 | Modern Analytical Database Systems | -| 02–03 | Jan 24–29 | **Data Formats & Encoding (I & II)** | -| 04–05 | Feb 5–7 | **Query Execution & Processing (I & II)** | -| 06 | Feb 12 | **Vectorized Query Execution** | -| 07 | Feb 14 | **Code Generation & Compilation** | -| 08 | Feb 19 | Scheduling & Coordination | -| 09 | Feb 21 | **Hash Join Algorithms** | -| 10 | Feb 26 | Multi-Way Join Algorithms | -| 11 | Mar 11 | Server-side Logic Execution | -| 12 | Mar 13 | Networking Protocols | -| 13–15 | Mar 18–25 | **Optimizer Implementation (I–III)** | -| 16 | Apr 1 | **Cost Models** | -| 17 | Apr 8 | System Analysis: Google Dremel/BigQuery | -| 18 | Apr 10 | System Analysis: Databricks/Spark | -| 19 | Apr 15 | System Analysis: Snowflake | -| 20 | Apr 17 | System Analysis: DuckDB | -| 21 | Apr 22 | System Analysis: Yellowbrick | -| 22 | Apr 24 | System Analysis: Amazon Redshift | - ---- - -### UT Austin CS395T — Performance Analysis of Networked Systems (Spring 2024) - -**Professor:** Venkat Arun -**URL:** https://www.cs.utexas.edu/~venkatar/performance_analysis_of_networked_systems.html -**Materials:** Canvas (nicht öffentlich) - -| Lectures | Thema | Methoden | -|---|---|---| -| 1–3 | Switch Load Balancing | PIM, iSLIP, Valiant Load Balancing | -| 4–5 | Application Load Balancing | Power of Two Choices, Breakwater | -| 6–7 | Process Scheduling | Work Stealing, Linux Scheduler Analysis | -| 8–10 | Fairness | Alpha Fairness, Multi-Resource Fairness | -| 11–12 | Caching Policies | LRU Analysis | -| 13–15 | ML in Systems | Competitive Caching, Statistische Ansätze | -| 16–18 | Computational Complexity in Systems | Traffic Engineering, Optimization | -| 19–21 | **Congestion Control** | AIMD, Vegas, RCP, DCTCP | -| 22–26 | **Performance Verification & Abstractions** | fPerf, PIFO, Network Slicing | - -### Kanonische Bücher — Performance Engineering - -| Buch | Autor | Verlag | Relevanz | Frei? | -|---|---|---|---|---| -| Systems Performance: Enterprise and the Cloud | Brendan Gregg | Addison-Wesley, 2nd ed. 2020 | **USE Method, Flamegraphs, Profiling-Methodik, Linux Perf Tools** — besser als MIT 6.172 für applied performance | ❌ | -| The Art of Capacity Planning | John Allspaw | O'Reilly, 2008 | Capacity Planning Methodik | ❌ | - ---- - -## Übersicht: Primärquellen pro Skill - -| Skill | Primäre akademische Quelle | Kanonisches Buch | -|---|---|---| -| `design-llm` | Stanford CS224N + CMU 11-667 + Berkeley CS294-196 | Chip Huyen "Designing ML Systems" | -| `design-observability` | Google SRE Books (Industrie > Uni) | "Observability Engineering" (Majors/Fong-Jones) | -| `design-cicd` | "Accelerate" + DORA Research (Industrie > Uni) | "Continuous Delivery" (Humble/Farley) | -| `tool-a11y` | CMU HCII 05-332 + W3C WAI Digital Foundations | WCAG 2.2 (W3C, normativ) | -| `design-iac` | NTNU IIKG3005 | "Infrastructure as Code" (Kief Morris) | -| `tool-perf` | MIT 6.172 (vollständig auf OCW) | "Systems Performance" (Brendan Gregg) | diff --git a/docs/gap-analysis.md b/docs/gap-analysis.md deleted file mode 100644 index 7d16b55..0000000 --- a/docs/gap-analysis.md +++ /dev/null @@ -1,106 +0,0 @@ -# Gap Analysis — dev-best-practices - -Stand: 2026-06-08 | Zuletzt aktualisiert: 2026-06-08 - -## Strukturelle Bugs (Quick Fixes) - -| Problem | Impact | Status | -|---|---|---| -| `commands/design-ux.md` fehlt | Slash-Command-Discovery findet `/dev:design-ux` nicht | ✅ Behoben | -| `commands/review-ux.md` fehlt | Slash-Command-Discovery findet `/dev:review-ux` nicht | ✅ Behoben | -| Skill-Count-Drift: README/plugin.json = "17", commands/ = 15 | Inkonsistente Kommunikation nach außen | ✅ Behoben (plugin.json = 19, commands/ = 20 inkl. meta-help) | - -## Trigger-Qualität (Skill Discovery) - -| Problem | Betroffene Skills | Status | -|---|---|---| -| Overlap-Dreieck ohne Abgrenzung | `review-app`, `review-arch`, `review-secure` | ✅ Behoben — review-app erklärt Abgrenzung explizit | -| Fehlende deutsche Trigger | `review-arch`, `review-secure` | ✅ Behoben — deutsche Trigger-Zeilen ergänzt | -| Meta-Skill ohne Scope-Guard | `meta-sync` | ✅ Behoben — "nur für dev-best-practices Repo" ergänzt | - ---- - -## Inhaltliche Lücken + Akademische Verankerung - -| Bereich | Skill | Prio | Status | Akademische Basis (verifiziert) | Kanonische Bücher | -|---|---|---|---|---|---| -| **AI/LLM Engineering** | `design-llm` + `review-llm` | Hoch | ✅ Erledigt (#14) | Stanford CS224N; CMU 11-667; Berkeley CS294-196; MIT 6.5940 | Chip Huyen "Designing ML Systems"; Raschka "Build an LLM from Scratch" | -| **Observability / SRE** | `design-observability` | Mittel | ✅ Erledigt | CMU 18-749; MIT 6.5840 | Google SRE Book (free); Site Reliability Workbook (free); "Observability Engineering" (Majors/Fong-Jones) | -| **CI/CD Pipeline Design** | `design-cicd` | Mittel | ✅ Erledigt | CMU 17-636; Jez Humble (Berkeley) | "Continuous Delivery" (Humble/Farley); "Accelerate" (Forsgren/Humble/Kim); DORA Report 2024 (free) | -| **Accessibility** | `tool-a11y` | Mittel | ✅ Erledigt | CMU HCII 05-332/632; W3C WAI Digital Foundations (edX) | WCAG 2.2 (normativ, free); EU EN 301 549 | -| **Infrastructure as Code** | `design-iac` | Niedrig | ✅ Erledigt | NTNU IIKG3005 (einziger dedizierter Kurs weltweit) | "Infrastructure as Code" (Kief Morris); "Terraform: Up & Running" (Brikman) | -| **Performance Engineering** | `tool-perf` | Niedrig | ✅ Erledigt | MIT 6.172 (vollständig auf OCW); CMU 15-721; UT Austin CS395T | "Systems Performance" (Brendan Gregg) — USE Method + Flamegraphs | -| **design-migration vertiefen** | `design-migration` | Niedrig | ✅ Erledigt | Bereits: Fowler + MIT 6.5840 | Kleppmann "Designing Data-Intensive Applications" | - -### Korrekturen gegenüber erster Einschätzung - -- `MIT 6.S965` ist **nicht** ein LLM-Kurs — das ist TinyML/Efficient DL (Song Han). Korrekte Nummer: `MIT 6.5940` -- `CMU 17-814` als SRE-Kurs existiert nicht im aktuellen CMU-Katalog → ersetzt durch `CMU 18-749` -- Für **SRE/Observability** und **CI/CD**: kein Uni-Kurs ist so gut wie die kanonischen Industrie-Bücher (Google SRE trilogy, Accelerate) — das ist für diese zwei Themen der Normalfall, nicht die Ausnahme - ---- - -## Recherche-Methodik - -So entstehen die akademischen Grundlagen für neue Skills — analog zu den bestehenden (CMU 17-625 → design-api, CMU 15-445 → design-data, TU Graz ISEC → design-secure): - -### Schritt 1 — Universitäten mit starken Curricula identifizieren - -**DACH + Europa:** -- TU Graz — [TUGRAZonline](https://online.tugraz.at) -- TU Wien — [TISS](https://tiss.tuwien.ac.at) -- ETH Zürich — [Course Catalogue](https://www.vvz.ethz.ch) -- EPFL Lausanne -- NTNU Trondheim (stark in IaC/DevOps) -- LMU München, KIT Karlsruhe, Universität Wien - -**UK:** -- University of Cambridge — Computer Science Tripos -- University of Oxford — CS Department -- Imperial College London -- University of Edinburgh - -**USA (Top-Tier):** -- Stanford — [CS Courses](https://explorecourses.stanford.edu) -- MIT — [OCW](https://ocw.mit.edu) + [Course Catalog](https://student.mit.edu/catalog) -- CMU — [SCS Course Listings](https://csd.cmu.edu/course-profiles) -- UC Berkeley — [CS Courses](https://www2.eecs.berkeley.edu/Courses/CS/) -- Caltech, Harvard, Princeton, Cornell, UW Paul G. Allen School, UT Austin - -### Schritt 2 — Lehrveranstaltungsbeschreibungen fetchen - -1. Kursverzeichnis öffnen, relevante Kursnummern identifizieren -2. Kursbeschreibung + Syllabus fetchen: Lernziele, Themenübersicht, Literaturliste -3. Öffentlich zugängliche Materialien prüfen: MIT OCW, Stanford Engineering Everywhere, CMU-öffentliche Slides/Videos -4. Prüfen: Deckt der Kurs die benötigte Tiefe ab? Korrektheit der Kursnummer verifizieren (MIT/CMU renumbern regelmäßig) - -### Schritt 3 — Inhalte aufbauen - -Analog zu den bestehenden Skills: -- Skill-Beschreibung verankert explizit den Kurs (`grounded in CMU 17-625`) -- Workflow-Schritte folgen der Kurs-Logik -- `references/curriculum-mapping.md` mappt jeden Inhaltspunkt auf konkrete Lehrveranstaltung oder Buch-Kapitel -- Externe Links zeigen auf öffentliche Kurs-URLs (Slides, OCW, Syllabus) -- **Ausnahme:** Wenn Industrie-Bücher besser sind als Uni-Kurse (SRE, CI/CD), werden Bücher als primäre Quelle verwendet — mit Angabe von Kapitel und Seite - -### Qualitätsanker — bestehende Verankerungen als Maßstab - -| Skill | Primäre Quelle | Typ | -|---|---|---| -| design-secure | TU Graz ISEC + Stanford CS255/CS355 + MIT 6.566 | Uni-Kurse | -| design-data | CMU 15-445 (Andy Pavlo) | Uni-Kurs | -| design-ux | CMU HCII + Stanford CS247A + HAX/PAIR/CHI2024 | Uni + Frameworks | -| review-arch | CMU 17-633 (David Garlan) | Uni-Kurs | -| review-secure | TU Graz ISEC + Stanford CS255/CS355 + CMU 15-414 | Uni-Kurse | -| review-app | OWASP ASVS 5.0 + DORA | Industrie-Standards | - ---- - -## Stärken (zur Orientierung) - -- Security (ASVS 5.0, STRIDE, Crypto) — sehr gut -- Architektur (CMU 17-633, Fowler) — gut -- API Design (CMU 17-625, Google API Guide) — gut -- Human-AI Interaction (HAX/PAIR/CHI/NNG) — einzigartig -- Drei-Schichten-Struktur (reference → rules → skills) — besser als alle Community-Alternativen -- Mirror-Sync + Drift-Detection (meta-sync/meta-drift) — gibt's sonst nirgends diff --git a/docs/skill-research-basis.md b/docs/skill-research-basis.md new file mode 100644 index 0000000..7af3201 --- /dev/null +++ b/docs/skill-research-basis.md @@ -0,0 +1,112 @@ +# Academic & Industry Sources — Dev Skills + +Kanonische Quellen pro Skill. Massgeblich fuer: +- Verifikation akademischer Verankerung bei neuen Skills +- Nachschlagen von Kurs-Nummern und Literaturangaben +- Orientierung beim Ausbauen bestehender Skills + +--- + +## design-llm + review-llm + +| Quelle | Typ | Inhalt | +|---|---|---| +| Stanford CS224N (Winter 2026) | Uni-Kurs | Lectures 7–11: Post-training, PEFT/LoRA, RAG, Agents, Evaluation — Slides oeffentlich | +| CMU 11-667 (Spring 2026) | Uni-Kurs | Prompting, Finetune-Entscheidung, RAG (3 Lectures), Tool-Use, Multi-Agent, Deployment — Slides oeffentlich | +| Berkeley CS294-196 (Fall 2024) | Gastvortraege | Compound AI, Agents for Software Dev, Safety/Guardrails (Anthropic RSP) — Videos oeffentlich | +| MIT 6.5940 (Fall 2024) | Uni-Kurs | Chapter II: Efficient LLM Deployment, Quantization, Long-Context — Slides + Videos oeffentlich | +| Chip Huyen "Designing ML Systems" | Buch | RAG-Design, Monitoring, Production — O'Reilly | +| Raschka "Build an LLM from Scratch" | Buch | Implementation-Tiefe — Manning 2024 | + +--- + +## design-observability + +| Quelle | Typ | Inhalt | +|---|---|---| +| Google SRE Book (Beyer et al.) | Buch (frei) | SLO/SLI, Error Budgets, Monitoring, On-Call, Incident Management — sre.google/sre-book | +| The Site Reliability Workbook | Buch (frei) | SLO/Error-Budget-Policy Implementierung — sre.google/workbook | +| Observability Engineering (Majors/Fong-Jones) | Buch | Distributed Tracing, Structured Logging, 3 Pillars — O'Reilly 2022 | +| MIT 6.5840 — Distributed Systems | Uni-Kurs | Fault Tolerance, Consistency, Linearizability — pdos.csail.mit.edu/6.824 | +| CMU 18-749 — Building Reliable Distributed Systems | Uni-Kurs | Replikation, Failure Detection, Incident Case Studies — courses.ece.cmu.edu/18749 | + +--- + +## design-cicd + +| Quelle | Typ | Inhalt | +|---|---|---| +| "Accelerate" (Forsgren/Humble/Kim) | Buch | DORA-Metriken empirisch belegt, Trunk-Based Dev, CD als Praediktor — IT Revolution 2018 | +| "Continuous Delivery" (Humble/Farley) | Buch | Deployment-Pipeline-Architektur, Release-Strategien, Environment-Design — Addison-Wesley 2010 | +| DORA State of DevOps Report 2024 | Report (frei) | Aktuelle Metriken, 24 DevOps-Capabilities — dora.dev | +| CMU 17-636 — DevOps: Engineering for Secure Development | Uni-Kurs | Cloud-Infrastruktur, Container, Monitoring — mse.s3d.cmu.edu | + +--- + +## tool-a11y + +| Quelle | Typ | Inhalt | +|---|---|---| +| W3C WCAG 2.2 | Standard (frei) | 78 Success Criteria A/AA/AAA, normativ — w3.org/WAI/WCAG22 | +| W3C WAI Digital Accessibility Foundations | Kurs (frei, edX) | WCAG, Disability-Typen, AT, Design-Integration — w3.org/WAI/courses/foundations-course | +| EU EN 301 549 | Norm (frei) | Europaeischer Standard, mappt auf WCAG — relevant fuer EU Accessibility Act (ab Juni 2025) | +| CMU HCII 05-332/632 — Introduction to Accessibility | Uni-Kurs | Disability Studies, Web Accessibility, Assistive Technologies — hcii.cmu.edu | + +--- + +## design-iac + +| Quelle | Typ | Inhalt | +|---|---|---| +| Kief Morris "Infrastructure as Code" | Buch | Design-Prinzipien tool-agnostisch: Dynamic Infrastructure, Snowflake Anti-Pattern, Drift, GitOps, Testing — O'Reilly 2nd ed. 2021 | +| Yevgeniy Brikman "Terraform: Up & Running" | Buch | Modul-Design, State Management, Terratest — O'Reilly 3rd ed. 2022 | +| NTNU IIKG3005 — Infrastructure as Code | Uni-Kurs | 7.5 ECTS, IaC-Konzepte, Tool-Auswahl, Versionskontrolle fuer Infra — ntnu.edu/studies/courses/IIKG3005 | + +--- + +## tool-perf + +| Quelle | Typ | Inhalt | +|---|---|---| +| Brendan Gregg "Systems Performance" | Buch | USE Method, Flamegraphs, Profiling-Methodik, Linux Perf Tools — Addison-Wesley 2nd ed. 2020 | +| MIT 6.172 — Performance Engineering of Software Systems | Uni-Kurs (frei) | Bentley Rules (Lec 2), Measurement & Timing (Lec 10), Caching (Lec 14) — vollstaendig auf OCW | +| CMU 15-721 — Advanced Database Systems (Spring 2024) | Uni-Kurs (frei) | Query Execution, Vectorized Execution, Optimizer — 15721.courses.cs.cmu.edu | + +--- + +## design-migration + +| Quelle | Typ | Inhalt | +|---|---|---| +| Martin Fowler — Patterns (bliki) | Blog/Patterns | Strangler Fig, Branch by Abstraction, Expand-Contract, Blue-Green, Feature Toggles — martinfowler.com | +| Kleppmann "Designing Data-Intensive Applications" | Buch | Kap. 4: Schema Evolution, Forward/Backward Compatibility; Kap. 11: Dual-Write, CDC, Event Log — O'Reilly 2017 | +| MIT 6.5840 — Distributed Systems | Uni-Kurs | Two-Phase Commit, CAP Theorem, Consistency — pdos.csail.mit.edu/6.824 | +| Chris Richardson — Saga Pattern | Pattern-Referenz | Choreography vs. Orchestration Saga — microservices.io/patterns/data/saga | + +--- + +## Bestehende Skills (v1.0.0) + +| Skill | Primärquelle | +|---|---| +| design-secure | TU Graz ISEC + Stanford CS255/CS355 + MIT 6.566 | +| design-data | CMU 15-445 (Andy Pavlo) — 15445.courses.cs.cmu.edu | +| design-api | CMU 17-625 + Google API Design Guide | +| design-ux | CMU HCII + Stanford CS247A + HAX/PAIR/CHI 2024 | +| review-arch | CMU 17-633 (David Garlan) | +| review-app | OWASP ASVS 5.0 + DORA | + +--- + +## Recherche-Methodik fuer neue Skills + +**Vorgehen:** Universitaeten mit oeffentlichen Syllabi → Lehrveranstaltungsbeschreibungen fetchen → Inhalte auf Kurs-Logik aufbauen → `references/curriculum-mapping.md` mappt jeden Skill-Schritt auf konkrete Quelle. + +**Ausnahme:** Wenn Industrie-Buecher besser sind als Uni-Kurse (SRE, CI/CD), werden Buecher als Primaerquelle verwendet. + +**Kurs-Verzeichnisse:** +- MIT OCW: ocw.mit.edu (viele Kurse vollstaendig oeffentlich) +- CMU SCS: csd.cmu.edu/course-profiles +- Stanford: explorecourses.stanford.edu +- NTNU: ntnu.edu/studies/courses +- TU Graz: online.tugraz.at diff --git a/plugins/dev/.claude-plugin/plugin.json b/plugins/dev/.claude-plugin/plugin.json index 6764cc5..7c1f18d 100644 --- a/plugins/dev/.claude-plugin/plugin.json +++ b/plugins/dev/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "dev", - "version": "1.3.0", + "version": "2.0.0", "description": "24 Skills für Design (inkl. LLM-Engineering/RAG/Agents, Observability/SRE, CI/CD, IaC/GitOps, UX/Human-AI Interaction), Security-Review (ISEC/Stanford/MIT, OWASP LLM Top 10), App-Audit (OWASP ASVS 5.0, DORA), Architektur-Review, Debug, Test, Styling, Accessibility (WCAG 2.2), Performance Engineering (MIT 6.172, USE Method) und Skill-Erstellung.", "author": { "name": "Gerald" } }