Sprint 2 — Validación de la base documental
Objetivo y alcance
El Sprint 2 consolida la experiencia de aprendizaje, instalación y primeros pasos (Learn, Installation & Getting Started) para desarrolladores y equipos que adoptan Rapid OS v3.0.0.
Matriz de cobertura documental (Sprint 2)
| Área | Documento implementado | Ruta canónica | Estado |
|---|---|---|---|
| Qué es RAPID OS | What is RAPID OS | docs/concepts/what-is-rapid-os.md | Verified |
| Problema y beneficios | Why RAPID OS | docs/concepts/why-rapid-os.md | Verified |
| Conceptos fundamentales | Core Concepts | docs/concepts/core-concepts.md | Verified |
| Límites y fronteras | Product Boundaries | docs/concepts/product-boundaries.md | Verified |
| Requisitos del sistema | Requirements | docs/installation/requirements.md | Verified |
| Windows | Installation Windows | docs/installation/windows.md | Verified |
| Linux | Installation Linux | docs/installation/linux.md | Verified |
| macOS | Installation macOS | docs/installation/macos.md | Verified |
| WSL | Installation WSL | docs/installation/wsl.md | Verified |
| Verificación | Installation Verification | docs/installation/verification.md | Verified |
| Actualización | Upgrade | docs/installation/upgrade.md | Verified |
| Primer proyecto | First Project (Quickstart) | docs/getting-started/first-project.md | Verified |
| Proyecto existente | Existing Project | docs/getting-started/existing-project.md | Verified |
| Primera Spec | First Spec | docs/getting-started/first-spec.md | Verified |
| Primer Context | First Context | docs/getting-started/first-context.md | Verified |
| Siguientes pasos | Next Steps in Governance | docs/getting-started/next-steps.md | Verified |
| Problemas frecuentes | Troubleshooting Installation | docs/troubleshooting/installation.md | Verified |
Criterios de aceptación (Definition of Done)
- Product Truth: El propósito, capacidades y límites de Rapid OS están explicados claramente sin alucinaciones de comportamiento autónomo o LLM-as-a-judge.
- Instalación multiplataforma: Guías paso a paso detalladas para Windows, Linux, macOS y WSL 2.
- Diferenciación de versiones: Distinción explícita entre versión estable (
v3.0.0) y de desarrollo (main). - Tutorial Quickstart reproducible: Tutorial guiado paso a paso con un proyecto mínimo, probado de forma funcional en CI mediante un directorio temporal aislado.
- Adopción en repositorios existentes: Guía no invasiva que preserva el código de negocio y utiliza respaldos
.bak. - Contratos y tests automáticos: 11 pruebas de contrato documental en Python sin dependencias de Node.js, cubriendo integridad de archivos, flags válidos y consistencia de lockfile.
- Suite de pruebas de RAPID OS íntegra: 301/301 tests pasando exitosamente.
- Compilación de Docusaurus:
npm run typecheckynpm run buildpasando sin advertencias de tipos ni enlaces internos rotos (onBrokenLinks: 'throw').