[RELEASE] Unit 3 and 3.1 for 12/6/25 #83
Merged
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 unit 3 covering MCP workflow servers and tool composition for Claude Code - Add unit 4 covering remote MCP deployment with Cloudflare Workers - Update table of contents to include new units with proper navigation - Include OAuth 2.1 authentication and production deployment patterns - Standardize deployment examples to use Cloudflare Workers platform
- 5-module structure with jump-in-anywhere design - Local toy to production pipeline approach - Cloudflare Tunnel integration for seamless Unit 4 transition - Specific quiz contribution areas for @burtenshaw - Free-tier compatibility throughout - Complete code examples and starter templates planned quick fix
• Add comprehensive 5-module structure for Unit 3 focusing on MCP server development • Implement Module 1 with PR template suggestion tool using Anthropic's Claude API • Include starter code, solution code, and manual testing guide for Module 1 • Add PR templates (bug, feature, docs, performance, refactor, security, test) • Create detailed implementation plans and module introductions • Add screenshot demonstrating MCP server in action • Structure modules with progressive complexity from basic tools to advanced deployments • Update table of contents to reflect new unit structure • Remove placeholder Unit 4 content
Restructure anthropic unit3
- Move unit3 starter and solution code to build-mcp-server subdirectory - Update documentation paths to reflect new directory structure - No functional changes to the code
- Implement MCP Resources for project context and team guidelines - Add solution with four resource types: templates, team guidelines, git history, and review process - Create starter code building on Module 1 solution - Add comprehensive documentation and solution walkthrough - Create shared team-guidelines directory with coding standards and PR guidelines - Include manual testing guide for resource validation - Update Module 1 comment to reflect templates are shared across all modules
- Update all configuration examples to use claude mcp add command - Remove references to claude_desktop_config.json - Remove import-from-desktop instructions - Simplify setup process for learners - Focus exclusively on Claude Code usage
- Add -- separator before uv command to properly pass arguments - Remove quotes around individual arguments - Fix command parsing error with --directory flag
- Removed smart-file-analysis module and all Resources references - Renumbered modules: GitHub Actions (2), HF Hub (3), Slack (4) - Updated all cross-references and documentation - Focused on Tools and Prompts as core MCP primitives The full Module 2 implementation is preserved at tag: preserve-module2-resources-full
- Implement webhook server to receive GitHub Actions events - Add tools to query workflow status and recent events - Create 4 MCP prompts for CI/CD workflows - Use file-based event storage for simplicity - Provide comprehensive testing documentation - Include starter code with clear TODOs for learners Module 2 teaches: - How to integrate external webhooks with MCP - Creating standardized workflows with prompts - Real-time CI/CD monitoring in Claude Code
- Remove Hugging Face Hub Integration module (will be in separate PR #69) - Restructure Unit 3 to 3 modules: Build MCP Server, GitHub Actions, Slack Notification - Build complete Slack Notification module demonstrating Tools + Prompts integration - Add comprehensive manual testing with curl commands for easy verification - Include security guidance for webhook URLs and environment variables - Fix Slack markdown formatting with proper <url|text> syntax - Create complete starter/solution project structure
This commit addresses all feedback from PR #50 review ID 2887614471: ## Core Feedback Addressed ✅ ### Content & Learning Experience - Add transitional "glue" statements for less experienced developers - Implement CodeCraft Studios narrative arc connecting all modules - Use MDX blocks (<Tip>, <Tip warning>) for important concepts - Create comprehensive conclusion page summarizing unit takeaways - Add extensive external documentation linking throughout ### Technical Infrastructure - Add missing validation scripts (validate_starter.py) to all modules - Add missing test scripts (test_server.py) to all modules - Fix all scripts to work correctly with both starter and solution code - Add proper Claude Code installation instructions with troubleshooting links ### Documentation & Clarity - Simplify Slack integration with step-by-step guidance - Add context for webhook event storage and retrieval system - Link extensively to official docs (Slack API, MCP, GitHub Actions) - Update table of contents to include conclusion page ## Key Improvements ✨ ### 1. CodeCraft Studios Story Arc - Week 1: PR chaos → Module 1 (PR Agent) - Week 2: Silent failures → Module 2 (CI/CD monitoring) - Week 3: Communication gaps → Module 3 (Slack notifications) - Resolution: Complete automation transformation ### 2. Enhanced Learning Experience - Progressive complexity with clear explanations - Real-world problems that every developer faces - Before/after transformations showing concrete value - Motivational but not overstated language ### 3. Working Testing Infrastructure - Flexible tests work with both starter stubs and full implementations - Fixed validation scripts with proper import-based testing - All scripts pass validation (6/6 checks) across all modules - Instructions match actual script behavior ## Files Modified ### Unit Content - units/en/_toctree.yml (added conclusion) - units/en/unit3/introduction.mdx (CodeCraft setup + installation) - units/en/unit3/build-mcp-server.mdx (Module 1 story + transitions) - units/en/unit3/github-actions-integration.mdx (Module 2 story + context) - units/en/unit3/slack-notification.mdx (Module 3 story + Slack docs) - units/en/unit3/conclusion.mdx (NEW: comprehensive unit summary) ### Testing Infrastructure - projects/unit3/*/starter/validate_starter.py (NEW: working validation) - projects/unit3/*/starter/test_server.py (NEW: flexible async tests) - projects/unit3/*/solution/test_server.py (NEW: fixed solution tests) Result: Unit 3 now provides engaging, accessible, well-documented learning experience that guides developers of all levels through advanced MCP concepts via relatable real-world automation scenarios.
- Module 1: Added comprehensive lesson on handling 25k token limit - Implemented max_diff_lines parameter (default 500) - Added truncation logic with clear messaging - Included test for output limiting - Framed as important real-world learning opportunity - Modules 2 & 3: Pre-included fix so learners can focus on new concepts - Updated all starter and solution code - Added notes that output limiting is already handled - Prevents repetitive debugging of same issue This ensures learners encounter and solve the token limit problem once in Module 1 as a valuable lesson, then can focus on webhooks (Module 2) and Slack integration (Module 3) without distraction. Fixes the issue where large git diffs cause "MCP tool response exceeds maximum allowed tokens (25000)" errors.
- Add roots support to access Claude Code's working directory - Update analyze_file_changes in all modules to use correct cwd - Add documentation about working directory considerations - Include helpful comments in starter code about roots usage
[UNIT] Unit 3: Advanced MCP Development - Custom Workflow Servers
Collaborator
|
The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update. |
- Add video demonstrations for PR chaos problem and solution - Add real-time CI/CD monitoring screencast to GitHub Actions integration - Add complete automation system demonstration to Slack notification module - Update Slack notification format to use rotating_light emoji and cleaner template - Add mrkdwn support to Slack webhook implementation chore: add videos/ directory to .gitignore
docs: add screencasts demonstrating MCP server functionality in Unit 3
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.
No description provided.