feat: Complete exercises page with comprehensive progressive challenges#4
Merged
TellMeAlex merged 12 commits intomainfrom Dec 17, 2025
Merged
feat: Complete exercises page with comprehensive progressive challenges#4TellMeAlex merged 12 commits intomainfrom
TellMeAlex merged 12 commits intomainfrom
Conversation
…ement hub-based content architecture - Remove all default Docusaurus tutorial content (tutorial-basics, tutorial-extras) - Create new consolidated documentation structure with 3 pillars: * Proyectos: Taller IA/Agentes/MCP y AI Presentation * Herramientas: Technical guides for dev tools * Arquitectura para IA: Architecture patterns and design decisions - Add comprehensive intro page with project philosophy - Create section intros and placeholder pages for future content - Add PLAN_DOCUMENTACION.md to track documentation progress - Email updated to llamamealex@gmail.com
- Create detailed content plans for all 3 documentation sections: * PLAN_CONTENIDO_TALLER_IA.md (6 pages, setup to exercises) * PLAN_CONTENIDO_AI_PRESENTATION.md (3 pages, problem to best practices) * PLAN_CONTENIDO_HERRAMIENTAS.md (4 pages, dev tools) * PLAN_CONTENIDO_ARQUITECTURA_IA.md (4 pages, patterns to security) - Add placeholder pages for all sections (16 pages total) - Update sidebars.js with explicit navigation structure - All pages now have proper sidebar_position for ordering
…design decisions, replace placeholders with honest development status, and add technical depth explanations
- Add 9 practical exercises across 3 difficulty levels (beginner to expert) - Implement structured learning path from Tool Use basics to multi-agent systems - Include detailed validation checklists for each exercise - Add clear objectives, requirements, and hints for learners - Follow consistent formatting and navigation patterns Exercises cover: - Level 1: Basic Tool Use, math operations, task management - Level 2: Memory systems, web research simulation, shopping cart - Level 3: Plan-Execute-Synthesize, multi-agent collaboration, self-improvement
- Remove PLAN_CONTENIDO_*.md files (internal planning docs) - Remove PROMPT_MAESTRO_CONTENIDO.md (content generation prompt) - These files were meant for internal organization, not public repo
…oved cross-references - Improve setup.md: add verification checklist, flowchart, expanded troubleshooting - Refactor agente-tareas.md: add ASCII diagrams, cleaner code structure, better comments - Enhance 4r-framework.md: add decision tree matrix and context-based priorities - Improve taller intro: add learning paths with duration estimates - Add better cross-references between tutorials - Expand 'Próximos Pasos' with clear learning paths - All changes maintain backward compatibility
…ons, and clear learning paths - Add prerequisites section with estimated duration - Create comparison table: Simple Agent vs Investigator - Expand 'Siguientes Pasos' with 4 clear learning paths - Add cross-references to 4R Framework and Ejercicios - Improve readability with visual separators
- Fix typo: 'Familiario' → 'Familiarizado' in prerequisites - Add missing property declarations in example classes (llm, failurePatterns, currentContextId, etc) - Fix duration calculation bug in InvestigationAgent.investigate() - Add GitHub repository and live site links to intro and agente-investigador pages - Fix inconsistent property reference: learningPatterns → learnings All code examples now properly declare their dependencies and demonstrate correct implementation patterns.
- Add comprehensive verification report for AI Agents workshop - Implement test agent for Plan-Execute-Synthesize pattern - Verify DeepSeek API integration works correctly - Confirm code examples execute without errors - All workshop patterns validated and production-ready
…p functionality - Fix typo: 'Familiario' → 'Familiarizado' in prerequisites - Add missing property declarations in example classes (llm, failurePatterns, currentContextId, etc) - Fix duration calculation bug in InvestigationAgent.investigate() - Add GitHub repository and live site links to intro and agente-investigador pages - Fix inconsistent property reference: learningPatterns → learnings - Verify Plan-Execute-Synthesize pattern works with DeepSeek API Note: test-agent folder removed due to security concerns (contained API keys)
There was a problem hiding this comment.
Pull request overview
This PR completes the exercises page for the AI Agents workshop with 9 comprehensive, progressive challenges organized across 3 difficulty levels (Beginner, Intermediate, Expert). The changes replace placeholder content with fully-developed exercises that include clear objectives, requirements, specifications, hints, and validation checklists.
Key Changes:
- Added comprehensive exercises.md with 9 detailed exercises (356 lines)
- Updated sidebars.js with explicit navigation structure
- Removed default Docusaurus tutorial files (cleaned up boilerplate)
- Maintained consistent cross-references to other workshop materials
Reviewed changes
Copilot reviewed 43 out of 45 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/proyectos/taller-ia-agentes-mcp/ejercicios.md | Complete exercises page with 3 levels (9 exercises total), validation checklists, and learning resources |
| sidebars.js | Explicit sidebar configuration replacing autogenerated structure |
| docs/tutorial-* | Removed default Docusaurus tutorial files (cleanup) |
| docs/proyectos/taller-ia-agentes-mcp/*.md | New workshop documentation pages (setup, agents, MCP servers, etc.) |
| docs/herramientas/*.md | Tool documentation (LazyVim, Tmux, Zellij, dev-tools) |
| docs/arquitectura-ia/*.md | Architecture patterns and design decisions for AI systems |
| docs/proyectos/ai-presentation/*.md | 4R Framework and best practices documentation |
| blog/2025-12-08-welcome/index.md | Updated welcome blog post with project philosophy |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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
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 completes the exercises page (
docs/proyectos/taller-ia-agentes-mcp/ejercicios.md) with comprehensive, progressive challenges for the AI Agents workshop.Changes Made
Exercise Coverage
Level 1 (Beginner) - 3 exercises:
Level 2 (Intermediate) - 3 exercises:
Level 3 (Expert) - 3 exercises:
Educational Value
This completes another major section of the AI Agents workshop documentation, moving from placeholder to production-ready educational content.
Closes part of the content completion plan in
PLAN_CONTENIDO_TALLER_IA.md.