create-quiver 0.9.0 → 0.10.0

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.

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

@@ -0,0 +1,60 @@
+# EXECUTION BRIEF - slice-05: Empty specs and layout doctor
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-05-empty-specs-layout-doctor
+**Tipo:** feature
+
+## Contexto
+
+Default init ya no debe crear specs falsas. Por eso los comandos que recorren slices deben aceptar que todavia no haya specs.
+
+## Objetivo
+
+Hacer que comandos de planificacion y doctor soporten layout nuevo, legacy e hibrido sin falsos errores.
+
+## Alcance
+
+- `plan`
+- `graph`
+- `next`
+- `doctor`
+- Deteccion de layout.
+- Tests de no-spec repos.
+
+## Criterios de aceptacion
+
+- `plan`, `graph`, `next` y `doctor` no fallan por ausencia de specs.
+- Doctor detecta layout nuevo, legacy, hibrido e incompleto.
+- Doctor reporta recomendaciones accionables.
+- Proyectos con specs existentes siguen funcionando.
+
+## Plan tecnico resumido
+
+Separar "no specs yet" de errores reales. Agregar detector de layout en doctor y actualizar formatters para comunicar estados vacios.
+
+## Pasos sugeridos de ejecucion
+
+1. Agregar fixtures sin specs.
+2. Ajustar colectores de slices para estado vacio.
+3. Ajustar salidas human/json.
+4. Agregar detector de layout.
+5. Agregar tests de legacy/hibrido.
+
+## Restricciones
+
+- No migrar archivos.
+- No ocultar errores reales de JSON invalido.
+- No cambiar formato JSON existente salvo campos compatibles.
+
+## Riesgos
+
+- Convertir errores reales en estados vacios.
+- Romper automatizaciones que esperan exit code no cero.
+- Mensajes ambiguos para usuarios nuevos.
+
+## Checklist de finalizacion
+
+- [ ] No-spec tests pasan.
+- [ ] Layout doctor testeado.
+- [ ] Proyectos con specs siguen pasando.
+- [ ] Salidas JSON siguen parseables.

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

