====== Desarrollo de Software con Agentes y Skills ======
Más información:
* {{ :clase:daw:proyecto:1eval:the-complete-guide-to-building-skill-for-claude.pdf |The Complete Guide to Building Skills for Claude}}
* [[https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices|Skill authoring best practices]]
* [[https://github.com/shanraisshan/claude-code-best-practice|https://github.com/shanraisshan/claude-code-best-practice]]
* [[https://www.mintlify.com/shanraisshan/claude-code-best-practice/introduction|Claude Code Best Practice]]
* [[https://www.mintlify.com/shanraisshan/claude-code-best-practice/workflows/orchestration-workflow|Orchestration Workflow]]
* [[https://www.mintlify.com/shanraisshan/claude-code-best-practice/workflows/rpi-workflow|RPI Workflow]]
* [[https://dev.to/bhaidar/the-task-tool-claude-codes-agent-orchestration-system-4bf2|The Task Tool: Claude Code's Agent Orchestration System]]
* [[https://sankalp.bearblog.dev/my-experience-with-claude-code-20-and-how-to-get-better-at-using-coding-agents/|A Guide to Claude Code 2.0 and getting better at using coding agents]]
===== Claude Code =====
Más información:
* [[https://www.dbreunig.com/2026/04/04/how-claude-code-builds-a-system-prompt.html|How Claude Code Builds a System Prompt]]
* [[https://levelup.gitconnected.com/a-mental-model-for-claude-code-skills-subagents-and-plugins-3dea9924bf05|A Mental Model for Claude Code: Skills, Subagents, and Plugins]]
* [[https://youtu.be/B3bUHWGOoQo?is=_dZQEYJihTGa4L_i|Anthropic Acaba de CAMBIAR la Forma de Planificar en Claude Code Para Siempre (Ultraplan)]]: Vídeo en YouTube
* [[https://code.claude.com/docs/es/ultraplan|Planificar en la nube con ultraplan]]
===== Comandos =====
Mas información:
* [[https://batsov.com/articles/2026/03/11/essential-claude-code-skills-and-commands/|Essential Claude Code Skills and Commands]]
No confundir los comandos de claude code como ''/exit'' o ''/init'' con los comandos personalizados que uno se podían hacer en la carpeta ''claude/commands/.md''.
Ya que estos últimos están deprecados en favor de los Skills
===== Skills =====
Más información:
* [[https://code.claude.com/docs/es/skills|Ampliar Claude con skills]]
* [[https://agentskills.io/specification|Skill Specification]]
Plantilla para describir un skill:
Use this skill whenever the user wants to [acción principal].
This includes [caso 1], [caso 2], [caso 3], and [caso 4].
Trigger especially when the user mentions [palabra clave 1], [palabra clave 2], or [palabra clave 3].
Do NOT use for [exclusión 1] or [exclusión 2].
Plantilla con el contenido de un Skill:
# [Nombre del Skill]
## Overview / Why this skill exists
[1-3 párrafos. Explica el problema que resuelve, no solo qué hace.
Incluye las trampas naive que Claude podría caer sin el skill.]
## Quick Reference
| Task | Approach |
|------|----------|
| [Caso A] | [Herramienta/comando] |
| [Caso B] | [Herramienta/comando] |
---
## [Sección principal 1: el camino feliz]
[Instrucciones en imperativo. Código de ejemplo real y funcional.]
### Setup
```bash/js
[snippet de instalación o inicialización]
```
### [Sub-caso relevante]
```bash/js
[snippet]
```
---
## [Sección principal 2: casos especiales / edge cases]
**CRITICAL: [título del pitfall más importante]**
```js
// ❌ WRONG
[código incorrecto]
// ✅ CORRECT
[código correcto]
```
---
## Critical Rules
- **[Regla 1]** — [explicación de por qué]
- **[Regla 2]** — [explicación de por qué]
---
## Dependencies
- **[herramienta]**: [cómo instalar / para qué sirve]
Mas información:
* [[https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/|Claude Agent Skills: A First Principles Deep Dive]]
===== SubAgentes =====
A los subagentes decirle que:
Al terminar, responde SOLO con: "✓" No expliques nada. No resumas. Solo escribe el fichero y responde "✓".
Eso se hace así porque no queremos que "llene" el contexto con todo lo que ha hecho.
* Llamar a un subagente llamado ''view-designer'': @"view-designer (agent)"
===== Spec-Driven Development (SDD) =====
==== Frameworks y herramientas ====
* [[https://github.com/github/spec-kit|Spec Kit]] - Toolkit de GitHub para iniciarse en Spec-Driven Development.
* [[https://openspec.dev/|OpenSpec]] - Framework ligero para planificar y documentar cambios mediante specs versionadas en el código.
==== Comparativas ====
* [[https://pub.spillwave.com/agentic-coding-gsd-vs-spec-kit-vs-openspec-vs-taskmaster-ai-where-sdd-tools-diverge-0414dcb97e46|Agentic Coding: GSD vs Spec Kit vs OpenSpec vs Taskmaster AI]] - Análisis de las diferencias entre las principales herramientas SDD.
* [[https://www.youtube.com/watch?v=6FRk19CZSBY|GSD vs OpenSpec: Speed, Tokens, and Code Quality]] - Comparativa práctica en vídeo de rendimiento, consumo de tokens y calidad de código.
==== Workshops y charlas ====
* [[https://youtu.be/88cgta9f36I|Spec-Driven 3x: el salto a Agentic Engineer (Álvaro Moya)]] - Workshop sobre cómo aplicar SDD para dar el salto a Agentic Engineer.
===== Más información =====
==== Skills ====
* [[https://docs.tessl.io/|Tessl]] - Plataforma para gestionar skills.
* [[https://skills.sh/|Agent Skills Directory]] - Directorio de skills reutilizables instalables por línea de comandos.
* [[https://www.webreactiva.com/blog/skill-creator|Skill-creator en Claude Code]] - Cómo crear y evaluar skills con datos reales mediante agentes paralelos.
==== Subagentes ====
* [[https://github.com/VoltAgent/awesome-claude-code-subagents|Awesome Claude Code Subagents]] - Colección de más de 100 subagentes especializados para Claude Code.
* [[https://subagents.app/agents|Subagents.app]] - Catálogo online de subagentes para Claude Code.
* [[https://github.com/betta-tech/ejemplo-harness-subagentes|Ejemplo harness subagentes]] - Demo de Harness Engineering con un CLI mínimo y orquestación multi-agente (leader, implementer, reviewer).
==== Configuración y entorno ====
* [[https://mydeveloperplanet.com/2026/03/18/setting-up-claude-code-with-ollama-a-guide/|Setting Up Claude Code with Ollama]] - Guía para ejecutar Claude Code localmente usando Ollama como motor de inferencia.
* [[https://code.claude.com/docs/en/sandboxing|Claude Code - Sandboxing]] - Documentación oficial del sandbox de filesystem y red para ejecución más autónoma y segura.
==== Guías y buenas prácticas ====
* [[https://nikiforovall.blog/claude-code-rules/|Claude Code Handbook]] - Manual completo con mejores prácticas y técnicas para desarrollo asistido por IA con Claude Code.
* [[https://medium.com/@aiforhuman/claude-code-a-simple-loop-that-produces-high-agency-814c071b455d|Claude Code: A Simple Loop That Produces High Agency]] - Cómo Claude Code consigue alta autonomía mediante un bucle disciplinado de pensamiento,
acción y observación.
==== Testing y evaluación ====
* [[https://platform.claude.com/docs/en/test-and-evaluate/develop-tests|Define success criteria and build evaluations]] - Guía oficial para definir criterios de éxito y diseñar evaluaciones de aplicaciones basadas en LLM.
===== Plugins =====
===== Sandboxing =====
- Instalar: bubblewrap socat para limitar el sistema de archivos y la red
sudo apt-get install bubblewrap socat
- Ejecuta
/sandbox
===== Descargas =====
* [[https://github.com/jarrodwatts/claude-hud|Claude HUD]]: Mostrar en la consola que agentes están trabajando
* [[https://github.com/angular/skill|Angular Skills]]: Los Skills oficiales de Angular.
* [[https://github.com/obra/superpowers|Obra Superpowers]]: Agentes para que Claude planifique antes de hacer cosas con los agentes.
==== Claude HUD ====
Instala [[https://github.com/jarrodwatts/claude-hud|Claude HUD]] y dentro de Claude Code ejecuta:
/claude-hud:setup
Reinicia Claude Code
/claude-hud:configure
Y activa para que se vea todo.