create-quiver 0.6.0 → 0.8.0

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "create-quiver",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "private": false,
   "description": "Quiver CLI for scaffolding projects from the packaged template",
   "license": "MIT",
   "bin": {
-    "create-quiver": "./bin/create-quiver.js"
+    "create-quiver": "bin/create-quiver.js"
   },
   "scripts": {
     "check:slice": "bash tools/scripts/check-slice-readiness.sh",
@@ -13,8 +13,12 @@
     "start:slice": "bash tools/scripts/start-slice.sh",
     "cleanup:slice": "bash tools/scripts/cleanup-slice.sh",
     "migrate": "bash tools/scripts/migrate-project.sh",
+    "quiver:plan": "npx create-quiver plan",
+    "quiver:graph": "npx create-quiver graph",
+    "quiver:next": "npx create-quiver next",
     "package:quiver": "bash scripts/package-quiver.sh",
     "smoke:create-quiver": "bash scripts/ci/smoke-create-quiver.sh",
+    "smoke:tiered-pack": "bash scripts/ci/smoke-tiered-pack.sh",
     "release:quiver": "bash scripts/release-quiver.sh"
   }
 }

package/package.template.json

@@ -2,10 +2,26 @@
   "name": "quiver-docs-template",
   "private": true,
   "scripts": {
+  "quiver:migrate": "npx create-quiver migrate",
+  "quiver:analyze": "npx create-quiver analyze",
+  "quiver:plan": "npx create-quiver plan",
+  "quiver:graph": "npx create-quiver graph",
+  "quiver:next": "npx create-quiver next",
+  "quiver:doctor": "npx create-quiver doctor",
+    "quiver:start-slice": "npx create-quiver start-slice",
+    "quiver:check-slice": "npx create-quiver check-slice",
+    "quiver:check-pr": "npx create-quiver check-pr",
+    "quiver:check-handoff": "npx create-quiver check-handoff",
+    "quiver:cleanup-slice": "npx create-quiver cleanup-slice",
+    "quiver:check-scope": "npx create-quiver check-scope",
+    "quiver:refresh-active-slices": "npx create-quiver refresh-active-slices",
     "check:slice": "bash tools/scripts/check-slice-readiness.sh",
     "check:pr": "bash tools/scripts/check-pr-readiness.sh",
+    "check-handoff": "npx create-quiver check-handoff",
     "start:slice": "bash tools/scripts/start-slice.sh",
     "cleanup:slice": "bash tools/scripts/cleanup-slice.sh",
+    "check:scope": "bash tools/scripts/check-scope.sh",
+    "refresh:active-slices": "bash tools/scripts/refresh-active-slices.sh",
     "migrate": "bash tools/scripts/migrate-project.sh"
   }
 }

package/scripts/check-slice-readiness.sh

@@ -82,11 +82,12 @@ slice_rel="${slice_abs#$repo_root/}"
 slice_meta=()
 while IFS= read -r line; do
   slice_meta+=("$line")
