create-quiver 0.9.1 → 0.12.0

package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/CLOSURE_BRIEF.md

@@ -0,0 +1,31 @@
+# CLOSURE BRIEF - slice-01: Init profiles and dry-run planner
+
+## Resumen de lo realizado
+
+Se agrego el comando explicito `init`, flags de perfil para inicializacion, un planner puro de layout y el flujo `init --dry-run` sin escrituras. El comando historico `npx create-quiver --name` sigue funcionando como alias compatible.
+
+## Validacion contra criterios de aceptacion
+
+- [x] `init --dry-run` no escribe archivos.
+- [x] Alias `--name` preservado.
+- [x] Flags invalidos fallan antes de escribir.
+- [x] Planner testeado como funcion pura.
+
+## Cambios relevantes
+
+- `src/create-quiver/lib/init-layout.js` agrega planning puro y formatter de dry-run.
+- `src/create-quiver/index.js` parsea `init`, `--minimal`, `--full`, `--legacy-scripts`, `--include-templates` y conecta `--dry-run`.
+- Tests nuevos cubren planner, perfiles, alias compatible y que init real conserva el layout historico en este slice.
+
+## Pendientes
+
+- `slice-02` debe mover la infraestructura interna y template resolver real.
+- `slice-03` debe cambiar la escritura efectiva por perfiles.
+
+## Riesgos remanentes
+
+- En esta slice los perfiles solo impactan el plan dry-run; la escritura real sigue usando el layout historico por diseno del corte.
+
+## Recomendaciones futuras
+
+- Usar `init-layout.js` como contrato unico para los slices siguientes y evitar duplicar listas de archivos.

package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/EXECUTION_BRIEF.md

@@ -0,0 +1,59 @@
+# EXECUTION BRIEF - slice-01: Init profiles and dry-run planner
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-01-init-profiles-dry-run
+**Tipo:** feature
+
+## Contexto
+
+Antes de cambiar archivos generados, Quiver necesita una superficie explicita para init y un plan testeable que permita previews seguros.
+
+## Objetivo
+
+Agregar el comando `init`, perfiles de generacion y `--dry-run` sin cambiar todavia la escritura real.
+
+## Alcance
+
+- Parser CLI.
+- Alias compatible `npx create-quiver --name`.
+- Nuevo modulo puro para calcular operaciones de layout.
+- Tests del parser y del planner.
+
+## Criterios de aceptacion
+
+- `init --dry-run` no escribe archivos.
+- `--name` sigue funcionando como alias.
+- Flags invalidos fallan antes de escribir.
+- El planner devuelve operaciones estructuradas.
+
+## Plan tecnico resumido
+
+Agregar `init` a `parseArgs`, normalizar flags en un objeto de perfil y crear `lib/init-layout.js` con funciones puras. Conectar dry-run para imprimir el plan y salir.
+
+## Pasos sugeridos de ejecucion
+
+1. Agregar `init` a comandos soportados.
+2. Parsear flags de perfil.
+3. Implementar validacion de combinaciones.
+4. Implementar layout planner sin I/O.
+5. Conectar `--dry-run`.
+6. Agregar tests unitarios y CLI.
+
+## Restricciones
+
+- No cambiar todavia el set de archivos generado por init normal.
+- No mover templates.
+- No tocar docs salvo status/evidence del slice.
+
+## Riesgos
+
+- Romper compatibilidad del comando historico.
+- Duplicar logica entre parser y planner.
+- Hacer dry-run parcial que igual escriba algo.
+
+## Checklist de finalizacion
+
+- [ ] Tests del parser pasan.
+- [ ] Tests del planner pasan.
+- [ ] Dry-run deja `git status` limpio en fixture.
+- [ ] Comandos existentes siguen funcionando.

package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/slice.json