@@ -0,0 +1,65 @@
+{
+  "slice_id": "slice-05-empty-specs-layout-doctor",
+  "ticket": "QUIVER-21-05",
+  "type": "feature",
+  "title": "Support empty specs state and layout doctor",
+  "objective": "Make plan, graph, next, and doctor treat projects without specs as valid while doctor reports new, legacy, and hybrid layouts.",
+  "description": "Default init no longer creates placeholder specs, so orchestration commands must handle an empty specs directory or no specs directory cleanly.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "empty-specs-layout-doctor",
+    "branch_name": "feature/QUIVER-21-05-empty-specs-layout-doctor"
+  },
+  "files": [
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/commands/next.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/index.js",
+    "tests/commands/doctor.test.js",
+    "tests/commands/plan.test.js",
+    "tests/commands/graph.test.js",
+    "tests/commands/next.test.js",
+    "tests/lib/doctor.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-05-empty-specs-layout-doctor/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-05-empty-specs-layout-doctor/slice.json"
+  ],
+  "depends_on": [
+    "slice-03-generation-profiles-visible-contract",
+    "slice-04-analyze-scan-relocation"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Requires the new default no-spec behavior and scan path compatibility.",
+  "must": [
+    "Make `plan` return a clear valid empty state when no specs exist.",
+    "Make `graph` return a clear valid empty state when no specs exist.",
+    "Make `next` return a clear valid empty state when no specs exist.",
+    "Make `doctor` detect layout type: new, legacy, hybrid, or incomplete.",
+    "Doctor must not treat missing specs as an error immediately after default init.",
+    "Doctor should surface actionable recommendations for legacy files."
+  ],
+  "not_included": [
+    "Migrating legacy files.",
+    "Changing spec generation.",
+    "Documentation copy beyond command output strings."
+  ],
+  "acceptance": [
+    "No-spec projects do not fail `plan`, `graph`, `next`, or `doctor` unexpectedly.",
+    "Doctor reports layout state with clear language.",
+    "Legacy paths are warnings or recommendations, not hard failures.",
+    "Existing behavior for projects with specs remains intact."
+  ],
+  "tests": [
+    "node --test tests/commands/doctor.test.js tests/lib/doctor.test.js tests/commands/plan.test.js tests/commands/graph.test.js tests/commands/next.test.js",
+    "node --test tests/**/*.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 5,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/CLOSURE_BRIEF.md

@@ -0,0 +1,31 @@
+# CLOSURE BRIEF - slice-06: Legacy migration and optional assets
+
+## Resumen de lo realizado
+
+Se implemento la transicion no destructiva para migracion y se habilitaron los assets opcionales explicitos.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Migracion no destructiva.
+- [x] Legacy scripts opcionales.
+- [x] Templates exportados bajo `.quiver/`.
+- [x] Full mode validado.
+
+## Cambios relevantes
+
+- `migrate` ahora reporta layout legado detectado y preservado, incluyendo `docs-template/`, `tools/scripts/` y `docs/PROJECT_SCAN.json`.
+- `init --legacy-scripts` crea wrappers Bash y scripts npm compatibles.
+- `init --include-templates` exporta templates a `.quiver/templates/`.
+- `init --full` sigue habilitando el layout amplio de compatibilidad.
+
+## Pendientes
+
+Ninguno para este slice.
+
+## Riesgos remanentes
+
+- La salida de migracion sigue siendo conservadora: detecta y reporta, pero no limpia automaticamente el layout viejo.
+
+## Recomendaciones futuras
+
+- Mantener las smokes de migracion y perfiles opcionales en slices posteriores para evitar regresiones.

package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/EXECUTION_BRIEF.md

@@ -0,0 +1,62 @@
+# EXECUTION BRIEF - slice-06: Legacy migration and optional assets
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-06-legacy-migration-optional-assets
+**Tipo:** feature
+
+## Contexto
+
+Cambiar el default no alcanza: proyectos existentes pueden tener layout viejo y algunos usuarios siguen necesitando scripts o templates visibles.
+
+## Objetivo
+
+Agregar transicion no destructiva y flags explicitos para assets opcionales.
+
+## Alcance
+
+- `migrate` legacy detection.
+- `--legacy-scripts`.
+- `--include-templates`.
+- `--full` broad optional assets.
+- Smokes de migracion y perfiles opcionales.
+
+## Criterios de aceptacion
+
+- `migrate` no borra ni mueve archivos legacy.
+- Layout legacy se detecta y reporta.
+- `--legacy-scripts` crea wrappers y scripts validos.
+- `--include-templates` exporta a `.quiver/templates/`.
+- `--full` mantiene assets amplios de forma explicita.
+
+## Plan tecnico resumido
+
+Extender perfiles y migracion para distinguir cleanup sugerido de acciones destructivas. Mantener compatibilidad por lectura y generar opcionales solo cuando el usuario lo pide.
+
+## Pasos sugeridos de ejecucion
+
+1. Agregar deteccion legacy en migrate.
+2. Implementar generacion legacy scripts bajo flag.
+3. Implementar export de templates bajo `.quiver/templates/`.
+4. Definir set full.
+5. Actualizar package scripts segun flags.
+6. Agregar smokes de migracion.
+
+## Restricciones
+
+- No borrar archivos legacy.
+- No crear root `docs-template/` en layout nuevo.
+- No mezclar scripts legacy en default.
+
+## Riesgos
+
+- Flags combinados generen scripts inconsistentes.
+- Migracion demasiado silenciosa.
+- Full mode arrastre demasiada deuda sin documentar.
+
+## Checklist de finalizacion
+
+- [ ] Migrate preserva legacy.
+- [ ] Legacy scripts validos.
+- [ ] Include templates validado.
+- [ ] Full mode validado.
+- [ ] Recomendaciones de migracion claras.

package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/slice.json

@@ -0,0 +1,66 @@
+{
+  "slice_id": "slice-06-legacy-migration-optional-assets",
+  "ticket": "QUIVER-21-06",
+  "type": "feature",
+  "title": "Add legacy migration and optional assets",
+  "objective": "Make migration non-destructive for legacy layouts and implement explicit optional generation for legacy scripts and templates.",
+  "description": "This slice handles transition behavior so existing projects can keep working while new projects stay clean by default.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "legacy-migration-optional-assets",
+    "branch_name": "feature/QUIVER-21-06-legacy-migration-optional-assets"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/state.js",
+    "scripts/migrate-project.sh",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.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-06-legacy-migration-optional-assets/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/slice.json"
+  ],
+  "depends_on": [
+    "slice-03-generation-profiles-visible-contract",
+    "slice-04-analyze-scan-relocation"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Can run after generation profiles and scan relocation are stable.",
+  "must": [
+    "`migrate` must not delete or move legacy files without explicit user action.",
+    "`migrate` must detect legacy root `docs-template/`, `tools/scripts/`, and `docs/PROJECT_SCAN.json`.",
+    "`--legacy-scripts` must create Bash wrappers and matching package scripts.",
+    "`--include-templates` must export templates under `.quiver/templates/`.",
+    "`--full` must keep broad optional docs and OSS/community files as explicit behavior.",
+    "Migration output must explain recommended next steps for legacy-to-AI-first cleanup."
+  ],
+  "not_included": [
+    "Automatic destructive cleanup of legacy files.",
+    "Publishing package release.",
+    "Long-form documentation rewrite."
+  ],
+  "acceptance": [
+    "Legacy project migration preserves existing files.",
+    "Legacy layout is detected and reported.",
+    "`--legacy-scripts` creates wrappers and scripts that point to real files.",
+    "`--include-templates` creates `.quiver/templates/` and no root `docs-template/`.",
+    "`--full` covers optional broad assets intentionally."
+  ],
+  "tests": [
+    "node --test tests/commands/init-profiles.test.js tests/lib/init-docs.test.js",
+    "node --test tests/**/*.test.js",
+    "bash scripts/ci/smoke-init-docs.sh",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "node scripts/ci/smoke-cross-platform.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 7,
+  "actual_hours": 6,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-07: Documentation and guidance alignment
+
+## Resumen de lo realizado
+
+Se alineo la documentacion humana, la guia para agentes y las plantillas generadas con el layout AI-first actual. El flujo default ahora queda documentado como contrato visible chico con maquinaria interna en `.quiver/`, mientras `docs-template/`, `tools/scripts/` y los specs placeholder quedan marcados como compatibilidad u opciones explicitas.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Visible vs interno documentado.
+- [x] Legacy marcado como compatibilidad.
+- [x] Specs reales documentadas en fase spec.
+- [x] Paths de scan/map correctos.
+
+## Cambios relevantes
+
+- `README.md` prioriza `init --name`, `.quiver/`, `docs/PROJECT_MAP.md` y el flujo planner/executor.
+- `README_FOR_AI.md` dejo de presentar `docs-template/` como onboarding normal.
+- `docs/AI_ONBOARDING_PROMPT.md.template`, `docs/WORKFLOW.md.template` y `docs/STANDARD.md.template` apuntan al mapa visible y al scan crudo en `.quiver/scans/PROJECT_SCAN.json`.
+- `docs/COMMANDS.md.template` documenta init, profiles y analyzer output.
+- `src/create-quiver/lib/init-docs.js` y `scripts/init-docs.sh` ajustan README generado y dejan el script Bash como compatibilidad legacy.
+- Los smokes esperan la ruta nueva del scan en el onboarding prompt generado.
+
+## Pendientes
+
+Ninguno para este slice.
+
+## Riesgos remanentes
+
+El script Bash `scripts/init-docs.sh` sigue siendo una ruta legacy amplia y conserva referencias internas a `docs-template/`, `tools/scripts/` y `slice-template` porque ese es su proposito de compatibilidad.
+
+## Recomendaciones futuras
+
+Completar `slice-08` con la validacion final de smokes, release readiness y consistencia del paquete antes de publicar.