-done < <(node - "$slice_abs" "$slice_rel" <<'NODE'
+done < <(node - "$slice_abs" "$slice_rel" "$repo_root" <<'NODE'
 const fs = require('fs');
 const path = require('path');
 
-const [slicePath, sliceRel] = process.argv.slice(2);
+const [slicePath, sliceRel, repoRoot] = process.argv.slice(2);
+const { parseJsonWithComments } = require(path.join(repoRoot, 'src', 'create-quiver', 'lib', 'json'));
 
 function fail(message) {
   console.error(`Error: ${message}`);
@@ -95,7 +96,7 @@ function fail(message) {
 
 let json;
 try {
-  json = JSON.parse(fs.readFileSync(slicePath, 'utf8'));
+  json = parseJsonWithComments(fs.readFileSync(slicePath, 'utf8'));
 } catch (error) {
   fail(`No se pudo parsear '${slicePath}' como JSON: ${error.message}`);
 }
@@ -175,6 +176,7 @@ const cp = require('child_process');
 
 const [repoRoot, currentBranch, currentFilesB64] = process.argv.slice(2);
 const currentFiles = JSON.parse(Buffer.from(currentFilesB64, 'base64').toString('utf8'));
+const { parseJsonWithComments } = require(path.join(repoRoot, 'src', 'create-quiver', 'lib', 'json'));
 
 function run(cmd, cwd = repoRoot) {
   try {
@@ -201,7 +203,7 @@ function walkSlices(rootDir, acc) {
     }
 
     if (entry.isFile() && entry.name === 'slice.json' && fullPath.includes(`${path.sep}slices${path.sep}`)) {
-      const json = JSON.parse(fs.readFileSync(fullPath, 'utf8'));
+      const json = parseJsonWithComments(fs.readFileSync(fullPath, 'utf8'));
       const branchName = json.git?.branch_name;
       if (!branchName) {
         continue;

package/scripts/cleanup-slice.sh

@@ -2,176 +2,6 @@
 
 set -euo pipefail
 
-usage() {
-  cat <<'EOF'
-Uso:
-  bash tools/scripts/cleanup-slice.sh <ruta-al-slice.json> [--close-baseline] [--discard] [--force] [--dry-run]
-
-Politica:
-- slice-00: queda congelado por default; no se elimina salvo --close-baseline
-- slice-01+: se elimina despues de merge/rechazo/reemplazo segun la politica del repo
-
-Opciones:
-  --close-baseline  Permite cerrar y eliminar un slice-00 congelado
-  --discard         Permite cerrar un slice no mergeado (descartado/reemplazado)
-  --force           Fuerza git worktree remove --force y git branch -D
-  --dry-run         Solo informa que haria, no ejecuta cambios
-EOF
-}
-
-fail() {
-  echo "FAIL: $1" >&2
-  exit 1
-}
-
-pass() {
-  echo "PASS: $1"
-}
-
-close_baseline="false"
-discard="false"
-force_delete="false"
-dry_run="false"
-slice_input=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    --close-baseline)
-      close_baseline="true"
-      ;;
-    --discard)
-      discard="true"
-      ;;
-    --force)
-      force_delete="true"
-      ;;
-    --dry-run)
-      dry_run="true"
-      ;;
-    -*)
-      fail "Opcion desconocida: $1"
-      ;;
-    *)
-      if [[ -n "$slice_input" ]]; then
-        fail "Solo se acepta un slice por ejecucion."
-      fi
-      slice_input="$1"
-      ;;
-  esac
-  shift
-done
-
-[[ -n "$slice_input" ]] || {
-  usage
-  exit 1
-}
-
-command -v git >/dev/null 2>&1 || fail "git no esta disponible en PATH."
-command -v node >/dev/null 2>&1 || fail "node no esta disponible en PATH."
-
 repo_root="$(git rev-parse --show-toplevel)"
-
-[[ -f "$slice_input" ]] || fail "No existe el slice '$slice_input'."
-
-slice_abs="$(cd "$(dirname "$slice_input")" && pwd)/$(basename "$slice_input")"
-
-slice_meta=()
-while IFS= read -r line; do
-  slice_meta+=("$line")
-done < <(node - "$slice_abs" "$repo_root" <<'NODE'
-const fs = require('fs');
-const path = require('path');
-
-const [slicePath, repoRoot] = process.argv.slice(2);
-const json = JSON.parse(fs.readFileSync(slicePath, 'utf8'));
-
-const branchName = String(json.git?.branch_name || '').trim();
-const sliceId = String(json.slice_id || '').trim();
-const isBaseline = sliceId.startsWith('slice-00');
-const repoName = path.basename(repoRoot);
-const repoParent = path.dirname(repoRoot);
-const worktreesRoot = process.env.SLICE_WORKTREES_DIR || path.join(repoParent, '.worktrees', repoName);
-const safeBranchName = branchName.replace(/[^A-Za-z0-9._-]/g, '-');
-const worktreePath = path.join(worktreesRoot, safeBranchName);
-
-console.log(branchName);
-console.log(sliceId);
-console.log(isBaseline ? 'true' : 'false');
-console.log(worktreePath);
-NODE
-)
-
-[[ ${#slice_meta[@]} -eq 4 ]] || fail "No se pudo leer la metadata de cleanup del slice."
-
-branch_name="${slice_meta[0]}"
-slice_id="${slice_meta[1]}"
-is_baseline="${slice_meta[2]}"
-worktree_path="${slice_meta[3]}"
-
-[[ -n "$branch_name" ]] || fail "Falta git.branch_name en el slice."
-
-if [[ "$is_baseline" == "true" && "$close_baseline" != "true" ]]; then
-  echo "INFO: '$slice_id' es baseline. El worktree queda congelado por default."
-  echo "INFO: Usa --close-baseline solo cuando la primera ola del spec ya este estable o mergeada."
-  exit 0
-fi
-
-current_branch="$(git branch --show-current)"
-
-if [[ "$discard" != "true" ]]; then
-  [[ "$current_branch" == "develop" ]] || fail "El cleanup normal debe correrse desde develop. Rama actual: $current_branch"
-  [[ -z "$(git status --porcelain)" ]] || fail "El checkout actual no esta limpio. Limpialo antes del cleanup."
-
-  git fetch origin develop >/dev/null 2>&1 || true
-
-  local_develop_sha="$(git rev-parse HEAD)"
-  remote_develop_sha="$(git rev-parse origin/develop)"
-  [[ "$local_develop_sha" == "$remote_develop_sha" ]] || fail "develop local no esta actualizado. Ejecuta git pull --ff-only antes del cleanup."
-
-  if git show-ref --verify --quiet "refs/heads/$branch_name"; then
-    git merge-base --is-ancestor "$branch_name" "origin/develop" || fail "La rama '$branch_name' no esta mergeada en origin/develop. Usa --discard si el slice se descarta."
-  fi
-fi
-
-worktree_exists="false"
-branch_exists="false"
-
-[[ -d "$worktree_path" ]] && worktree_exists="true"
-git show-ref --verify --quiet "refs/heads/$branch_name" && branch_exists="true"
-
-[[ "$worktree_exists" == "true" || "$branch_exists" == "true" ]] || fail "No existe worktree ni rama local para '$slice_id'."
-
-remove_worktree_cmd=(git worktree remove "$worktree_path")
-remove_branch_cmd=(git branch -d "$branch_name")
-
-if [[ "$force_delete" == "true" || "$discard" == "true" ]]; then
-  remove_worktree_cmd=(git worktree remove --force "$worktree_path")
-  remove_branch_cmd=(git branch -D "$branch_name")
-fi
-
-if [[ "$dry_run" == "true" ]]; then
-  echo "DRY RUN: slice=$slice_id branch=$branch_name"
-  [[ "$worktree_exists" == "true" ]] && echo "DRY RUN: ${remove_worktree_cmd[*]}"
-  [[ "$branch_exists" == "true" ]] && echo "DRY RUN: ${remove_branch_cmd[*]}"
-  exit 0
-fi
-
-if [[ "$worktree_exists" == "true" ]]; then
-  "${remove_worktree_cmd[@]}"
-  pass "Worktree eliminado: $worktree_path"
-fi
-
-if [[ "$branch_exists" == "true" ]]; then
-  "${remove_branch_cmd[@]}"
-  pass "Rama local eliminada: $branch_name"
-fi
-
-if [[ -x "$repo_root/tools/scripts/refresh-active-slices.sh" ]]; then
-  "$repo_root/tools/scripts/refresh-active-slices.sh" >/dev/null 2>&1 || true
-fi
-
-pass "Cleanup finalizado para '$slice_id'."
+cd "$repo_root"
+exec npx create-quiver cleanup-slice "$@"

package/scripts/init-docs.sh

@@ -44,6 +44,22 @@ MIGRATE_MODE="${QUIVER_MIGRATE:-0}"
 DATE_PLUS_7=$(node -e 'const d = new Date(); d.setDate(d.getDate() + 7); const p = (n) => String(n).padStart(2, "0"); console.log(`${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`);')
 DATE_PLUS_30=$(node -e 'const d = new Date(); d.setDate(d.getDate() + 30); const p = (n) => String(n).padStart(2, "0"); console.log(`${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`);')
 DATE_PLUS_35=$(node -e 'const d = new Date(); d.setDate(d.getDate() + 35); const p = (n) => String(n).padStart(2, "0"); console.log(`${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`);')
+PACKAGE_MANAGER="npm"
+STACK_SUMMARY="unknown until analyze"
+PRIMARY_INSTALL="npm install"
+PRIMARY_DEV="npm run quiver:analyze"
+PRIMARY_TEST="npm test"
+ANALYZE_COMMAND="npx create-quiver analyze"
+PLAN_COMMAND="npx create-quiver plan"
+GRAPH_COMMAND="npx create-quiver graph"
+NEXT_COMMAND="npx create-quiver next"
+DOCTOR_COMMAND="npx create-quiver doctor"
+START_SLICE_COMMAND="npx create-quiver start-slice <slice.json>"
+CHECK_SLICE_COMMAND="npx create-quiver check-slice <slice.json>"
+CHECK_PR_COMMAND="npx create-quiver check-pr <slice.json>"
+CLEANUP_SLICE_COMMAND="npx create-quiver cleanup-slice <slice.json>"
+CHECK_SCOPE_COMMAND="npx create-quiver check-scope <slice.json>"
+REFRESH_ACTIVE_SLICES_COMMAND="npx create-quiver refresh-active-slices"
 
 print_info "Inicializando documentación para: $PROJECT_NAME"
 print_info "Project slug: $PROJECT_SLUG"
@@ -92,11 +108,24 @@ copy_template() {
             -e "s/{{FECHA}}/$CURRENT_DATE/g" \
             -e "s/{{FECHA_PROXIMA}}/$DATE_PLUS_7/g" \
             -e "s/{{FECHA_PROXIMA_MES}}/$DATE_PLUS_30/g" \
-            -e "s/{{FECHA_LAUNCH}}/$DATE_PLUS_35/g" \
-            -e "s/{{ESTADO}}/En planificación/g" \
-            -e "s/{{FASE}}/Fase 1/g" \
-            -e "s/{{X}}%/0%/g" \
-            "$src" > "$dest"
+        -e "s/{{FECHA_LAUNCH}}/$DATE_PLUS_35/g" \
+        -e "s/{{ESTADO}}/En planificación/g" \
+        -e "s/{{FASE}}/Fase 1/g" \
+        -e "s/{{X}}%/0%/g" \
+        -e "s/{{PACKAGE_MANAGER}}/$PACKAGE_MANAGER/g" \
+        -e "s/{{STACK_SUMMARY}}/$STACK_SUMMARY/g" \
+        -e "s/{{PRIMARY_INSTALL}}/$PRIMARY_INSTALL/g" \
+        -e "s/{{PRIMARY_DEV}}/$PRIMARY_DEV/g" \
+        -e "s/{{PRIMARY_TEST}}/$PRIMARY_TEST/g" \
+        -e "s/{{ANALYZE_COMMAND}}/$ANALYZE_COMMAND/g" \
+        -e "s/{{DOCTOR_COMMAND}}/$DOCTOR_COMMAND/g" \
+        -e "s/{{START_SLICE_COMMAND}}/$START_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_SLICE_COMMAND}}/$CHECK_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_PR_COMMAND}}/$CHECK_PR_COMMAND/g" \
+        -e "s/{{CLEANUP_SLICE_COMMAND}}/$CLEANUP_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_SCOPE_COMMAND}}/$CHECK_SCOPE_COMMAND/g" \
+        -e "s/{{REFRESH_ACTIVE_SLICES_COMMAND}}/$REFRESH_ACTIVE_SLICES_COMMAND/g" \
+        "$src" > "$dest"
         
         print_success "Creado: $dest"
     fi
@@ -107,7 +136,7 @@ copy_template_keep_name() {
     local dest="$2"
 
     if [ -f "$src" ]; then
-        if [ "$MIGRATE_MODE" = "1" ] && [ -f "$dest" ]; then
+        if [ -f "$dest" ]; then
             print_info "Saltado: $dest ya existe"
             return 0
         fi
@@ -120,11 +149,24 @@ copy_template_keep_name() {
             -e "s/{{FECHA}}/$CURRENT_DATE/g" \
             -e "s/{{FECHA_PROXIMA}}/$DATE_PLUS_7/g" \
             -e "s/{{FECHA_PROXIMA_MES}}/$DATE_PLUS_30/g" \
-            -e "s/{{FECHA_LAUNCH}}/$DATE_PLUS_35/g" \
-            -e "s/{{ESTADO}}/En planificación/g" \
-            -e "s/{{FASE}}/Fase 1/g" \
-            -e "s/{{X}}%/0%/g" \
-            "$src" > "$dest"
+        -e "s/{{FECHA_LAUNCH}}/$DATE_PLUS_35/g" \
+        -e "s/{{ESTADO}}/En planificación/g" \
+        -e "s/{{FASE}}/Fase 1/g" \
+        -e "s/{{X}}%/0%/g" \
+        -e "s/{{PACKAGE_MANAGER}}/$PACKAGE_MANAGER/g" \
+        -e "s/{{STACK_SUMMARY}}/$STACK_SUMMARY/g" \
+        -e "s/{{PRIMARY_INSTALL}}/$PRIMARY_INSTALL/g" \
+        -e "s/{{PRIMARY_DEV}}/$PRIMARY_DEV/g" \
+        -e "s/{{PRIMARY_TEST}}/$PRIMARY_TEST/g" \
+        -e "s/{{ANALYZE_COMMAND}}/$ANALYZE_COMMAND/g" \
+        -e "s/{{DOCTOR_COMMAND}}/$DOCTOR_COMMAND/g" \
+        -e "s/{{START_SLICE_COMMAND}}/$START_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_SLICE_COMMAND}}/$CHECK_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_PR_COMMAND}}/$CHECK_PR_COMMAND/g" \
+        -e "s/{{CLEANUP_SLICE_COMMAND}}/$CLEANUP_SLICE_COMMAND/g" \
+        -e "s/{{CHECK_SCOPE_COMMAND}}/$CHECK_SCOPE_COMMAND/g" \
+        -e "s/{{REFRESH_ACTIVE_SLICES_COMMAND}}/$REFRESH_ACTIVE_SLICES_COMMAND/g" \
+        "$src" > "$dest"
 
         print_success "Creado: $dest"
     fi
@@ -151,9 +193,19 @@ copy_file_if_missing() {
 }
 
 # Copiar templates de docs/
+copy_template_keep_name "docs-template/AGENTS.md.template" "AGENTS.md"
 copy_template "docs-template/docs/INDEX.md.template" "docs/INDEX.md"
+copy_template "docs-template/docs/COMMANDS.md.template" "docs/COMMANDS.md"
+copy_template "docs-template/docs/QUICK.md.template" "docs/ai/QUICK.md"
+copy_template "docs-template/docs/STANDARD.md.template" "docs/ai/STANDARD.md"
+copy_template "docs-template/docs/DEEP.md.template" "docs/ai/DEEP.md"
+copy_template "docs-template/docs/examples/plan.md.template" "docs/examples/plan.md"
+copy_template "docs-template/docs/examples/graph.md.template" "docs/examples/graph.md"
+copy_template "docs-template/docs/examples/next.md.template" "docs/examples/next.md"
+copy_template "docs-template/docs/DECISIONS.md.template" "docs/DECISIONS.md"
 copy_template "docs-template/docs/AI_CONTEXT.md.template" "docs/AI_CONTEXT.md"
 copy_template "docs-template/docs/AI_ONBOARDING_PROMPT.md.template" "docs/AI_ONBOARDING_PROMPT.md"
+copy_template "docs-template/specs/[project-name]/HANDOFF.md.template" "specs/$PROJECT_SLUG/HANDOFF.md"
 copy_template "docs-template/docs/CONTEXTO.md.template" "docs/CONTEXTO.md"
 copy_template "docs-template/docs/STATUS.md.template" "docs/STATUS.md"
 copy_template "docs-template/docs/WORKFLOW.md.template" "docs/WORKFLOW.md"
@@ -403,7 +455,7 @@ cat > "docs/SEARCH.md" << EOF
 
 - **Spec:** \`../specs/$PROJECT_SLUG/slices/slice-01/slice.json\`
 - **PR del slice:** \`../specs/$PROJECT_SLUG/slices/slice-01/pr.md\`
-- **Bootstrap del slice:** \`../tools/scripts/start-slice.sh ../specs/$PROJECT_SLUG/slices/slice-01/slice.json\`
+- **Bootstrap del slice:** \`npx create-quiver start-slice ../specs/$PROJECT_SLUG/slices/slice-01/slice.json\`
 - **Hook:** \`hooks/useAuth.ts\`
 - **API:** \`docs/api/auth/README.md\`
 - **Componentes:** \`app/(auth)/\`
@@ -444,8 +496,11 @@ Run Quiver from this project root. Do not install it globally.
 
 \`\`\`bash
 npm install
-npx create-quiver analyze --dir .
-npx create-quiver doctor --dir .
+$ANALYZE_COMMAND
+$PLAN_COMMAND
+$GRAPH_COMMAND
+$DOCTOR_COMMAND
+$NEXT_COMMAND
 \`\`\`
 
 If this project needs a pinned Quiver version, install it as a devDependency:
@@ -454,7 +509,39 @@ If this project needs a pinned Quiver version, install it as a devDependency:
 npm install --save-dev create-quiver
 \`\`\`
 
-If your project path contains spaces, quote it explicitly when using \`--dir\`.
+If you need to target another directory from outside the project, pass \`--dir\` explicitly. Quote paths that contain spaces.
+
+## Project NPM Scripts
+
+The generated project includes \`quiver:*\` npm scripts that call the Node CLI and are the preferred repeatable workflow:
+
+\`\`\`bash
+npm run quiver:analyze
+npm run quiver:plan
+npm run quiver:graph
+npm run quiver:next
+npm run quiver:doctor
+npm run quiver:migrate
+npm run quiver:start-slice -- specs/$PROJECT_SLUG/slices/slice-01/slice.json
+npm run quiver:check-slice -- specs/$PROJECT_SLUG/slices/slice-01/slice.json
+npm run quiver:check-pr -- specs/$PROJECT_SLUG/slices/slice-01/slice.json
+npm run quiver:check-handoff -- specs/$PROJECT_SLUG/HANDOFF.md
+npm run quiver:cleanup-slice -- specs/$PROJECT_SLUG/slices/slice-01/slice.json
+npm run quiver:check-scope -- specs/$PROJECT_SLUG/slices/slice-01/slice.json
+npm run quiver:refresh-active-slices
+\`\`\`
+
+The \`quiver:graph\` script prints the tree view by default; use \`npx create-quiver graph --format mermaid\` for PR-ready Markdown and \`--format dot\` when you want Graphviz source.
+The \`quiver:next\` script points to the next ready slice and can auto-start it behind a confirmation prompt.
+Use \`npx create-quiver next --all-ready\` when you want the full ready level instead of a single suggestion.
+The legacy Bash wrappers remain in \`tools/scripts/\` for compatibility, but new project-level automation should prefer the \`quiver:*\` scripts and the direct \`npx create-quiver ...\` commands below.
+\`npm run check-handoff -- specs/$PROJECT_SLUG/HANDOFF.md\` is available as a legacy-friendly alias for the handoff validator.
+If a new bounded transfer is needed, scaffold \`specs/$PROJECT_SLUG/HANDOFF.md\` with \`npx create-quiver new-handoff $PROJECT_SLUG\` and validate it with \`npx create-quiver check-handoff specs/$PROJECT_SLUG/HANDOFF.md\`.
+For exceptional context transfers between agents or phases, a dedicated \`HANDOFF.md\` can live alongside the usual spec and docs files.
+
+## Cross-Platform Support
+
+Quiver is targeting native support on macOS, Linux, and Windows PowerShell/CMD. Bash is a legacy compatibility path until the runtime slices land, so the generated workflow should be read as a native Node-first contract rather than a Bash-first one. Windows support is only considered verified once the CI matrix is green.
 
 ## Upgrading Existing Projects
 
@@ -462,22 +549,41 @@ If the project already existed before this Quiver version, upgrade it from the p
 
 \`\`\`bash
 cd /path/to/your-project
-npx create-quiver migrate --dir .
-npx create-quiver analyze --dir .
-npx create-quiver doctor --dir .
+npx create-quiver migrate
+$ANALYZE_COMMAND
+$PLAN_COMMAND
+$GRAPH_COMMAND
+$NEXT_COMMAND
+$DOCTOR_COMMAND
+\`\`\`
+
+Use \`$GRAPH_COMMAND --format mermaid\` for GitHub-friendly graph embeds or \`$GRAPH_COMMAND --format dot\` for Graphviz pipelines.
+
+Exportable graph formats are available when you need a PR-ready Mermaid block or Graphviz source:
+
+\`\`\`bash
+$GRAPH_COMMAND --format mermaid
+$GRAPH_COMMAND --format dot
 \`\`\`
 
 If your team prefers a pinned local dependency, update the package first and then run the same flow:
 
 \`\`\`bash
 npm install --save-dev create-quiver@latest
-npx create-quiver migrate --dir .
-npx create-quiver analyze --dir .
-npx create-quiver doctor --dir .
+npx create-quiver migrate
+npx create-quiver analyze
+npx create-quiver plan
+npx create-quiver graph
+npx create-quiver next
+npx create-quiver doctor
 \`\`\`
 
+The tree output remains the default, but Mermaid and DOT are available on demand for exported docs and slide decks.
+
 ## AI Context Onboarding
 
+Lee \`AGENTS.md\` primero y después \`docs/AI_ONBOARDING_PROMPT.md\` tras el análisis.
+
 After analysis and doctor validation, open your AI agent in this project and run:
 
 \`\`\`text
@@ -487,27 +593,42 @@ Prepare the project context docs and report assumptions, risks, and files change
 \`\`\`
 
 Review the AI changes to docs/AI_CONTEXT.md, docs/CONTEXTO.md, docs/STATUS.md, and specs/$PROJECT_SLUG/SPEC.md before starting implementation work.
+If the work was explicitly transferred through a handoff artifact, read \`specs/$PROJECT_SLUG/HANDOFF.md\` before implementation.
+
+## Decision Log
+
+Record durable decisions in \`docs/DECISIONS.md\` so future AI agents do not re-litigate the same choices.
 
 ## First Slice Workflow
 
 1. Review or refine specs/$PROJECT_SLUG/SPEC.md.
 2. Create the first slice from specs/$PROJECT_SLUG/slices/slice-template/slice.json.
-3. Start work with tools/scripts/start-slice.sh <slice.json>.
-4. Make one commit per slice.
-5. Open one PR per spec.
+3. Review the plan with \`$PLAN_COMMAND\` or \`npm run quiver:plan\`.
+4. Inspect the graph with \`$GRAPH_COMMAND\` or \`npm run quiver:graph\`.
+5. Check the next ready slice with \`$NEXT_COMMAND\` or \`npm run quiver:next\`.
+6. Start work with \`$START_SLICE_COMMAND\` or \`npm run quiver:start-slice -- <slice.json>\`.
+7. Make one commit per slice.
+8. Open one PR per spec.
 
 ## Verification Checklist
 
 - [ ] npm install completes
-- [ ] npx create-quiver analyze --dir . completes
-- [ ] npx create-quiver doctor --dir . completes
+- [ ] $ANALYZE_COMMAND completes
+- [ ] $PLAN_COMMAND completes
+- [ ] $GRAPH_COMMAND completes
+- [ ] $NEXT_COMMAND completes
+- [ ] $DOCTOR_COMMAND completes
 - [ ] AI agent executed docs/AI_ONBOARDING_PROMPT.md
 - [ ] Context docs were reviewed before the first slice
 
 ## Documentation
 
 - [AI Context](./docs/AI_CONTEXT.md) - Contexto resumido para IA
+- [Decision Log](./docs/DECISIONS.md) - Decisiones durables del proyecto
 - [AI Onboarding Prompt](./docs/AI_ONBOARDING_PROMPT.md) - Handoff exacto para agentes después del análisis
+- [Handoff](./specs/$PROJECT_SLUG/HANDOFF.md) - Transferencia excepcional entre agentes o fases
+- [Check Handoff](./docs/WORKFLOW.md) - Valida el handoff con \`npx create-quiver check-handoff\`
+- [Commands](./docs/COMMANDS.md) - Tabla canónica de comandos de orquestación
 - [Contexto](./docs/CONTEXTO.md) - Qué es $PROJECT_NAME
 - [Workflow](./docs/WORKFLOW.md) - Cómo implementar
 - [Support Matrix](./docs/SUPPORT_MATRIX.md) - Qué entornos están soportados

package/scripts/package-quiver.sh

@@ -58,6 +58,11 @@ required_paths=(
   "package/src/create-quiver/index.js"
   "package/README.md"
   "package/README_FOR_AI.md"
+  "package/AGENTS.md.template"
+  "package/docs/QUICK.md.template"
+  "package/docs/STANDARD.md.template"
+  "package/docs/DEEP.md.template"
+  "package/docs/DECISIONS.md.template"
   "package/docs/AI_CONTEXT.md.template"
   "package/docs/AI_ONBOARDING_PROMPT.md.template"
   "package/TEMPLATE.md"