@@ -0,0 +1,57 @@
+{
+  "slice_id": "slice-01-init-profiles-dry-run",
+  "ticket": "QUIVER-21-01",
+  "type": "feature",
+  "title": "Add init profiles and dry-run planner",
+  "objective": "Introduce explicit init mode, profile flags, compatibility alias behavior, and a pure layout plan for dry-run output.",
+  "description": "This slice creates the command surface and planning layer without changing the file generation behavior yet.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "init-profiles-dry-run",
+    "branch_name": "feature/QUIVER-21-01-init-profiles-dry-run"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-layout.js",
+    "tests/lib/init-layout.test.js",
+    "tests/commands/init-profiles.test.js",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/slice.json"
+  ],
+  "depends_on": [
+    "slice-00-spec-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Establishes parser and layout planning contracts used by later slices.",
+  "must": [
+    "Add explicit `init` command parsing.",
+    "Keep `npx create-quiver --name` as a compatibility alias.",
+    "Add flags `--minimal`, `--full`, `--legacy-scripts`, `--include-templates`, and `--dry-run` for init.",
+    "Add a pure layout planner that returns planned operations without writing files.",
+    "Make `init --dry-run` print planned creates, skips, internal files, optional files, and risks.",
+    "Validate invalid flag combinations before writes."
+  ],
+  "not_included": [
+    "Changing actual generated file sets.",
+    "Moving templates or scan outputs.",
+    "Updating docs."
+  ],
+  "acceptance": [
+    "`npx create-quiver init --name \"Project\" --dry-run` does not write files.",
+    "`npx create-quiver --name \"Project\" --dry-run` follows the compatibility path.",
+    "Invalid profiles fail before file writes.",
+    "The layout planner is unit tested as a pure function.",
+    "Existing non-init commands still parse."
+  ],
+  "tests": [
+    "node --test tests/lib/init-layout.test.js tests/commands/init-profiles.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 5,
+  "actual_hours": 5,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/CLOSURE_BRIEF.md

@@ -0,0 +1,32 @@
+# CLOSURE BRIEF - slice-02: Internal layout and template resolver
+
+## Resumen de lo realizado
+
+Se agrego el contrato interno `.quiver/`, config y gitignore internos, helpers centralizados de paths y un resolver de templates que prioriza templates empaquetados con fallback legacy.
+
+## Validacion contra criterios de aceptacion
+
+- [x] `.quiver/` creado con metadata.
+- [x] Runtime ignorado.
+- [x] Templates empaquetados resueltos.
+- [x] Fallback legacy cubierto.
+
+## Cambios relevantes
+
+- `src/create-quiver/lib/init-layout.js` ahora define paths internos, config y gitignore.
+- `src/create-quiver/lib/template-resolver.js` resuelve templates empaquetados, exportados y legacy.
+- `initializeProjectDocs` acepta `templateRoot` explicito y escribe `.quiver/config.json` y `.quiver/.gitignore`.
+- `statePath` usa el helper centralizado de `.quiver/`.
+
+## Pendientes
+
+- `slice-03` debe cambiar el set real generado por perfiles.
+- `slice-04` debe mover el scan crudo a `.quiver/scans/`.
+
+## Riesgos remanentes
+
+- El init real todavia exporta `docs-template/` legacy por diseno del corte; se quitara del default en `slice-03`.
+
+## Recomendaciones futuras
+
+- Consumir `template-resolver.js` en futuros generadores para evitar nuevas dependencias directas de `docs-template/`.

package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/EXECUTION_BRIEF.md

@@ -0,0 +1,60 @@
+# EXECUTION BRIEF - slice-02: Internal layout and template resolver
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-02-internal-layout-template-resolver
+**Tipo:** feature
+
+## Contexto
+
+El layout nuevo separa maquinaria interna y contrato visible. Para lograrlo, Quiver no debe depender de `docs-template/` visible en proyectos nuevos.
+
+## Objetivo
+
+Agregar contrato `.quiver/` y resolucion de templates empaquetados con fallback legacy.
+
+## Alcance
+
+- `.quiver/state.json`
+- `.quiver/config.json`
+- `.quiver/.gitignore`
+- `.quiver/templates/` solo bajo opt-in futuro.
+- Template resolver empaquetado y fallback legacy.
+
+## Criterios de aceptacion
+
+- `.quiver/` contiene metadata versionable y runtime ignorado.
+- `cache`, `runs` y `worktrees` quedan ignorados.
+- Templates se resuelven sin `docs-template/` visible.
+- `docs-template/` legacy sigue funcionando si existe.
+
+## Plan tecnico resumido
+
+Centralizar paths internos en un helper o extender `init-layout`. Agregar `template-resolver.js` para ubicar templates empaquetados, `.quiver/templates/` y legacy `docs-template/` en orden seguro.
+
+## Pasos sugeridos de ejecucion
+
+1. Definir helpers de paths `.quiver`.
+2. Crear writer para `.quiver/.gitignore`.
+3. Agregar `config.json` minimo.
+4. Extraer resolucion de templates.
+5. Actualizar usos internos.
+6. Agregar tests de resolver y gitignore.
+
+## Restricciones
+
+- No eliminar soporte legacy.
+- No copiar templates por default al root.
+- No mover scans todavia.
+
+## Riesgos
+
+- Romper `new-handoff` o `migrate`.
+- Resolver templates desde el proyecto equivocado.
+- Versionar carpetas runtime por accidente.
+
+## Checklist de finalizacion
+
+- [ ] Tests de resolver pasan.
+- [ ] `.quiver/.gitignore` cubre runtime.
+- [ ] Fallback legacy testeado.
+- [ ] No hay dependencia obligatoria de `docs-template/`.

package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/slice.json

@@ -0,0 +1,58 @@
+{
+  "slice_id": "slice-02-internal-layout-template-resolver",
+  "ticket": "QUIVER-21-02",
+  "type": "feature",
+  "title": "Add internal .quiver layout and template resolver",
+  "objective": "Create the internal .quiver layout contract and remove default runtime dependence on visible docs-template.",
+  "description": "This slice introduces internal folders, .quiver gitignore policy, config metadata, and packaged template resolution.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "internal-layout-template-resolver",
+    "branch_name": "feature/QUIVER-21-02-internal-layout-template-resolver"
+  },
+  "files": [
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/template-resolver.js",
+    "src/create-quiver/lib/state.js",
+    "tests/lib/template-resolver.test.js",
+    "tests/lib/quiver-internal-layout.test.js",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/slice.json"
+  ],
+  "depends_on": [
+    "slice-01-init-profiles-dry-run"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Builds on the layout planner from slice-01.",
+  "must": [
+    "Create `.quiver/state.json` and `.quiver/config.json` as versionable metadata.",
+    "Create `.quiver/.gitignore` that ignores cache, runs, and worktrees.",
+    "Define internal paths for scans, templates, cache, runs, and worktrees.",
+    "Resolve templates from the packaged CLI by default.",
+    "Support `.quiver/templates/` only when templates are explicitly exported.",
+    "Keep legacy `docs-template/` readable as fallback when present."
+  ],
+  "not_included": [
+    "Changing default generated docs set.",
+    "Moving analyze scan output.",
+    "Migrating existing projects."
+  ],
+  "acceptance": [
+    "Default init planning includes `.quiver/state.json`, `.quiver/config.json`, and `.quiver/.gitignore`.",
+    "Runtime ignored folders do not appear as versionable files.",
+    "Commands can resolve templates without a project-level `docs-template/`.",
+    "Legacy `docs-template/` remains readable when present."
+  ],
+  "tests": [
+    "node --test tests/lib/template-resolver.test.js tests/lib/quiver-internal-layout.test.js tests/lib/init-layout.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 6,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/CLOSURE_BRIEF.md

@@ -0,0 +1,34 @@
+# CLOSURE BRIEF - slice-03: Generation profiles and visible contract
+
+## Resumen de lo realizado
+
+Se implemento la escritura real por perfiles de init. El perfil default genera un contrato AI-first visible sin `docs-template/`, sin `tools/scripts/` y sin spec placeholder; `--minimal` reduce la salida al contrato esencial de onboarding; `--full` conserva el layout amplio de compatibilidad.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Default limpio.
+- [x] Minimal esencial.
+- [x] Full compatible.
+- [x] Scripts validos por perfil.
+- [x] Archivos existentes preservados.
+
+## Cambios relevantes
+
+- `initializeProjectDocs()` ahora recibe `profile`, `legacyScripts` e `includeTemplates`.
+- Default y minimal ya no copian templates visibles, scripts Bash legacy ni specs placeholder.
+- `--full` mantiene docs amplios, scripts legacy, spec template y `docs-template/`.
+- Los scripts de `package.json` se generan segun perfil para evitar comandos que apunten a archivos ausentes.
+- Los archivos existentes se preservan por defecto.
+- Smokes de init cubren default, minimal y full.
+
+## Pendientes
+
+No quedan pendientes dentro de este slice. La adaptacion de comandos para repos sin specs corresponde a `slice-05`.
+
+## Riesgos remanentes
+
+`smoke-create-quiver.sh` conserva escenarios historicos bajo `--full`; los escenarios default sin specs se cierran completamente en `slice-05` y `slice-08`.
+
+## Recomendaciones futuras
+
+Mantener cualquier asset adicional detras de flags explicitos para que el default siga siendo pequeno y legible.

package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/EXECUTION_BRIEF.md

@@ -0,0 +1,61 @@
+# EXECUTION BRIEF - slice-03: Generation profiles and visible contract
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-03-generation-profiles-visible-contract
+**Tipo:** feature
+
+## Contexto
+
+El valor visible del cambio aparece cuando el init default deja de generar archivos que parecen ruido para onboarding.
+
+## Objetivo
+
+Implementar la escritura real de los perfiles default, minimal y full.
+
+## Alcance
+
+- Init writer.
+- Perfiles de archivos visibles.
+- Package scripts generados por perfil.
+- Smokes iniciales por perfil.
+
+## Criterios de aceptacion
+
+- Default no crea `docs-template/`, `tools/scripts/` ni spec placeholder.
+- Minimal crea solo el contrato esencial.
+- Full conserva salida amplia de compatibilidad.
+- Scripts npm no apuntan a archivos ausentes.
+- Archivos existentes no se sobrescriben.
+
+## Plan tecnico resumido
+
+Usar el layout planner para ejecutar operaciones por perfil. Separar sets de archivos en esenciales, full, legacy y templates. Mantener `--full` como escape hatch del comportamiento amplio.
+
+## Pasos sugeridos de ejecucion
+
+1. Definir file sets por perfil.
+2. Conectar writer a operaciones planeadas.
+3. Ajustar merge de package scripts por perfil.
+4. Evitar spec placeholder en default/minimal.
+5. Agregar smokes de default, minimal y full.
+6. Actualizar evidence/status del slice.
+
+## Restricciones
+
+- No mover analyze scan output.
+- No eliminar compatibilidad full.
+- No generar scripts que dependan de `tools/scripts/` sin `--legacy-scripts`.
+
+## Riesgos
+
+- Reducir demasiado el default y dejar docs necesarias afuera.
+- Romper proyectos que esperaban spec placeholder.
+- Mantener tests viejos que asumen layout anterior.
+
+## Checklist de finalizacion
+
+- [ ] Default smoke actualizado.
+- [ ] Minimal smoke agregado.
+- [ ] Full smoke agregado.
+- [ ] Scripts por perfil validados.
+- [ ] No hay overwrite accidental.

package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/slice.json

@@ -0,0 +1,64 @@
+{
+  "slice_id": "slice-03-generation-profiles-visible-contract",
+  "ticket": "QUIVER-21-03",
+  "type": "feature",
+  "title": "Implement generation profiles and visible contract",
+  "objective": "Change generated output so default and minimal init are clean while full mode preserves the broader current contract.",
+  "description": "This slice updates init writing behavior according to the approved profiles and prevents default placeholder specs, visible templates, and legacy scripts.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "generation-profiles-visible-contract",
+    "branch_name": "feature/QUIVER-21-03-generation-profiles-visible-contract"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "tests/lib/init-docs.test.js",
+    "tests/commands/init-profiles.test.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/slice.json"
+  ],
+  "depends_on": [
+    "slice-02-internal-layout-template-resolver"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Needs the internal layout and template resolver before changing generation behavior.",
+  "must": [
+    "Default init creates the clean AI-first visible contract.",
+    "Default init does not create `docs-template/`.",
+    "Default init does not create `tools/scripts/`.",
+    "Default init does not create placeholder `specs/<project-slug>/`.",
+    "`--minimal` creates only the minimum AI onboarding contract.",
+    "`--full` preserves the broad current output as explicit behavior.",
+    "Generated package scripts do not point at files that were not created.",
+    "Existing files are skipped by default."
+  ],
+  "not_included": [
+    "Analyze scan relocation.",
+    "Legacy migration recommendations.",
+    "Documentation alignment beyond tests needed for this behavior."
+  ],
+  "acceptance": [
+    "Default smoke asserts no root `docs-template/`, no `tools/scripts/`, and no placeholder spec.",
+    "Minimal smoke asserts only essential files are generated.",
+    "Full smoke asserts broad current docs remain available under `--full`.",
+    "Generated scripts are valid for each profile.",
+    "Existing files are preserved."
+  ],
+  "tests": [
+    "node --test tests/lib/init-docs.test.js tests/commands/init-profiles.test.js",
+    "npm run smoke:create-quiver",
+    "bash scripts/ci/smoke-init-docs.sh",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "actual_hours": 7,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/CLOSURE_BRIEF.md

@@ -0,0 +1,32 @@
+# CLOSURE BRIEF - slice-04: Analyze scan relocation
+
+## Resumen de lo realizado
+
+Se movio la salida cruda de `analyze` a `.quiver/scans/PROJECT_SCAN.json` y se mantuvo `docs/PROJECT_MAP.md` como artefacto visible para humanos y agentes. Se agrego un helper central para rutas de scan con lectura preferente del path nuevo y fallback legacy a `docs/PROJECT_SCAN.json`.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Scan nuevo creado.
+- [x] Project map visible creado.
+- [x] Fallback legacy cubierto.
+- [x] Preferencia nuevo sobre legacy testeada.
+
+## Cambios relevantes
+
+- `analyze` escribe el JSON crudo en `.quiver/scans/PROJECT_SCAN.json`.
+- `docs/PROJECT_MAP.md` se sigue escribiendo y queda visible.
+- `doctor` considera valido el scan nuevo o legacy mientras exista el project map.
+- Los metadatos de context pack reportan el scan usado cuando reciben `repoRoot`.
+- Smokes actualizados para validar el path nuevo.
+
+## Pendientes
+
+No quedan pendientes dentro de este slice. La alineacion textual de templates que todavia nombran `docs/PROJECT_SCAN.json` queda para `slice-07`.
+
+## Riesgos remanentes
+
+Durante la transicion pueden coexistir `.quiver/scans/PROJECT_SCAN.json` y `docs/PROJECT_SCAN.json`; el helper prefiere el path nuevo para evitar ambiguedad.
+
+## Recomendaciones futuras
+
+Actualizar las guias visibles para presentar `docs/PROJECT_MAP.md` como lectura principal y el JSON crudo como artefacto interno de herramientas.

package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/EXECUTION_BRIEF.md

@@ -0,0 +1,58 @@
+# EXECUTION BRIEF - slice-04: Analyze scan relocation
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-04-analyze-scan-relocation
+**Tipo:** feature
+
+## Contexto
+
+`PROJECT_SCAN.json` es dato crudo para herramientas. El proyecto visible necesita `PROJECT_MAP.md`, no necesariamente el JSON completo en `docs/`.
+
+## Objetivo
+
+Mover el scan crudo a `.quiver/scans/` y mantener compatibilidad con el path viejo.
+
+## Alcance
+
+- Escritura de `analyze`.
+- Lectura de scan en doctor/context packs.
+- Compatibilidad con `docs/PROJECT_SCAN.json`.
+- Tests de path nuevo y legacy.
+
+## Criterios de aceptacion
+
+- `analyze` escribe `.quiver/scans/PROJECT_SCAN.json`.
+- `docs/PROJECT_MAP.md` sigue visible.
+- Lectores soportan path nuevo y legacy.
+- Si existen ambos, se prefiere el path nuevo.
+
+## Plan tecnico resumido
+
+Crear helpers de scan path sobre `.quiver/`, cambiar escritura de analyze y actualizar consumidores para leer con fallback.
+
+## Pasos sugeridos de ejecucion
+
+1. Identificar todos los consumidores de `docs/PROJECT_SCAN.json`.
+2. Crear helper de lectura/escritura de scan.
+3. Cambiar `analyze`.
+4. Actualizar doctor y AI context.
+5. Agregar tests de compatibilidad.
+
+## Restricciones
+
+- No borrar archivos legacy.
+- No ocultar `PROJECT_MAP.md`.
+- No cambiar el contrato semantico del scan.
+
+## Riesgos
+
+- Onboarding que siga buscando solo el path viejo.
+- Smokes desactualizados.
+- Usuarios confundidos por dos paths durante transicion.
+
+## Checklist de finalizacion
+
+- [ ] Analyze path nuevo validado.
+- [ ] Project map visible validado.
+- [ ] Fallback legacy validado.
+- [ ] Smokes actualizados.

package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/slice.json

@@ -0,0 +1,64 @@
+{
+  "slice_id": "slice-04-analyze-scan-relocation",
+  "ticket": "QUIVER-21-04",
+  "type": "feature",
+  "title": "Relocate analyze scan output",
+  "objective": "Move raw analyze output to `.quiver/scans/PROJECT_SCAN.json` while keeping `docs/PROJECT_MAP.md` visible and supporting legacy reads.",
+  "description": "This slice separates machine-readable scan data from human-facing project map documentation.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "analyze-scan-relocation",
+    "branch_name": "feature/QUIVER-21-04-analyze-scan-relocation"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/context-packs.js",
+    "src/create-quiver/lib/ai/executor.js",
+    "src/create-quiver/lib/project-scan.js",
+    "tests/commands/analyze.test.js",
+    "tests/lib/ai-context-packs.test.js",
+    "tests/lib/project-scan.test.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/slice.json"
+  ],
+  "depends_on": [
+    "slice-02-internal-layout-template-resolver"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Depends on `.quiver/` internal path helpers but can run before docs alignment.",
+  "must": [
+    "Write raw scan JSON to `.quiver/scans/PROJECT_SCAN.json`.",
+    "Keep writing `docs/PROJECT_MAP.md` for humans and agents.",
+    "Read legacy `docs/PROJECT_SCAN.json` when present.",
+    "Prefer the new scan path when both new and legacy files exist.",
+    "Update AI context packing and doctor scan detection to support both paths."
+  ],
+  "not_included": [
+    "Changing project map content semantics.",
+    "Removing legacy scan files.",
+    "Changing generated visible docs beyond necessary path references."
+  ],
+  "acceptance": [
+    "`analyze` creates `.quiver/scans/PROJECT_SCAN.json`.",
+    "`analyze` still creates `docs/PROJECT_MAP.md`.",
+    "Doctor and AI onboarding helpers can read legacy scan path.",
+    "Tests cover preference order when both paths exist."
+  ],
+  "tests": [
+    "node --test tests/commands/analyze.test.js tests/lib/project-scan.test.js tests/lib/ai-context-packs.test.js",
+    "node --test tests/**/*.test.js",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "node scripts/ci/smoke-cross-platform.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 5,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-05-empty-specs-layout-doctor/CLOSURE_BRIEF.md

@@ -0,0 +1,32 @@
+# CLOSURE BRIEF - slice-05: Empty specs and layout doctor
+
+## Resumen de lo realizado
+
+Se adapto `doctor` para aceptar proyectos sin specs despues del init AI-first y reportar el estado de layout como `new`, `legacy`, `hybrid` o `incomplete`. `plan`, `graph` y `next` ya devolvian estados vacios validos, y se agrego cobertura para asegurar ese comportamiento junto con el nuevo doctor.
+
+## Validacion contra criterios de aceptacion
+
+- [x] No-spec soportado.
+- [x] Layout nuevo detectado.
+- [x] Layout legacy detectado.
+- [x] Proyectos con specs no regresan.
+
+## Cambios relevantes
+
+- `doctor` ya no exige exactamente un spec generado.
+- `doctor` muestra layout, specs detectadas, senales legacy y recomendaciones accionables.
+- Se agrego `collectLayoutReport()` y `collectDoctorReport()` para separar deteccion de layout de presentacion CLI.
+- Los wrappers legacy solo se validan como ejecutables si existen.
+- Se agregaron tests para layouts nuevo sin specs, minimal, legacy, hybrid e incomplete.
+
+## Pendientes
+
+No quedan pendientes dentro de este slice. La limpieza/migracion no destructiva de assets legacy corresponde a `slice-06`.
+
+## Riesgos remanentes
+
+Los mensajes de doctor cambiaron; smokes que esperaban texto exacto del layout viejo deben alinearse en `slice-06`/`slice-08`.
+
+## Recomendaciones futuras
+
+Mantener `doctor` como reporte de estado y recomendaciones; no convertir senales legacy en errores duros salvo que falte un archivo necesario para ejecutar un comando pedido.