v1.4.0

Novedades

• Release automática (.github/workflows/release.yml): en los proyectos derivados, cada merge a main con una versión fechada en el CHANGELOG publica el tag y el release de GitHub automáticamente.
• Aviso de mejoras de la plantilla (.github/workflows/template-update-check.yml): los proyectos derivados reciben un issue semanal cuando esta plantilla publica mejoras de tooling.

Sin cambios de contenido en la documentación de la plantilla.

v1.3.0 — specs numeradas, validación de skills y definition of done

Novedades

• Specs numeradas: las especificaciones ahora usan correlativo specs/NNNN-nombre/ (espejo de los ADRs) — orden cronológico visible en ls, referencia corta y estable, y número que sobrevive al archivado. /new-spec calcula el correlativo automáticamente.
• Validación de skills/agentes en CI: nuevo check-skills.sh como job de quality.yml (name = carpeta, kebab-case, description con vocación de disparador), con 5 casos de prueba nuevos (suite en 25).
• .claude/skills/README.md: reglas de estructura y plantilla inline para escribir skills nuevas.
• Definition of Done (docs/conventions/definition-of-done.md): checklist de "terminado de verdad", referenciada desde AGENTS.md y el PR template.
• Memoria del agente vs. documentación en ai-agents.md: lo duradero va a docs//ADRs, no a la memoria de la herramienta.
• /instanciar ahora poda también las skills ligadas a capacidades respondidas "no".

PR: #9 · Cambio coordinado con las variantes hermanas (todas en v1.3.0).

v1.2.0 — CI de calidad, guardrails reforzados y skills de ciclo de vida

Novedades

• CI activo y agnóstico del stack (quality.yml): formato Markdown, enlaces internos, verificación de placeholders (modo plantilla/instancia autodetectado) y suite de pruebas de los scripts del repo (20 casos).
• Escaneo de secretos con gitleaks (secret-scan.yml) y check de paridad estructural con la variante en inglés (template-parity.yml, exclusivo del repo-plantilla).
• Guardrails reforzados: git-guardrails.sh reescrito (cubre git -C y comandos encadenados) y nuevo secret-guardrails.sh que bloquea escrituras del agente sobre .env reales y llaves privadas.
• Skills de ciclo de vida: /release, /actualizar-plantilla (sincroniza el tooling con la plantilla vía .template-origin) y /portar-cambio. /instanciar ahora escribe .template-origin, registra la entrevista como ADR 0002 y limpia los archivos exclusivos de la plantilla.
• Docs: catálogo de placeholders completo (verificado por CI), guía «Recibir mejoras de la plantilla», badges reales de Actions y CODEOWNERS.example.

PR: #8 · Cambio coordinado con las variantes hermanas (todas en v1.2.0).

v1.1.0 — arranque guiado /instanciar + gobernanza de issues/PR

Capa de arranque asistido por IA para la plantilla.

Added

• Skill /instanciar — entrevista guiada que instancia la plantilla: detecta proyecto nuevo vs. existente, rellena los [PLACEHOLDERS], poda docs/ según el tipo de proyecto y decide la política de permisos. Incluye un guardián que evita ejecutarse sobre el repo-fuente. Descubrible desde el README y TEMPLATE-USAGE.md §2 (o escribiendo /instanciar).
• Gobernanza de issues/PR — regla en AGENTS.md para usar siempre las plantillas de .github/ + branching de CONTRIBUTING.md, y nuevo skill /open-issue (gemelo de /open-pr).
• Guardrails de git (opt-in) — hook PreToolUse .claude/hooks/git-guardrails.sh que bloquea commits/push directos a main/develop y force-push. Desactivado por defecto; documentado en docs/conventions/ai-agents.md.

Sin breaking changes. La variante en inglés (project-starter-template-en-ai) recibe lo mismo.

v1.0.3 — adopt in existing projects

Adds guidance in TEMPLATE-USAGE.md for adopting the template in a project you've already started (degit + selective copy), separate from the "Use this template" flow for new repos.

v1.0.2 — migration-guard skill

Adds the migration-guard example skill: reviews DB migrations for safety (reversible, non-destructive, backward-compatible, with a rollback plan), deferring to your docs/conventions/database.md. Stack-agnostic — adapt or delete.

v1.0.1 — Optional Context7 MCP

Adds an optional, stack-agnostic Context7 MCP server via .mcp.json.example (up-to-date library docs; no API key). Disabled by default — copy to .mcp.json to enable. See docs/conventions/ai-agents.md.

v1.0.0 — Plantilla de arranque lista para IA (ES)

Primera versión estable de la plantilla de arranque de proyectos lista para IA (español). La base de documentación completa más una capa de IA para agentes de programación.

Capa de IA

• AGENTS.md — instrucciones canónicas para agentes; CLAUDE.md la importa (@AGENTS.md).
• .claude/agents/ — 7 subagentes de ejemplo: architect, code-reviewer, test-author, doc-keeper, security-reviewer, debugger, explorer.
• .claude/skills/ — 11 skills de ejemplo: new-adr, new-spec, commit, open-pr, seo-audit, i18n-parity, design-system-audit, copywriting, changelog, accessibility-audit, refactor.
• specs/ — flujo ligero basado en especificaciones (proposal/tasks/design).
• docs/conventions/ai-agents.md — reglas para trabajar con IA.

Todos los subagentes/skills son ejemplos agnósticos al stack que delegan en tus docs/ — adáptalos o elimínalos según el proyecto.

Base de documentación

Documentación de arquitectura, producto y decisiones (ADR), 13 convenciones, archivos de gobernanza, plantillas de .github/ y tooling de Markdown — igual que la variante sin IA.

Cómo usarla

Pulsa "Use this template" o clona, y sigue TEMPLATE-USAGE.md.

Familia de plantillas

• 🇪🇸 ES con IA: este repositorio.
• 🇬🇧 EN con IA: project-starter-template-en-ai.
• 🇪🇸 ES sin IA: project-starter-template-es.
• 🇬🇧 EN sin IA: project-starter-template-en.