3Fase 3 · SDD Lifecycle
Contexto, skills, MCPs y convenciones
La diferencia entre "prompting" y "engineering" · Contexto real del proyecto al agente
5/14
Qué se hace aquí
Se le da al agente IA contexto real del proyecto. Una spec buena no basta si el agente no conoce el stack, la arquitectura, las convenciones, los patrones de testing, la estructura del repositorio, los MCPs corporativos y las políticas de seguridad.
Dónde se documenta el contexto
openspec/project.md
Stack, arquitectura, patrones, reglas API, políticas de seguridad
AGENTS.md / CLAUDE.md
Instrucciones específicas para el agente IA del proyecto
.cursor/rules
Reglas y convenciones para Cursor
.github/copilot-instructions.md
Instrucciones para GitHub Copilot
Ejemplo de openspec/project.md
## Stack
- Backend: Java 21 + Spring Boot
- Frontend: React + TypeScript
- Database: PostgreSQL
- CI/CD: GitHub Actions
- Gateway: Azure API Management
- Testing: JUnit, Playwright, Pact
## API Standards
- RESTful APIs · OpenAPI 3.1
- Pagination: page + size
- Error format: RFC 7807
- CorrelationId required
- OAuth2/OIDC security
## Development Rules
- Do not bypass service layer
- Do not expose internal IDs
- All endpoints validate authenticated user
- All new APIs require OpenAPI update
MCPs corporativos relevantes
Jira MCP
Gestión de historias y tareas
GitHub MCP
PRs, commits, issues
Playwright MCP
Tests E2E automáticos
Postman MCP
Contratos API y colecciones
SonarQube MCP
Análisis de calidad de código
Confluence MCP
Documentación de equipo
API Manager MCP
Gobierno de APIs corporativas
ServiceNow MCP
Gestión de servicios TI
Comandos útiles
openspec list # Ver estado del proyecto
openspec list --specs # Ver specs existentes
openspec validate # Validar
openspec update # Actualizar skills si cambia el perfil
openspec config profile # Configurar perfil
✓ Gate 3 — Context Ready
✓
Stack documentado✓
Convenciones documentadas✓
Reglas API definidas✓
Reglas de seguridad definidas✓
MCPs disponibles identificados✓
Estructura del repo entendida✓
Dependencias conocidas