feat: modernize AI Engineering curriculum with SDD methodology and context engineering #829
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add comprehensive sections on context windows, context rot (40%+ dumb zone), intentional compaction (60%+ trigger), progressive disclosure, and context tracking - Update estReadingMinutes from 10 to 30 minutes - Include HumanLayer resources (12-Factor Agents, Advanced Context Engineering) - Add /context command documentation for Claude Code and VSCode tools - Expand deliverables with context engineering questions - All markdown linting and front-matter validation passing Related to T1.0 in Spec 98
- Replace 3 workflow sections with 4-stage SDD workflow (Generate Spec → Task Breakdown → Execute with Management → Validate) - Add Liatrio spec-driven-workflow repository link - Embed 'No Vibes Allowed' primary video and reference alternative recording - Add comprehensive examples for each SDD stage with proof artifacts - Integrate context engineering cross-references (40%+ degradation, 60%+ compaction triggers) - Update estReadingMinutes from 30 to 40 minutes - Update Deliverables with 6 SDD-focused questions - Maintain 'Other Practical AI Techniques' section unchanged - All markdown linting passing Related to T2.0 in Spec 98
- Replace Harper Reed workflow question with SDD four-stage workflow question - Add new questions on context rot (40% dumb zone), intentional compaction (60% threshold), progressive disclosure, and proof artifacts - Update existing question about AI limitations to reference context rot - Maintain rawQuizdown format and beginner-appropriate language Related to T3.0 in Spec 98
- Add Claude Code to Agent Tools section in 3.1.2-ai-agents.md - Add Claude Code to Popular Examples list in 3.3.2-agentic-ide.md - Update exercises to mention Claude Code as viable alternative - Include /context command guidance for context monitoring - Maintain VSCode as primary environment throughout Related to T4.0 in Spec 98
- Renamed Exercise 1 from "VSCode Vibing" to "Structured MCP Server Development with SDD" - Renamed Exercise 2 from "Windsurf" to "Structured MCP Server Development with Windsurf IDE" - Added comprehensive four-stage SDD workflow (Generate Spec → Task Breakdown → Execute → Validate) - Added Context Management Tips section with monitoring, compaction, and progressive disclosure guidance - Added Proof Artifacts section explaining what they are and why they matter - Restructured exercise steps to follow four SDD stages with clear checkpoints - Updated Deliverables with SDD-focused questions about workflow application and context management - Added cross-references to 3.3.1 (SDD methodology) and 3.1.4 (context engineering) - All linting and front-matter validation checks passing Related to T5.0 in Spec 98 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Verified cross-references: 3.3.1 → 3.1.4, 3.3.2 → 3.3.1, 3.3.2 → 3.1.4 - Confirmed terminology consistency: context engineering, context rot, intentional compaction, proof artifacts - Validated 12-Factor Agents integration in 3.1.4 Resources section - Verified all external links correctly formatted (HumanLayer, Liatrio, YouTube, MCP resources) - Confirmed logical content progression: Foundations (3.1.4) → Workflows (3.3.1) → Application (3.3.2) - Validated Deliverables sections at end of all files with updated questions - Verified quiz alignment with updated content (SDD workflow, context rot, compaction, proof artifacts) - All linting checks passed (0 errors across 4 markdown files) - Front-matter metadata validated successfully - Reviewed all 5 commits for proper conventions (conventional commits, task references) - Completed comprehensive quality review for beginner-friendliness and clarity - Validated all proof artifacts from Tasks 1.0-5.0 Related to T6.0 in Spec 98 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR modernizes the AI Engineering curriculum (Chapter 3) by replacing the Harper Reed workflow with Liatrio's Spec-Driven Development (SDD) methodology, significantly expanding context engineering coverage, and restructuring exercises for structured learning.
Changes Overview
🎯 Task 1.0: Expand Context Engineering Coverage
docs/3-AI-Engineering/3.1.4-ai-best-practices.md🔄 Task 2.0: Replace Harper Reed Workflow with SDD Methodology
docs/3-AI-Engineering/3.3.1-agentic-best-practices.md📝 Task 3.0: Update Quiz Content
src/quizzes/chapter-3/3.3/agentic-best-practices-quiz.js🛠️ Task 4.0: Modernize Tool Coverage with Claude Code
3.1.2-ai-agents.md,3.3.1-agentic-best-practices.md,3.3.2-agentic-ide.md/contextcommand examples for monitoring utilization📚 Task 5.0: Restructure Exercises with SDD Workflow
docs/3-AI-Engineering/3.3.2-agentic-ide.md✅ Task 6.0: Integration, Cross-References, and Quality Assurance
Impact
For Students
For Curriculum
Testing & Validation
Files Changed
Documentation (4 files)
docs/3-AI-Engineering/3.1.4-ai-best-practices.mddocs/3-AI-Engineering/3.3.1-agentic-best-practices.mddocs/3-AI-Engineering/3.1.2-ai-agents.mddocs/3-AI-Engineering/3.3.2-agentic-ide.mdQuiz (1 file)
src/quizzes/chapter-3/3.3/agentic-best-practices-quiz.jsSpecifications & Proof Artifacts (8 files)
docs/specs/98-spec-ai-engineering-modern-practices/(task file + 6 proof artifacts)Related Work
docs/specs/98-spec-ai-engineering-modern-practices/98-spec-ai-engineering-modern-practices.mddocs/specs/98-spec-ai-engineering-modern-practices/98-tasks-ai-engineering-modern-practices.mddocs/specs/98-spec-ai-engineering-modern-practices/98-proofs/References
🤖 Generated with Claude Code