create-quiver 0.5.0 → 0.7.0

package/scripts/start-slice.sh

@@ -2,428 +2,6 @@
 
 set -euo pipefail
 
-usage() {
-  cat <<'EOF'
-Uso:
-  bash tools/scripts/start-slice.sh [--allow-draft] <ruta-al-slice.json>
-
-Lee la metadata git del slice, valida la rama declarada y crea un worktree
-afuera de la raiz trackeada del repo.
-
-Variables opcionales:
-  SLICE_WORKTREES_DIR  Directorio base para los worktrees.
-                       Default: <repo-parent>/.worktrees/<repo-name>
-  --allow-draft        Permite bootstraps intencionales de slices en draft.
-EOF
-}
-
-append_unique_line() {
-  local file_path="$1"
-  local line="$2"
-
-  mkdir -p "$(dirname "$file_path")"
-  touch "$file_path"
-
-  if ! grep -Fxq "$line" "$file_path"; then
-    printf '%s\n' "$line" >> "$file_path"
-  fi
-}
-
-ensure_local_exclude() {
-  local workdir="$1"
-  local pattern="$2"
-  local exclude_path
-  local git_dir
-
-  git_dir="$(git -C "$workdir" rev-parse --absolute-git-dir)"
-  exclude_path="$git_dir/info/exclude"
-  append_unique_line "$exclude_path" "$pattern"
-}
-
-canonicalize_dir() {
-  local dir_path="$1"
-  (cd "$dir_path" && pwd -P)
-}
-
-resolve_base_ref() {
-  local base_branch="$1"
-
-  if git show-ref --verify --quiet "refs/heads/$base_branch"; then
-    printf '%s\n' "$base_branch"
-    return 0
-  fi
-
-  if git show-ref --verify --quiet "refs/remotes/origin/$base_branch"; then
-    printf '%s\n' "origin/$base_branch"
-    return 0
-  fi
-
-  if git ls-remote --exit-code --heads origin "$base_branch" >/dev/null 2>&1; then
-    if git fetch origin "$base_branch:refs/remotes/origin/$base_branch" >/dev/null 2>&1; then
-      printf '%s\n' "origin/$base_branch"
-      return 0
-    fi
-
-    echo "Error: origin existe pero no se pudo actualizar '$base_branch'. Revisa conectividad o crea la rama local '$base_branch' antes de correr start-slice.sh." >&2
-    return 1
-  fi
-
-  echo "Error: no se encontró '$base_branch' como rama local ni como ref remota 'origin/$base_branch'. Crea la rama base localmente o configura origin antes de correr start-slice.sh." >&2
-  return 1
-}
-
-slice_alias() {
-  node - "$1" <<'NODE'
-const ticket = String(process.argv[2] || '').trim();
-const parts = ticket.split('-').filter(Boolean);
-const prefix = (parts[0] || 'GEN').replace(/[^A-Za-z0-9]/g, '').toUpperCase();
-const suffix = (parts[parts.length - 1] || '00').replace(/[^A-Za-z0-9]/g, '').toUpperCase();
-const short = prefix.length <= 3 ? prefix : prefix.slice(0, 3);
-process.stdout.write(`${short || 'GEN'}-${suffix || '00'}`);
-NODE
-}
-
-write_worktree_context() {
-  local target_worktree="$1"
-  local target_branch="$2"
-
-  if [[ "$target_worktree" != "$repo_root" ]]; then
-    ensure_local_exclude "$target_worktree" "WORKTREE_CONTEXT.md"
-  fi
-
-  node - "$slice_abs" "$target_worktree" "$target_branch" "$spec_family" "$spec_slug" <<'NODE' > "$target_worktree/WORKTREE_CONTEXT.md"
-const fs = require('fs');
-
-const [slicePath, worktreePath, branchName, specFamily, specSlug] = process.argv.slice(2);
-const slice = JSON.parse(fs.readFileSync(slicePath, 'utf8'));
-
-function toAlias(ticket) {
-  const parts = String(ticket || '').split('-').filter(Boolean);
-  const prefix = (parts[0] || 'GEN').replace(/[^A-Za-z0-9]/g, '').toUpperCase();
-  const suffix = (parts[parts.length - 1] || '00').replace(/[^A-Za-z0-9]/g, '').toUpperCase();
-  const short = prefix.length <= 3 ? prefix : prefix.slice(0, 3);
-  return `${short || 'GEN'}-${suffix || '00'}`;
-}
-
-function listBlock(items) {
-  if (!Array.isArray(items) || items.length === 0) {
-    return '- n/a';
-  }
-
-  return items.map((item) => `- ${item}`).join('\n');
-}
-
-const alias = toAlias(slice.ticket);
-const status = slice.status || 'pending';
-const title = slice.title || slice.slice_id;
-const objective = slice.objective || 'Sin objetivo declarado.';
-
-const lines = [
-  '# Worktree Context',
-  '',
-  '> Archivo generado localmente por `tools/scripts/start-slice.sh`.',
-  '> No se trackea en git.',
-  '',
-  `**Alias:** ${alias}`,
-  `**Spec:** ${specSlug}`,
-  `**Spec family:** ${specFamily}`,
-  `**Slice:** ${slice.slice_id}`,
-  `**Ticket:** ${slice.ticket}`,
-  `**Branch:** ${branchName}`,
-  `**Worktree:** ${worktreePath}`,
-  `**Status:** ${status}`,
-  '',
-  '## Title',
-  '',
-  title,
-  '',
-  '## Objective',
-  '',
-  objective,
-  '',
-  '## Routes',
-  '',
-  listBlock(slice.ui_scope?.routes),
-  '',
-  '## Components',
-  '',
-  listBlock(slice.ui_scope?.components),
-  '',
-  '## Allowed Files',
-  '',
-  listBlock(slice.files),
-  '',
-  '## Constraints',
-  '',
-  listBlock(slice.not_included),
-  '',
-  '## Expected Validation',
-  '',
-  listBlock(slice.acceptance),
-  ''
-];
-
-process.stdout.write(`${lines.join('\n')}\n`);
-NODE
-}
-
-refresh_active_slices_board() {
-  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
-}
-
-allow_draft="0"
-args=()
-for arg in "$@"; do
-  case "$arg" in
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    --allow-draft)
-      allow_draft="1"
-      ;;
-    *)
-      args+=("$arg")
-      ;;
-  esac
-done
-
-[[ "${ALLOW_DRAFT_SLICE:-}" == "1" ]] && allow_draft="1"
-
-if [[ ${#args[@]} -ne 1 ]]; then
-  usage
-  exit 1
-fi
-
-if ! command -v git >/dev/null 2>&1; then
-  echo "Error: git no esta disponible en PATH." >&2
-  exit 1
-fi
-
-if ! command -v node >/dev/null 2>&1; then
-  echo "Error: node no esta disponible en PATH." >&2
-  exit 1
-fi
-
-slice_input="${args[0]}"
-repo_root="$(canonicalize_dir "$(git rev-parse --show-toplevel)")"
-
-if [[ ! -f "$slice_input" ]]; then
-  echo "Error: no existe el slice '$slice_input'." >&2
-  exit 1
-fi
-
-slice_abs="$(canonicalize_dir "$(dirname "$slice_input")")/$(basename "$slice_input")"
-slice_rel="${slice_abs#$repo_root/}"
-
-case "$slice_rel" in
-  specs-fix/*/slices/*/slice.json)
-    spec_family="specs-fix"
-    spec_slug="$(printf '%s\n' "$slice_rel" | cut -d/ -f2)"
-    ;;
-  specs/*/slices/*/slice.json)
-    spec_family="specs"
-    spec_slug="$(printf '%s\n' "$slice_rel" | cut -d/ -f2)"
-    ;;
-  *)
-    echo "Error: el slice debe vivir dentro de specs/ o specs-fix/." >&2
-    exit 1
-    ;;
-esac
-
-slice_meta=()
-while IFS= read -r line; do
-  slice_meta+=("$line")
-done < <(node - "$slice_abs" <<'NODE'
-const fs = require('fs');
-
-const slicePath = process.argv[2];
-
-function fail(message) {
-  console.error(`Error: ${message}`);
-  process.exit(1);
-}
-
-let json;
-try {
-  json = JSON.parse(fs.readFileSync(slicePath, 'utf8'));
-} catch (error) {
-  fail(`No se pudo parsear '${slicePath}' como JSON: ${error.message}`);
-}
-
-const ticket = typeof json.ticket === 'string' ? json.ticket.trim() : '';
-const git = json.git ?? {};
-const branchType = typeof git.branch_type === 'string' ? git.branch_type.trim() : '';
-const baseBranch = typeof git.base_branch === 'string' ? git.base_branch.trim() : '';
-const branchSlug = typeof git.branch_slug === 'string' ? git.branch_slug.trim() : '';
-const branchName = typeof git.branch_name === 'string' ? git.branch_name.trim() : '';
-const sliceId = typeof json.slice_id === 'string' ? json.slice_id.trim() : '';
-
-if (!sliceId) {
-  fail('Falta "slice_id" en el slice.');
-}
-
-if (!ticket) {
-  fail('Falta "ticket" en el slice.');
-}
-
-if (!branchType || !baseBranch || !branchSlug || !branchName) {
-  fail('El bloque "git" debe incluir "branch_type", "base_branch", "branch_slug" y "branch_name".');
-}
-
-const expectedBaseByType = {
-  feature: 'develop',
-  bugfix: 'develop',
-  hotfix: 'main'
-};
-
-if (!expectedBaseByType[branchType]) {
-  fail(`git.branch_type invalido: "${branchType}". Usa "feature", "bugfix" o "hotfix".`);
-}
-
-const expectedBaseBranch = expectedBaseByType[branchType];
-if (baseBranch !== expectedBaseBranch) {
-  fail(`git.base_branch invalido para ${branchType}. Esperado: "${expectedBaseBranch}".`);
-}
-
-const expectedBranchName = `${branchType}/${ticket}-${branchSlug}`;
-if (branchName !== expectedBranchName) {
-  fail(`git.branch_name invalido. Esperado: "${expectedBranchName}".`);
-}
-
-console.log(sliceId);
-console.log(ticket);
-console.log(branchType);
-console.log(baseBranch);
-console.log(branchSlug);
-console.log(branchName);
-console.log(String(json.status || 'draft'));
-NODE
-)
-
-if [[ ${#slice_meta[@]} -ne 7 ]]; then
-  echo "Error: no se pudo leer la metadata git del slice." >&2
-  exit 1
-fi
-
-slice_id="${slice_meta[0]}"
-ticket="${slice_meta[1]}"
-branch_type="${slice_meta[2]}"
-base_branch="${slice_meta[3]}"
-branch_slug="${slice_meta[4]}"
-branch_name="${slice_meta[5]}"
-slice_status="${slice_meta[6]}"
-
-if [[ "$slice_status" == "blocked" ]]; then
-  echo "Error: el slice esta bloqueado (status=blocked). Resolve el bloqueante antes de iniciar." >&2
-  exit 1
-fi
-
-if [[ "$slice_status" == "cancelled" ]]; then
-  echo "Error: el slice esta cancelado (status=cancelled)." >&2
-  exit 1
-fi
-
-if [[ "$slice_status" == "completed" ]]; then
-  echo "WARN: el slice ya figura como completed. Si realmente corresponde reejecutarlo, cambia el status a in_progress."
-fi
-
-if [[ "$slice_status" == "draft" && "$allow_draft" != "1" ]]; then
-  echo "Error: el slice esta en estado 'draft'. Marca el slice como 'ready' o usa --allow-draft para un bootstrap intencional." >&2
-  exit 1
-fi
-
-if [[ "$slice_status" == "draft" ]]; then
-  echo "WARN: bootstrap intencional para un slice en draft."
-fi
-
-repo_name="$(basename "$repo_root")"
-repo_parent="$(dirname "$repo_root")"
-worktrees_root="${SLICE_WORKTREES_DIR:-$repo_parent/.worktrees/$repo_name}"
-safe_branch_name="$(printf '%s' "$branch_name" | sed 's#[^A-Za-z0-9._-]#-#g')"
-worktree_path="$worktrees_root/$safe_branch_name"
-
-git worktree prune >/dev/null 2>&1 || true
-
-existing_worktree_path="$(
-  node - "$branch_name" <<'NODE'
-const cp = require('child_process');
-
-const branchRef = `refs/heads/${process.argv[2]}`;
-const text = cp.execSync('git worktree list --porcelain', {
-  encoding: 'utf8',
-  stdio: ['ignore', 'pipe', 'pipe']
-});
-
-let currentPath = '';
-for (const line of text.trim().split('\n')) {
-  if (line.startsWith('worktree ')) {
-    currentPath = line.slice('worktree '.length);
-    continue;
-  }
-
-  if (line === `branch ${branchRef}`) {
-    process.stdout.write(currentPath);
-    break;
-  }
-}
-NODE
-)"
-
-if [[ -n "$existing_worktree_path" && ! -d "$existing_worktree_path" ]]; then
-  existing_worktree_path=""
-fi
-
-if [[ -n "$existing_worktree_path" ]]; then
-  write_worktree_context "$existing_worktree_path" "$branch_name"
-  refresh_active_slices_board
-cat <<EOF
-La rama ya tiene un worktree asociado.
-Alias: $(slice_alias "$ticket")
-Spec: $spec_slug
-Slice: $slice_id
-Ticket: $ticket
-Rama: $branch_name
-Base: $base_branch
-Worktree: $existing_worktree_path
-EOF
-  exit 0
-fi
-
-if [[ -e "$worktree_path" && ! -f "$worktree_path/.git" && ! -d "$worktree_path/.git" ]]; then
-  echo "Error: la ruta '$worktree_path' ya existe y no parece un worktree git." >&2
-  exit 1
-fi
-
-mkdir -p "$worktrees_root"
-
-git fetch origin --prune >/dev/null 2>&1 || true
-
-if git show-ref --verify --quiet "refs/heads/$branch_name"; then
-  git worktree add "$worktree_path" "$branch_name"
-elif git ls-remote --exit-code --heads origin "$branch_name" >/dev/null 2>&1; then
-  git fetch origin "$branch_name:$branch_name" >/dev/null 2>&1
-  git worktree add "$worktree_path" "$branch_name"
-else
-  base_ref="$(resolve_base_ref "$base_branch")"
-  git worktree add -b "$branch_name" "$worktree_path" "$base_ref"
-fi
-
-write_worktree_context "$worktree_path" "$branch_name"
-refresh_active_slices_board
-
-cat <<EOF
-Slice listo para trabajar.
-Alias: $(slice_alias "$ticket")
-Spec: $spec_slug
-Slice: $slice_id
-Ticket: $ticket
-Tipo de rama: $branch_type
-Base: $base_branch
-Slug: $branch_slug
-Rama: $branch_name
-Worktree: $worktree_path
-Contexto: $worktree_path/WORKTREE_CONTEXT.md
-EOF
+repo_root="$(git rev-parse --show-toplevel)"
+cd "$repo_root"
+exec npx create-quiver start-slice "$@"

package/specs/[project-name]/EVIDENCE_REPORT.md.template

@@ -12,4 +12,6 @@
 
 ## Evidence by Slice
 
-_No evidence recorded yet._
+- Prefer summarized command evidence over pasted long logs.
+- For each command, record: command, exit code, first relevant error or success signal, and log path if one exists.
+- Keep full logs in files or artifacts when they are too long to fit comfortably here.

package/specs/[project-name]/slices/slice-template/slice.json

@@ -8,8 +8,8 @@
   "git": {
     "branch_type": "feature",
     "base_branch": "develop",
-    "branch_slug": "[kebab-case-slug]",
-    "branch_name": "feature/ABC-123-[kebab-case-slug]"
+    "branch_slug": "slice-template",
+    "branch_name": "feature/ABC-123-slice-template"
   },
   "ui_scope": {
     "routes": [

package/specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md

@@ -0,0 +1,38 @@
+# Quiver v0.11 Evidence Report
+
+**Spec:** quiver-v11-existing-project-migration
+**Last updated:** 2026-04-22
+**Status:** Completed
+
+## Summary
+
+| Slice | Acceptance criteria | Status | Evidence |
+|-------|---------------------|--------|----------|
+| slice-01 | 6 | Completed | `node -c src/create-quiver/index.js`; `bash -n scripts/init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`; `bash scripts/ci/smoke-create-quiver.sh` |
+| slice-02 | 6 | Completed | `node -c src/create-quiver/index.js`; `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`; `bash scripts/ci/smoke-create-quiver.sh` |
+| slice-03 | 6 | Completed | `node -c src/create-quiver/index.js`; `bash -n scripts/init-docs.sh scripts/ci/smoke-init-docs.sh scripts/ci/smoke-create-quiver.sh scripts/package-quiver.sh`; `bash scripts/ci/smoke-init-docs.sh`; `bash scripts/ci/smoke-create-quiver.sh`; `bash scripts/package-quiver.sh` |
+
+## Evidence by Slice
+
+## Slice 01
+
+- Added `create-quiver migrate --dir <project>` with a non-destructive migration path for existing projects
+- `init-docs.sh` now respects `QUIVER_MIGRATE=1` and skips files that already exist
+- Generated projects now receive `tools/scripts/migrate-project.sh` and a `migrate` package script
+- Smoke coverage now verifies that migration restores missing files without overwriting existing edits
+
+## Slice 02
+
+- Added `.quiver/state.json` as project-local Quiver metadata
+- `init` and `migrate` create or refresh the state file with initialized and migrated version data
+- `analyze` updates `last_analysis_at` when metadata exists
+- `doctor` distinguishes between missing Quiver metadata and missing migration/upgrade artifacts
+- Smoke coverage now verifies the new state lifecycle across init, migrate, analyze, and doctor
+
+## Slice 03
+
+- Added an explicit `Upgrading Existing Projects` section to the root README and the generated project README
+- Documented both `npx` and project-local devDependency upgrade flows
+- Updated the generated onboarding docs so existing projects are guided to `migrate`, then `analyze`, then `doctor`
+- Extended smoke checks to assert the upgrade section and legacy migration preservation behavior
+- Confirmed `scripts/package-quiver.sh` still passes after the documentation and smoke updates

package/specs/quiver-v11-existing-project-migration/SPEC.md

@@ -0,0 +1,59 @@
+# Quiver v0.11 - Existing Project Migration
+
+**Date:** 2026-04-22
+**Status:** Completed
+
+Slice numbering resets here: this spec starts at `slice-01` and does not continue any previous spec's numbering.
+
+## Objective
+
+Make existing Quiver projects upgradeable without reinstalling or manually copying new templates, while preserving user-authored project context.
+
+## Scope
+
+### Included
+
+- Add a `create-quiver migrate --dir <project>` command for existing projects
+- Add or update Quiver project metadata so `doctor` can understand initialized, analyzed, and migrated state
+- Teach `doctor` to recommend migration when required files or version metadata are missing
+- Document the upgrade flow for users who already initialized Quiver in a project
+- Add smoke fixtures that simulate older generated projects and validate non-destructive migration
+
+### Excluded
+
+- Running AI providers from the CLI
+- Overwriting user-authored docs without preserving or reporting the change
+- Changing slice execution semantics
+- Publishing a release as part of this spec
+- Reworking global installation behavior
+
+## Target Upgrade Flow
+
+For a project that already has Quiver:
+
+```bash
+cd /path/to/project
+npm install --save-dev create-quiver@latest
+npx create-quiver migrate --dir .
+npx create-quiver analyze --dir .
+npx create-quiver doctor --dir .
+```
+
+Then the developer opens the AI agent and asks it to execute `docs/AI_ONBOARDING_PROMPT.md`.
+
+## Slices
+
+| Slice | Title | Status | Spec |
+|-------|-------|--------|------|
+| 01 | Non-Destructive Migrate Command | Completed | [slice-01](./slices/slice-01-non-destructive-migrate-command/slice.json) |
+| 02 | Version Metadata and Doctor Upgrade Checks | Completed | [slice-02](./slices/slice-02-version-metadata-doctor-upgrade-checks/slice.json) |
+| 03 | Upgrade Docs and Legacy Project Smokes | Completed | [slice-03](./slices/slice-03-upgrade-docs-legacy-project-smokes/slice.json) |
+
+## Definition of Done
+
+- Existing generated projects can receive new Quiver templates without deleting user edits
+- `migrate` reports copied, skipped, and already-present files
+- Quiver records enough metadata to distinguish initialized, analyzed, and migrated projects
+- `doctor` recommends `migrate` when upgrade artifacts are missing
+- README and generated docs explain the upgrade path for existing projects
+- Smokes cover a legacy project missing post-0.5 onboarding files

package/specs/quiver-v11-existing-project-migration/STATUS.md

@@ -0,0 +1,26 @@
+# Quiver v0.11 Spec Status
+
+**Spec:** quiver-v11-existing-project-migration
+**Last updated:** 2026-04-22
+
+Slice numbering is local to this spec. The first slice is `slice-01`.
+
+## Status
+
+| Slice | Title | Status | PR | Estimated hours | Actual hours |
+|-------|-------|--------|----|-----------------|--------------|
+| slice-01 | Non-Destructive Migrate Command | Completed | - | 5 | 5 |
+| slice-02 | Version Metadata and Doctor Upgrade Checks | Completed | - | 4 | 4 |
+| slice-03 | Upgrade Docs and Legacy Project Smokes | Completed | - | 3 | 3 |
+
+## Progress
+
+- Completed slices: 3 / 3
+- Estimated hours: 12
+- Actual hours: 12
+
+## Blockers
+
+| Slice | Blocker | Since | Action needed |
+|-------|---------|-------|---------------|
+| - | - | - | - |

package/specs/quiver-v11-existing-project-migration/slices/slice-01-non-destructive-migrate-command/slice.json

@@ -0,0 +1,73 @@
+{
+  "slice_id": "slice-01-non-destructive-migrate-command",
+  "ticket": "QUIVER-01",
+  "type": "feature",
+  "title": "Non-Destructive Migrate Command",
+  "objective": "Add `create-quiver migrate --dir <project>` so existing Quiver projects can receive missing framework artifacts without reinstalling or overwriting user-authored files.",
+  "description": "Users who initialized Quiver before newer onboarding files existed currently need to copy missing templates by hand. This slice adds a migration command that detects an existing Quiver project, copies missing files from the packaged template, preserves existing files, and reports exactly what happened.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "existing-project-migration",
+    "branch_name": "feature/QUIVER-01-existing-project-migration"
+  },
+  "must": [
+    "Add `migrate` mode to the `create-quiver` CLI with `--dir <project>` support",
+    "Detect an existing Quiver project using generated docs, specs, package scripts, or tools scripts",
+    "Copy missing generated framework files such as `docs/AI_ONBOARDING_PROMPT.md`, support docs, workflow docs, and tool scripts when absent",
+    "Never overwrite existing files without preserving or explicitly skipping them",
+    "Print a migration summary with copied, skipped, and already-present paths",
+    "Fail with a clear message when the target does not look like a Quiver-initialized project"
+  ],
+  "not_included": [
+    "Overwriting user-authored docs",
+    "Running `analyze` automatically",
+    "Executing AI prompts",
+    "Changing slice execution semantics",
+    "Publishing a package release"
+  ],
+  "acceptance": [
+    "`npx create-quiver migrate --dir .` runs in an existing Quiver project",
+    "Missing framework artifacts are copied from the packaged template",
+    "Existing user files are preserved",
+    "The command reports copied, skipped, and already-present paths",
+    "The command exits clearly when the target has no Quiver markers",
+    "Existing `init`, `analyze`, and `doctor` modes still work"
+  ],
+  "files": [
+    "src/create-quiver/index.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/package-quiver.sh",
+    "specs/quiver-v11-existing-project-migration/SPEC.md",
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md",
+    "specs/quiver-v11-existing-project-migration/slices/slice-01-non-destructive-migrate-command/slice.json"
+  ],
+  "tests": [
+    "node src/create-quiver/index.js migrate --dir <legacy-fixture>",
+    "node src/create-quiver/index.js doctor --dir <migrated-fixture>",
+    "bash scripts/ci/smoke-create-quiver.sh",
+    "bash scripts/package-quiver.sh",
+    "git diff --check"
+  ],
+  "documentation": [
+    "specs/quiver-v11-existing-project-migration/SPEC.md",
+    "specs/quiver-v11-existing-project-migration/STATUS.md",
+    "specs/quiver-v11-existing-project-migration/EVIDENCE_REPORT.md"
+  ],
+  "dependencies": [
+    "quiver-v10-local-project-installation-guidance"
+  ],
+  "assumptions": [
+    "Migration should be additive by default",
+    "The CLI should not infer business context during migration",
+    "Manual review remains required after migration"
+  ],
+  "estimated_hours": 5,
+  "actual_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-22T00:00:00Z",
+  "completed_at": "2026-04-22T00:00:00Z"
+}