DaniDSanj
UserPlantilla de arranque para Spec-Driven Development con Claude Code + GitHub Spec-Kit, Python, PostgreSQL/SQL Server y Obsidian como documentacion.
Categories
Indexed Skills (19)
critic-plan
Revisión adversarial de spec.md, plan.md y tasks.md de la feature activa en contexto limpio, con veredicto GO/NO-GO y el listado completo de hallazgos. Úsalo en el paso 2.8 del ciclo SDD, obligatoriamente antes de /speckit-implement en cualquier feature no trivial.
critic-requirements
Audita una petición de feature contra las 10 categorías de ambigüedad antes de escribir la spec, y devuelve el prompt aumentado listo para /speckit-specify más la lista de huecos de alcance que el humano debe cerrar antes. Úsalo en el paso 1.1 del ciclo SDD, siempre antes de /speckit-specify.
critic-verifications
Audita el criterio de cierre de las tareas de la feature activa antes de converger: qué tareas exigen UAT humana, cuáles se han cerrado sin evidencia objetiva, y si la clasificación automatizable/manual de quickstart_agent.md es correcta. Úsalo en el paso 4.4 del ciclo SDD, después de /verify-validate y antes de /speckit-converge.
db-model-integration
Tras la aprobación humana explícita del esquema, entrega el comando exacto de la herramienta de migraciones y el DDL revisado —nunca escribe el fichero de migración—, y actualiza el modelo de datos canónico (entidad + changelog) y las specs readaptadas. Úsalo en el paso 4.2 del ciclo SDD, solo cuando la propuesta de /db-model-protocol ya está aprobada.
db-model-protocol
Diseña el esquema de la feature activa y lo reconcilia contra el modelo de datos canónico en contexto limpio: reutilización antes que creación, análisis de impacto sobre las specs dependientes y propuesta en bloque a la espera de aprobación humana explícita. Entrega DDL y erDiagram, no aplica nada. Úsalo en el paso 2.2 del ciclo SDD, tras /speckit-plan, siempre que la feature toque el modelo de datos.
docs-adr-writer
Redacta un Architecture Decision Record en el vault de Obsidian del proyecto: ruta y numeración, formato Nygard, regla append-only con supersede, y el índice Dataview de docs/ADR/Overview.md. Úsalo en el paso 2.4 del ciclo SDD —el mismo día de la decisión, antes de /speckit-tasks— y en el 5.3 para cualquier decisión que quedara sin ADR.
docs-vault-sync
Sincroniza el vault de Obsidian con el estado real de la feature: nota de spec, diagrama ER, espejo del changelog y enlaces cruzados con wikilinks. Úsalo en el paso 2.3 del ciclo SDD (cuando /speckit-plan generó data-model.md) y en el 5.3 al cerrar la feature.
verify-prepare
Traduce el quickstart.md de la feature activa (prosa orientada a un humano) a un fichero estructurado quickstart_agent.md, marcando cada escenario como automatizable o manual. Úsalo en el paso 3.1 del ciclo SDD, tras el veredicto GO de /critic-plan, o cuando quickstart.md haya cambiado y quickstart_agent.md esté desactualizado o no exista.
verify-validate
Ejecuta las validaciones automatizables descritas en quickstart_agent.md para la feature activa y anota el resultado de cada una (REALIZADA, ERRÓNEA, PENDIENTE, INALCANZABLE) directamente en ese fichero. Muestra además un resumen por consola. No corrige el proyecto ni edita ningún otro fichero. Úsalo después de /speckit-implement, y de nuevo tras cada corrección, hasta que no queden ERRÓNEAS ni INALCANZABLES.
docs-runbook
Redacta un runbook en docs/Runbooks/ cuando la feature introduce un procedimiento operativo nuevo (deploy especial, rollback, migración manual, respuesta a incidente). Úsalo en el paso 5.3 del ciclo SDD, al cerrar la feature.
git-close-feature
Cierra la feature en GitHub: commit, push de la rama y PR hacia dev con un Closes #N repetido por cada issue que resuelve. Incluye la frontera dura de que el asistente propone la PR feature/* → dev pero nunca abre la PR dev → main. Úsalo en el paso 5.6 del ciclo SDD, tras el checklist de consistencia.
db-model-conventions
Convenciones de diseño de esquema de base de datos de este proyecto: naming, campos de auditoría obligatorios, política de índices, regla de migraciones y cuándo introducir NoSQL. Válidas tanto para PostgreSQL como para SQL Server. Úsalo antes de diseñar, revisar o modificar cualquier tabla o modelo de datos — en el paso 2.1 del ciclo SDD junto a /speckit-plan, y en cualquier trabajo de esquema fuera del ciclo.
db-model-ideas
Recoge el boceto humano de tablas de una feature en specs/<feature>/db_ideas.md, con la plantilla de bloque por tabla y la regla de que es un punto de partida, nunca una fuente de verdad. Úsalo en el paso 1.4 del ciclo SDD, cuando la feature toca el modelo de datos y tienes ideas concretas de tablas más rápidas de dibujar que de explicar.
dev-python-coding
Convenciones de escritura de código Python de este proyecto: gestión con uv, layout src/, tipado estático, Pydantic v2, ruff + ty, docstrings Google style y elección de framework. Úsalo antes de escribir o modificar cualquier fichero .py — en el paso 4.1 del ciclo SDD junto a /speckit-implement, y en cualquier edición de código fuera del ciclo.
dev-python-testing
Convenciones de testing en Python de este proyecto: pytest, estructura de tests/ como espejo de src/, mockeo de conexiones a base de datos, cobertura mínima objetivo y la regla de que ninguna tarea se cierra sin test. Úsalo antes de escribir o modificar tests — en el paso 4.1 del ciclo SDD junto a /speckit-implement, y en cualquier edición de tests fuera del ciclo.
docs-changelog
Genera las entradas de CHANGELOG.md a partir de los Conventional Commits del rango de la feature, en formato Keep a Changelog 2.0.0, y las refleja en docs/Changelog/Changelog.md. Úsalo en el paso 5.4 del ciclo SDD, en el cierre — nunca a mano en mitad del desarrollo.
docs-consistency-check
Checklist de consistencia que se recorre antes de cerrar cualquier feature: docstrings y tipado, ADR de las decisiones tomadas, Conventional Commits con ID de feature, CHANGELOG.md, nota de vault enlazada y UAT humana confirmada. Audita, no redacta. Úsalo en el paso 5.5 del ciclo SDD, tras revisar los borradores de documentación y antes del commit de cierre.
git-run-actions
Supervisa el CI de una PR: lee el estado del job quality de ci.yml, diagnostica el paso que falla y propone la corrección, sin tocar nunca el workflow. Incluye el coste de minutos de GitHub Actions según la visibilidad del repo y la red local pre-push. Úsalo en el paso 5.7 del ciclo SDD, tras abrir la PR hacia dev.
git-update-repo
Convenciones de Git y GitHub de este proyecto: modelo de ramas, la regla de que toda feature necesita su propia rama sin excepción, el modelo de branch protection de dev y main, y el formato de los mensajes de commit (Conventional Commits con el ID de feature). Úsalo en el paso 3.3 del ciclo SDD, al crear la rama de la feature, y de nuevo en el 5.6 al redactar los mensajes de commit.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.