create-quiver 0.9.1 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/BACKLOG.md +16 -17
  2. package/CHANGELOG.md +34 -0
  3. package/README.md +419 -330
  4. package/README_FOR_AI.md +93 -56
  5. package/ROADMAP.md +22 -11
  6. package/docs/AI_CONTEXT.md.template +2 -0
  7. package/docs/AI_ONBOARDING_PROMPT.md.template +36 -19
  8. package/docs/COMMANDS.md.template +73 -1
  9. package/docs/CONTEXTO.md.template +2 -0
  10. package/docs/DECISIONS.md.template +1 -0
  11. package/docs/GITFLOW_PR_GUIDE.md.template +11 -0
  12. package/docs/INDEX.md.template +20 -18
  13. package/docs/STANDARD.md.template +1 -1
  14. package/docs/STATUS.md.template +1 -0
  15. package/docs/SUPPORT_MATRIX.md.template +6 -2
  16. package/docs/TROUBLESHOOTING.md.template +79 -1
  17. package/docs/WORKFLOW.md.template +26 -18
  18. package/package.json +24 -2
  19. package/package.template.json +24 -7
  20. package/scripts/check-pr-readiness.sh +1 -1
  21. package/scripts/check-scope.sh +0 -1
  22. package/scripts/check-slice-readiness.sh +3 -4
  23. package/scripts/init-docs.sh +53 -6
  24. package/scripts/package-quiver.sh +18 -2
  25. package/specs/quiver-v20-ai-cli-orchestration/EVIDENCE_REPORT.md +23 -0
  26. package/specs/quiver-v20-ai-cli-orchestration/EXECUTION_PLAN.md +57 -0
  27. package/specs/quiver-v20-ai-cli-orchestration/SPEC.md +202 -0
  28. package/specs/quiver-v20-ai-cli-orchestration/STATUS.md +35 -0
  29. package/specs/quiver-v20-ai-cli-orchestration/pr.md +100 -0
  30. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-00-spec-foundation/CLOSURE_BRIEF.md +30 -0
  31. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-00-spec-foundation/EXECUTION_BRIEF.md +61 -0
  32. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-00-spec-foundation/slice.json +54 -0
  33. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-01-ai-provider-runner/CLOSURE_BRIEF.md +39 -0
  34. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-01-ai-provider-runner/EXECUTION_BRIEF.md +63 -0
  35. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-01-ai-provider-runner/slice.json +55 -0
  36. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-02-context-packs-token-budget/CLOSURE_BRIEF.md +40 -0
  37. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-02-context-packs-token-budget/EXECUTION_BRIEF.md +60 -0
  38. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-02-context-packs-token-budget/slice.json +54 -0
  39. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-03-ai-phase-gated-planner/CLOSURE_BRIEF.md +43 -0
  40. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-03-ai-phase-gated-planner/EXECUTION_BRIEF.md +62 -0
  41. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-03-ai-phase-gated-planner/slice.json +62 -0
  42. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-04-spec-slice-handoff-pr-generation/CLOSURE_BRIEF.md +36 -0
  43. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-04-spec-slice-handoff-pr-generation/EXECUTION_BRIEF.md +63 -0
  44. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-04-spec-slice-handoff-pr-generation/slice.json +59 -0
  45. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-05-execution-plan-parallel-worktrees/CLOSURE_BRIEF.md +32 -0
  46. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-05-execution-plan-parallel-worktrees/EXECUTION_BRIEF.md +61 -0
  47. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-05-execution-plan-parallel-worktrees/slice.json +59 -0
  48. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-06-ai-execute-slice-scope-enforcement/CLOSURE_BRIEF.md +36 -0
  49. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-06-ai-execute-slice-scope-enforcement/EXECUTION_BRIEF.md +64 -0
  50. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-06-ai-execute-slice-scope-enforcement/slice.json +65 -0
  51. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/CLOSURE_BRIEF.md +36 -0
  52. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/EXECUTION_BRIEF.md +66 -0
  53. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/slice.json +63 -0
  54. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/CLOSURE_BRIEF.md +35 -0
  55. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/EXECUTION_BRIEF.md +64 -0
  56. package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/slice.json +77 -0
  57. package/specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md +31 -0
  58. package/specs/quiver-v21-ai-first-layout/EXECUTION_PLAN.md +185 -0
  59. package/specs/quiver-v21-ai-first-layout/SPEC.md +212 -0
  60. package/specs/quiver-v21-ai-first-layout/STATUS.md +37 -0
  61. package/specs/quiver-v21-ai-first-layout/pr.md +110 -0
  62. package/specs/quiver-v21-ai-first-layout/slices/slice-00-spec-foundation/CLOSURE_BRIEF.md +30 -0
  63. package/specs/quiver-v21-ai-first-layout/slices/slice-00-spec-foundation/EXECUTION_BRIEF.md +63 -0
  64. package/specs/quiver-v21-ai-first-layout/slices/slice-00-spec-foundation/slice.json +45 -0
  65. package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/CLOSURE_BRIEF.md +31 -0
  66. package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/EXECUTION_BRIEF.md +59 -0
  67. package/specs/quiver-v21-ai-first-layout/slices/slice-01-init-profiles-dry-run/slice.json +57 -0
  68. package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/CLOSURE_BRIEF.md +32 -0
  69. package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/EXECUTION_BRIEF.md +60 -0
  70. package/specs/quiver-v21-ai-first-layout/slices/slice-02-internal-layout-template-resolver/slice.json +58 -0
  71. package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/CLOSURE_BRIEF.md +34 -0
  72. package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/EXECUTION_BRIEF.md +61 -0
  73. package/specs/quiver-v21-ai-first-layout/slices/slice-03-generation-profiles-visible-contract/slice.json +64 -0
  74. package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/CLOSURE_BRIEF.md +32 -0
  75. package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/EXECUTION_BRIEF.md +58 -0
  76. package/specs/quiver-v21-ai-first-layout/slices/slice-04-analyze-scan-relocation/slice.json +64 -0
  77. package/specs/quiver-v21-ai-first-layout/slices/slice-05-empty-specs-layout-doctor/CLOSURE_BRIEF.md +32 -0
  78. package/specs/quiver-v21-ai-first-layout/slices/slice-05-empty-specs-layout-doctor/EXECUTION_BRIEF.md +60 -0
  79. package/specs/quiver-v21-ai-first-layout/slices/slice-05-empty-specs-layout-doctor/slice.json +65 -0
  80. package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/CLOSURE_BRIEF.md +31 -0
  81. package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/EXECUTION_BRIEF.md +62 -0
  82. package/specs/quiver-v21-ai-first-layout/slices/slice-06-legacy-migration-optional-assets/slice.json +66 -0
  83. package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/CLOSURE_BRIEF.md +33 -0
  84. package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/EXECUTION_BRIEF.md +61 -0
  85. package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/slice.json +67 -0
  86. package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/CLOSURE_BRIEF.md +35 -0
  87. package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/EXECUTION_BRIEF.md +66 -0
  88. package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/slice.json +62 -0
  89. package/specs/quiver-v22-guided-ai-workflow/EVIDENCE_REPORT.md +58 -0
  90. package/specs/quiver-v22-guided-ai-workflow/EXECUTION_PLAN.md +88 -0
  91. package/specs/quiver-v22-guided-ai-workflow/SPEC.md +228 -0
  92. package/specs/quiver-v22-guided-ai-workflow/STATUS.md +42 -0
  93. package/specs/quiver-v22-guided-ai-workflow/pr.md +104 -0
  94. package/specs/quiver-v22-guided-ai-workflow/slices/slice-00-spec-foundation/CLOSURE_BRIEF.md +35 -0
  95. package/specs/quiver-v22-guided-ai-workflow/slices/slice-00-spec-foundation/EXECUTION_BRIEF.md +61 -0
  96. package/specs/quiver-v22-guided-ai-workflow/slices/slice-00-spec-foundation/slice.json +51 -0
  97. package/specs/quiver-v22-guided-ai-workflow/slices/slice-01-docs-source-of-truth-sync/CLOSURE_BRIEF.md +31 -0
  98. package/specs/quiver-v22-guided-ai-workflow/slices/slice-01-docs-source-of-truth-sync/EXECUTION_BRIEF.md +58 -0
  99. package/specs/quiver-v22-guided-ai-workflow/slices/slice-01-docs-source-of-truth-sync/slice.json +55 -0
  100. package/specs/quiver-v22-guided-ai-workflow/slices/slice-02-prepare-command-diagnostics/CLOSURE_BRIEF.md +30 -0
  101. package/specs/quiver-v22-guided-ai-workflow/slices/slice-02-prepare-command-diagnostics/EXECUTION_BRIEF.md +57 -0
  102. package/specs/quiver-v22-guided-ai-workflow/slices/slice-02-prepare-command-diagnostics/slice.json +57 -0
  103. package/specs/quiver-v22-guided-ai-workflow/slices/slice-03-context-doc-refresh/CLOSURE_BRIEF.md +32 -0
  104. package/specs/quiver-v22-guided-ai-workflow/slices/slice-03-context-doc-refresh/EXECUTION_BRIEF.md +56 -0
  105. package/specs/quiver-v22-guided-ai-workflow/slices/slice-03-context-doc-refresh/slice.json +56 -0
  106. package/specs/quiver-v22-guided-ai-workflow/slices/slice-04-planner-approval-state/CLOSURE_BRIEF.md +33 -0
  107. package/specs/quiver-v22-guided-ai-workflow/slices/slice-04-planner-approval-state/EXECUTION_BRIEF.md +56 -0
  108. package/specs/quiver-v22-guided-ai-workflow/slices/slice-04-planner-approval-state/slice.json +58 -0
  109. package/specs/quiver-v22-guided-ai-workflow/slices/slice-05-spec-worktree-lifecycle/CLOSURE_BRIEF.md +32 -0
  110. package/specs/quiver-v22-guided-ai-workflow/slices/slice-05-spec-worktree-lifecycle/EXECUTION_BRIEF.md +56 -0
  111. package/specs/quiver-v22-guided-ai-workflow/slices/slice-05-spec-worktree-lifecycle/slice.json +54 -0
  112. package/specs/quiver-v22-guided-ai-workflow/slices/slice-06-executor-commit-recovery/CLOSURE_BRIEF.md +32 -0
  113. package/specs/quiver-v22-guided-ai-workflow/slices/slice-06-executor-commit-recovery/EXECUTION_BRIEF.md +58 -0
  114. package/specs/quiver-v22-guided-ai-workflow/slices/slice-06-executor-commit-recovery/slice.json +57 -0
  115. package/specs/quiver-v22-guided-ai-workflow/slices/slice-07-execution-waves-delegation/CLOSURE_BRIEF.md +32 -0
  116. package/specs/quiver-v22-guided-ai-workflow/slices/slice-07-execution-waves-delegation/EXECUTION_BRIEF.md +58 -0
  117. package/specs/quiver-v22-guided-ai-workflow/slices/slice-07-execution-waves-delegation/slice.json +55 -0
  118. package/specs/quiver-v22-guided-ai-workflow/slices/slice-08-pr-create-gh-ssh/CLOSURE_BRIEF.md +32 -0
  119. package/specs/quiver-v22-guided-ai-workflow/slices/slice-08-pr-create-gh-ssh/EXECUTION_BRIEF.md +58 -0
  120. package/specs/quiver-v22-guided-ai-workflow/slices/slice-08-pr-create-gh-ssh/slice.json +53 -0
  121. package/specs/quiver-v22-guided-ai-workflow/slices/slice-09-post-merge-cleanup-release-safety/CLOSURE_BRIEF.md +33 -0
  122. package/specs/quiver-v22-guided-ai-workflow/slices/slice-09-post-merge-cleanup-release-safety/EXECUTION_BRIEF.md +59 -0
  123. package/specs/quiver-v22-guided-ai-workflow/slices/slice-09-post-merge-cleanup-release-safety/slice.json +59 -0
  124. package/specs/quiver-v22-guided-ai-workflow/slices/slice-10-docs-smokes-release-readiness/CLOSURE_BRIEF.md +34 -0
  125. package/specs/quiver-v22-guided-ai-workflow/slices/slice-10-docs-smokes-release-readiness/EXECUTION_BRIEF.md +58 -0
  126. package/specs/quiver-v22-guided-ai-workflow/slices/slice-10-docs-smokes-release-readiness/slice.json +60 -0
  127. package/specs/quiver-v23-guided-flow-productization/EVIDENCE_REPORT.md +80 -0
  128. package/specs/quiver-v23-guided-flow-productization/EXECUTION_PLAN.md +80 -0
  129. package/specs/quiver-v23-guided-flow-productization/SPEC.md +203 -0
  130. package/specs/quiver-v23-guided-flow-productization/STATUS.md +39 -0
  131. package/specs/quiver-v23-guided-flow-productization/pr.md +119 -0
  132. package/specs/quiver-v23-guided-flow-productization/slices/slice-00-spec-foundation/CLOSURE_BRIEF.md +30 -0
  133. package/specs/quiver-v23-guided-flow-productization/slices/slice-00-spec-foundation/EXECUTION_BRIEF.md +61 -0
  134. package/specs/quiver-v23-guided-flow-productization/slices/slice-00-spec-foundation/slice.json +51 -0
  135. package/specs/quiver-v23-guided-flow-productization/slices/slice-01-short-command-and-flow-entrypoint/CLOSURE_BRIEF.md +33 -0
  136. package/specs/quiver-v23-guided-flow-productization/slices/slice-01-short-command-and-flow-entrypoint/EXECUTION_BRIEF.md +35 -0
  137. package/specs/quiver-v23-guided-flow-productization/slices/slice-01-short-command-and-flow-entrypoint/slice.json +56 -0
  138. package/specs/quiver-v23-guided-flow-productization/slices/slice-02-flow-status-wizard/CLOSURE_BRIEF.md +31 -0
  139. package/specs/quiver-v23-guided-flow-productization/slices/slice-02-flow-status-wizard/EXECUTION_BRIEF.md +29 -0
  140. package/specs/quiver-v23-guided-flow-productization/slices/slice-02-flow-status-wizard/slice.json +55 -0
  141. package/specs/quiver-v23-guided-flow-productization/slices/slice-03-agent-profiles/CLOSURE_BRIEF.md +33 -0
  142. package/specs/quiver-v23-guided-flow-productization/slices/slice-03-agent-profiles/EXECUTION_BRIEF.md +29 -0
  143. package/specs/quiver-v23-guided-flow-productization/slices/slice-03-agent-profiles/slice.json +54 -0
  144. package/specs/quiver-v23-guided-flow-productization/slices/slice-04-context-preparation-onboarding/CLOSURE_BRIEF.md +32 -0
  145. package/specs/quiver-v23-guided-flow-productization/slices/slice-04-context-preparation-onboarding/EXECUTION_BRIEF.md +30 -0
  146. package/specs/quiver-v23-guided-flow-productization/slices/slice-04-context-preparation-onboarding/slice.json +59 -0
  147. package/specs/quiver-v23-guided-flow-productization/slices/slice-05-planner-iteration-history/CLOSURE_BRIEF.md +31 -0
  148. package/specs/quiver-v23-guided-flow-productization/slices/slice-05-planner-iteration-history/EXECUTION_BRIEF.md +29 -0
  149. package/specs/quiver-v23-guided-flow-productization/slices/slice-05-planner-iteration-history/slice.json +53 -0
  150. package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/CLOSURE_BRIEF.md +33 -0
  151. package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/EXECUTION_BRIEF.md +30 -0
  152. package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/slice.json +54 -0
  153. package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/CLOSURE_BRIEF.md +33 -0
  154. package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/EXECUTION_BRIEF.md +30 -0
  155. package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/slice.json +55 -0
  156. package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/CLOSURE_BRIEF.md +32 -0
  157. package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/EXECUTION_BRIEF.md +30 -0
  158. package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/slice.json +55 -0
  159. package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/CLOSURE_BRIEF.md +33 -0
  160. package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/EXECUTION_BRIEF.md +34 -0
  161. package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/slice.json +57 -0
  162. package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/CLOSURE_BRIEF.md +33 -0
  163. package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/EXECUTION_BRIEF.md +32 -0
  164. package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/slice.json +63 -0
  165. package/specs/quiver-v24-dx-onboarding-hardening/EVIDENCE_REPORT.md +55 -0
  166. package/specs/quiver-v24-dx-onboarding-hardening/EXECUTION_PLAN.md +43 -0
  167. package/specs/quiver-v24-dx-onboarding-hardening/SPEC.md +149 -0
  168. package/specs/quiver-v24-dx-onboarding-hardening/STATUS.md +31 -0
  169. package/specs/quiver-v24-dx-onboarding-hardening/pr.md +76 -0
  170. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-00-spec-foundation/CLOSURE_BRIEF.md +31 -0
  171. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-00-spec-foundation/EXECUTION_BRIEF.md +52 -0
  172. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-00-spec-foundation/slice.json +51 -0
  173. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-01-init-template-hygiene/CLOSURE_BRIEF.md +38 -0
  174. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-01-init-template-hygiene/EXECUTION_BRIEF.md +53 -0
  175. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-01-init-template-hygiene/slice.json +55 -0
  176. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-02-cli-command-routing-version-errors/CLOSURE_BRIEF.md +33 -0
  177. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-02-cli-command-routing-version-errors/EXECUTION_BRIEF.md +50 -0
  178. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-02-cli-command-routing-version-errors/slice.json +52 -0
  179. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-03-doctor-fix-doc-link-checks/CLOSURE_BRIEF.md +33 -0
  180. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-03-doctor-fix-doc-link-checks/EXECUTION_BRIEF.md +50 -0
  181. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-03-doctor-fix-doc-link-checks/slice.json +53 -0
  182. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-04-prepare-output-ai-context-drafts/CLOSURE_BRIEF.md +33 -0
  183. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-04-prepare-output-ai-context-drafts/EXECUTION_BRIEF.md +50 -0
  184. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-04-prepare-output-ai-context-drafts/slice.json +70 -0
  185. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-05-local-slice-validation-base-guidance/CLOSURE_BRIEF.md +36 -0
  186. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-05-local-slice-validation-base-guidance/EXECUTION_BRIEF.md +49 -0
  187. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-05-local-slice-validation-base-guidance/slice.json +52 -0
  188. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-06-plan-graph-next-history-views/CLOSURE_BRIEF.md +43 -0
  189. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-06-plan-graph-next-history-views/EXECUTION_BRIEF.md +53 -0
  190. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-06-plan-graph-next-history-views/slice.json +60 -0
  191. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-07-analyzer-command-map-hardening/CLOSURE_BRIEF.md +32 -0
  192. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-07-analyzer-command-map-hardening/EXECUTION_BRIEF.md +50 -0
  193. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-07-analyzer-command-map-hardening/slice.json +51 -0
  194. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-08-evidence-run-command/CLOSURE_BRIEF.md +34 -0
  195. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-08-evidence-run-command/EXECUTION_BRIEF.md +52 -0
  196. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-08-evidence-run-command/slice.json +54 -0
  197. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-09-spec-viewer-demo-scaffolding/CLOSURE_BRIEF.md +34 -0
  198. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-09-spec-viewer-demo-scaffolding/EXECUTION_BRIEF.md +51 -0
  199. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-09-spec-viewer-demo-scaffolding/slice.json +59 -0
  200. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/CLOSURE_BRIEF.md +33 -0
  201. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/EXECUTION_BRIEF.md +54 -0
  202. package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/slice.json +76 -0
  203. package/src/create-quiver/commands/ai.js +915 -0
  204. package/src/create-quiver/commands/demo.js +22 -0
  205. package/src/create-quiver/commands/evidence.js +37 -0
  206. package/src/create-quiver/commands/flow.js +561 -0
  207. package/src/create-quiver/commands/graph.js +14 -1
  208. package/src/create-quiver/commands/next.js +28 -0
  209. package/src/create-quiver/commands/plan.js +6 -3
  210. package/src/create-quiver/commands/prepare.js +236 -0
  211. package/src/create-quiver/commands/spec.js +133 -0
  212. package/src/create-quiver/index.js +1096 -96
  213. package/src/create-quiver/lib/agent-profiles.js +148 -0
  214. package/src/create-quiver/lib/ai/context-packs.js +170 -0
  215. package/src/create-quiver/lib/ai/execution-plan.js +614 -0
  216. package/src/create-quiver/lib/ai/executor.js +682 -0
  217. package/src/create-quiver/lib/ai/github.js +525 -0
  218. package/src/create-quiver/lib/ai/onboarding-template.js +365 -0
  219. package/src/create-quiver/lib/ai/phase-gates.js +72 -0
  220. package/src/create-quiver/lib/ai/plan-review.js +283 -0
  221. package/src/create-quiver/lib/ai/preflight.js +58 -0
  222. package/src/create-quiver/lib/ai/prompt-transport.js +81 -0
  223. package/src/create-quiver/lib/ai/prompts.js +39 -0
  224. package/src/create-quiver/lib/ai/providers.js +315 -0
  225. package/src/create-quiver/lib/ai/safety.js +156 -0
  226. package/src/create-quiver/lib/ai/spec-generator.js +314 -0
  227. package/src/create-quiver/lib/ai/spec-templates.js +715 -0
  228. package/src/create-quiver/lib/approvals.js +350 -0
  229. package/src/create-quiver/lib/demo.js +657 -0
  230. package/src/create-quiver/lib/doctor.js +348 -0
  231. package/src/create-quiver/lib/evidence.js +115 -0
  232. package/src/create-quiver/lib/git.js +21 -0
  233. package/src/create-quiver/lib/init-docs.js +545 -23
  234. package/src/create-quiver/lib/init-layout.js +451 -0
  235. package/src/create-quiver/lib/lifecycle.js +8 -2
  236. package/src/create-quiver/lib/package-safety.js +117 -0
  237. package/src/create-quiver/lib/paths.js +63 -2
  238. package/src/create-quiver/lib/project-scan.js +66 -0
  239. package/src/create-quiver/lib/readiness.js +87 -18
  240. package/src/create-quiver/lib/scope.js +125 -0
  241. package/src/create-quiver/lib/slice-graph.js +7 -0
  242. package/src/create-quiver/lib/slice.js +59 -16
  243. package/src/create-quiver/lib/spec-worktrees.js +349 -0
  244. package/src/create-quiver/lib/state.js +18 -1
  245. package/src/create-quiver/lib/template-resolver.js +74 -0
@@ -0,0 +1,30 @@
1
+ # EXECUTION BRIEF - slice-04: Context preparation and onboarding
2
+
3
+ ## Objetivo
4
+
5
+ Convertir el prompt largo de onboarding planificador en una plantilla mantenida por Quiver y una experiencia de preparacion de contexto.
6
+
7
+ ## Alcance
8
+
9
+ - Templates de onboarding.
10
+ - Comando de prepare/onboard.
11
+ - Reglas index-first y WDD/SDD.
12
+ - Reporte de documentos leidos, omitidos, supuestos y riesgos.
13
+
14
+ ## Criterios de aceptacion
15
+
16
+ - Prompt generado es mas corto y especifico que el prompt manual.
17
+ - No lee todo `docs/` por defecto.
18
+ - Mantiene trazabilidad documental.
19
+ - Tests pasan.
20
+
21
+ ## Restricciones
22
+
23
+ - No modificar codigo de producto durante onboarding.
24
+ - No inventar docs inexistentes.
25
+
26
+ ## Checklist de finalizacion
27
+
28
+ - [ ] Template actualizado.
29
+ - [ ] Dry-run validado.
30
+ - [ ] Tests pasan.
@@ -0,0 +1,59 @@
1
+ {
2
+ "slice_id": "slice-04-context-preparation-onboarding",
3
+ "ticket": "QUIVER-23-04",
4
+ "type": "feature",
5
+ "title": "Context preparation and onboarding prompt productization",
6
+ "objective": "Turn the long planner onboarding prompt into a maintained token-efficient Quiver flow.",
7
+ "description": "Productize context preparation so the planner reads the index first, selects relevant docs, reports assumptions, and avoids unnecessary docs.",
8
+ "git": {
9
+ "branch_type": "feature",
10
+ "base_branch": "main",
11
+ "branch_slug": "context-preparation-onboarding",
12
+ "branch_name": "feature/QUIVER-23-04-context-preparation-onboarding"
13
+ },
14
+ "files": [
15
+ "src/create-quiver/commands/prepare.js",
16
+ "src/create-quiver/commands/ai.js",
17
+ "src/create-quiver/lib/init-docs.js",
18
+ "src/create-quiver/lib/ai/**",
19
+ "docs/AI_ONBOARDING_PROMPT.md.template",
20
+ "docs/AI_CONTEXT.md.template",
21
+ "docs/INDEX.md.template",
22
+ "tests/commands/*.test.js",
23
+ "tests/lib/*.test.js"
24
+ ],
25
+ "depends_on": [
26
+ "slice-03-agent-profiles"
27
+ ],
28
+ "parallel_safe": "no",
29
+ "parallel_safe_reason": "Touches onboarding templates and AI command behavior.",
30
+ "must": [
31
+ "Keep onboarding token-efficient.",
32
+ "Start from docs/INDEX.md when present.",
33
+ "Report selected docs and why.",
34
+ "Avoid reading all docs by default.",
35
+ "Keep WDD/SDD constraints explicit.",
36
+ "Preserve no-product-code rule during onboarding."
37
+ ],
38
+ "not_included": [
39
+ "Plan review command.",
40
+ "Executor prompt generation.",
41
+ "Delegated execution."
42
+ ],
43
+ "acceptance": [
44
+ "Generated onboarding prompt includes index-first navigation.",
45
+ "Dry-run shows prompt source and context pack.",
46
+ "Missing referenced docs are reported as documentation debt.",
47
+ "Context preparation excludes secrets and noisy paths.",
48
+ "README snippets remain short."
49
+ ],
50
+ "tests": [
51
+ "node --test tests/commands/prepare.test.js tests/commands/ai-onboard.test.js tests/lib/ai-safety.test.js",
52
+ "git diff --check"
53
+ ],
54
+ "estimated_hours": 8,
55
+ "status": "completed",
56
+ "blocked_reason": null,
57
+ "actual_hours": 4,
58
+ "completed_at": "2026-05-21T14:59:09-0300"
59
+ }
@@ -0,0 +1,31 @@
1
+ # CLOSURE BRIEF - slice-05: Planner iteration history
2
+
3
+ ## Resumen de lo realizado
4
+
5
+ Se agrego historial versionado para drafts de `acceptance` y `technical-plan`, manteniendo compatibilidad con `draft.md` y `approved.md`. Ahora se puede aprobar una version concreta con `ai approve --version`.
6
+
7
+ ## Validacion contra criterios de aceptacion
8
+
9
+ - [x] Drafts versionados.
10
+ - [x] Aprobacion explicita.
11
+ - [x] Bloqueos preservados.
12
+ - [x] Tests pasan.
13
+
14
+ ## Cambios relevantes
15
+
16
+ - `src/create-quiver/lib/approvals.js`: drafts versionados, metadata de version y deteccion de stale cuando se aprueba una version anterior.
17
+ - `src/create-quiver/commands/ai.js` e `index.js`: soporte `ai approve --version <n>`.
18
+ - `tests/lib/approvals.test.js` y `tests/commands/ai-plan.test.js`: multiples drafts y aprobacion por version.
19
+ - Docs de comandos y README actualizados.
20
+
21
+ ## Pendientes
22
+
23
+ Ninguno para este slice.
24
+
25
+ ## Riesgos remanentes
26
+
27
+ Los archivos legacy `draft.md` y `approved.md` siguen existiendo como punteros/copia para compatibilidad; el historial canonico de drafts vive en `drafts/`.
28
+
29
+ ## Recomendaciones futuras
30
+
31
+ Usar el historial versionado como entrada de la revision de plan de produccion en `slice-06`.
@@ -0,0 +1,29 @@
1
+ # EXECUTION BRIEF - slice-05: Planner iteration history
2
+
3
+ ## Objetivo
4
+
5
+ Guardar versiones de criterios y planes para que el usuario pueda iterar y aprobar una version concreta.
6
+
7
+ ## Alcance
8
+
9
+ - Estado de drafts y approvals.
10
+ - Comandos de listado/status.
11
+ - Reglas de bloqueo para fases posteriores.
12
+
13
+ ## Criterios de aceptacion
14
+
15
+ - Varias iteraciones conviven.
16
+ - La aprobacion apunta a una version concreta.
17
+ - Las fases usan aprobados por defecto.
18
+ - Tests pasan.
19
+
20
+ ## Restricciones
21
+
22
+ - No crear specs sin plan aprobado.
23
+ - No borrar historial sin comando explicito.
24
+
25
+ ## Checklist de finalizacion
26
+
27
+ - [ ] Historial persistido.
28
+ - [ ] Estado mostrado.
29
+ - [ ] Tests pasan.
@@ -0,0 +1,53 @@
1
+ {
2
+ "slice_id": "slice-05-planner-iteration-history",
3
+ "ticket": "QUIVER-23-05",
4
+ "type": "feature",
5
+ "title": "Planner iteration history for criteria and plans",
6
+ "objective": "Make acceptance criteria and technical-plan iterations explicit, versioned, and approvable.",
7
+ "description": "Persist drafts, revisions, approved versions, and status for criteria and technical plans.",
8
+ "git": {
9
+ "branch_type": "feature",
10
+ "base_branch": "main",
11
+ "branch_slug": "planner-iteration-history",
12
+ "branch_name": "feature/QUIVER-23-05-planner-iteration-history"
13
+ },
14
+ "files": [
15
+ "src/create-quiver/commands/ai.js",
16
+ "src/create-quiver/lib/approvals.js",
17
+ "src/create-quiver/lib/**",
18
+ "docs/COMMANDS.md.template",
19
+ "tests/lib/approvals.test.js",
20
+ "tests/commands/ai-plan.test.js"
21
+ ],
22
+ "depends_on": [
23
+ "slice-04-context-preparation-onboarding"
24
+ ],
25
+ "parallel_safe": "no",
26
+ "parallel_safe_reason": "Extends planner approval state consumed by later slices.",
27
+ "must": [
28
+ "Store multiple criteria drafts.",
29
+ "Store multiple technical plan drafts.",
30
+ "Show draft history and approved version.",
31
+ "Approve a selected version explicitly.",
32
+ "Block later phases on missing approval."
33
+ ],
34
+ "not_included": [
35
+ "Production plan review.",
36
+ "Spec generation changes beyond using approved versions."
37
+ ],
38
+ "acceptance": [
39
+ "Multiple drafts can exist without overwriting approved artifacts.",
40
+ "Status output shows draft, approved, stale, and missing states.",
41
+ "Technical plan uses approved criteria by default.",
42
+ "Spec generation blocks without approved plan."
43
+ ],
44
+ "tests": [
45
+ "node --test tests/lib/approvals.test.js tests/commands/ai-plan.test.js",
46
+ "git diff --check"
47
+ ],
48
+ "estimated_hours": 7,
49
+ "status": "completed",
50
+ "blocked_reason": null,
51
+ "actual_hours": 4,
52
+ "completed_at": "2026-05-21T15:03:43-0300"
53
+ }
@@ -0,0 +1,33 @@
1
+ # CLOSURE BRIEF - slice-06: Production plan review
2
+
3
+ ## Resumen de lo realizado
4
+
5
+ Se agrego la fase `ai review-plan` para revisar el draft del plan tecnico antes de aprobarlo y antes de generar specs. El review usa el perfil `reviewer`, imprime metadata en dry-run, persiste el resultado en `.quiver/approvals/plan-review/` y bloquea la generacion de spec si el plan tecnico no esta revisado y aprobado.
6
+
7
+ ## Validacion contra criterios de aceptacion
8
+
9
+ - [x] Review generado.
10
+ - [x] Review persistido.
11
+ - [x] Bloqueos aplicados.
12
+ - [x] Tests pasan.
13
+
14
+ ## Cambios relevantes
15
+
16
+ - Nuevo modulo `src/create-quiver/lib/ai/plan-review.js`.
17
+ - Nuevo subcomando `npx create-quiver ai review-plan`.
18
+ - `flow` ahora guia al usuario a revisar el plan tecnico antes de aprobarlo.
19
+ - `ai approvals` muestra el estado `plan-review`.
20
+ - La generacion de spec exige plan tecnico revisado y aprobado.
21
+ - README, templates, generated docs y smokes quedaron alineados con el nuevo paso.
22
+
23
+ ## Pendientes
24
+
25
+ - La UX futura podria simplificar `--version <n>` para el plan tecnico revisado, pero no bloquea este slice.
26
+
27
+ ## Riesgos remanentes
28
+
29
+ - El comando usa CLIs locales de proveedores; en automatizacion se debe seguir usando `--dry-run` o mocks para evitar llamadas pagas.
30
+
31
+ ## Recomendaciones futuras
32
+
33
+ - En `slice-07`, hacer que la experiencia de creacion de spec explique claramente que la entrada valida es el plan tecnico revisado y aprobado.
@@ -0,0 +1,30 @@
1
+ # EXECUTION BRIEF - slice-06: Production plan review
2
+
3
+ ## Objetivo
4
+
5
+ Formalizar el prompt de revision del plan como una fase antes de crear specs.
6
+
7
+ ## Alcance
8
+
9
+ - Nuevo comando o fase de review.
10
+ - Prompt mantenido por Quiver.
11
+ - Persistencia de resultado.
12
+ - Bloqueo opcional/obligatorio para spec creation.
13
+
14
+ ## Criterios de aceptacion
15
+
16
+ - Detecta supuestos fragiles, huecos, ambiguedades y riesgos.
17
+ - No cuestiona el alcance aprobado.
18
+ - No modifica codigo.
19
+ - Tests pasan.
20
+
21
+ ## Restricciones
22
+
23
+ - No implementar fixes.
24
+ - No abrir nuevas preguntas si la ambiguedad no bloquea; documentar supuestos.
25
+
26
+ ## Checklist de finalizacion
27
+
28
+ - [ ] Review command probado.
29
+ - [ ] Estado persistido.
30
+ - [ ] Tests pasan.
@@ -0,0 +1,54 @@
1
+ {
2
+ "slice_id": "slice-06-production-plan-review",
3
+ "ticket": "QUIVER-23-06",
4
+ "type": "feature",
5
+ "title": "Production-readiness plan review phase",
6
+ "objective": "Add a review phase that checks the technical plan for fragile assumptions, missing cases, and ambiguity before spec creation.",
7
+ "description": "Productize the user's plan-review prompt as a Quiver command and persisted review artifact.",
8
+ "git": {
9
+ "branch_type": "feature",
10
+ "base_branch": "main",
11
+ "branch_slug": "production-plan-review",
12
+ "branch_name": "feature/QUIVER-23-06-production-plan-review"
13
+ },
14
+ "files": [
15
+ "src/create-quiver/commands/ai.js",
16
+ "src/create-quiver/lib/ai/**",
17
+ "src/create-quiver/lib/**",
18
+ "docs/COMMANDS.md.template",
19
+ "tests/commands/*.test.js",
20
+ "tests/lib/*.test.js"
21
+ ],
22
+ "depends_on": [
23
+ "slice-05-planner-iteration-history"
24
+ ],
25
+ "parallel_safe": "no",
26
+ "parallel_safe_reason": "Adds a new planner gate consumed by spec generation.",
27
+ "must": [
28
+ "Review technical-plan drafts before plan approval and spec generation.",
29
+ "Report fragile assumptions, uncovered cases, ambiguous criteria, risks, and recommended fixes.",
30
+ "Do not question approved scope.",
31
+ "Persist the review result.",
32
+ "Block spec creation if required review is missing when configured as mandatory."
33
+ ],
34
+ "not_included": [
35
+ "Implementing the plan.",
36
+ "Creating specs directly.",
37
+ "Changing provider API integration."
38
+ ],
39
+ "acceptance": [
40
+ "Dry-run prints review prompt metadata.",
41
+ "Review output is stored as a draft/review artifact.",
42
+ "The command never modifies product code.",
43
+ "Spec generation requires reviewed and approved plan state.",
44
+ "Tests cover missing plan, dry-run, provider failure, and persisted review."
45
+ ],
46
+ "tests": [
47
+ "node --test tests/commands/ai-plan*.test.js tests/lib/approvals.test.js",
48
+ "git diff --check"
49
+ ],
50
+ "estimated_hours": 8,
51
+ "status": "completed",
52
+ "completed_at": "2026-05-21",
53
+ "blocked_reason": null
54
+ }
@@ -0,0 +1,33 @@
1
+ # CLOSURE BRIEF - slice-07: Spec create experience
2
+
3
+ ## Resumen de lo realizado
4
+
5
+ Se agrego `npx create-quiver spec create` como paso explicito para crear specs reales desde el plan tecnico revisado y aprobado. El comando soporta `--dry-run`, valida colisiones antes de escribir, crea todos los artefactos esperados y muestra los proximos comandos seguros.
6
+
7
+ ## Validacion contra criterios de aceptacion
8
+
9
+ - [x] Inputs aprobados/revisados usados.
10
+ - [x] Artefactos generados.
11
+ - [x] `slice-00` generado.
12
+ - [x] Tests pasan.
13
+
14
+ ## Cambios relevantes
15
+
16
+ - Nuevo modulo `src/create-quiver/commands/spec.js`.
17
+ - Nuevo subcomando `spec create`.
18
+ - Nuevo script `quiver:spec:create` en paquetes generados.
19
+ - `flow` ahora recomienda `spec create --dry-run` cuando el plan esta revisado y aprobado.
20
+ - README, templates y docs generadas usan `spec create` como flujo principal.
21
+ - Tests agregados en `tests/commands/spec-create.test.js`.
22
+
23
+ ## Pendientes
24
+
25
+ - `ai plan --phase spec` sigue existiendo por compatibilidad; en la documentacion principal queda desplazado por `spec create`.
26
+
27
+ ## Riesgos remanentes
28
+
29
+ - La UX todavia requiere que el usuario conozca o revise el numero de version aprobado del plan tecnico.
30
+
31
+ ## Recomendaciones futuras
32
+
33
+ - En `slice-08`, usar el spec generado por `spec create` como fuente para prompts minimos de executor.
@@ -0,0 +1,30 @@
1
+ # EXECUTION BRIEF - slice-07: Spec create experience
2
+
3
+ ## Objetivo
4
+
5
+ Hacer que la creacion de specs sea un paso claro despues de plan revisado y aprobado.
6
+
7
+ ## Alcance
8
+
9
+ - UX del comando.
10
+ - Validaciones de inputs aprobados.
11
+ - Generacion de artefactos.
12
+ - Proximo paso sugerido.
13
+
14
+ ## Criterios de aceptacion
15
+
16
+ - Bloquea si falta aprobacion/review.
17
+ - Crea todos los artefactos esperados.
18
+ - `slice-00` es obligatorio.
19
+ - Tests pasan.
20
+
21
+ ## Restricciones
22
+
23
+ - No ejecutar slices.
24
+ - No abrir PR.
25
+
26
+ ## Checklist de finalizacion
27
+
28
+ - [ ] Spec generation validado.
29
+ - [ ] JSON validado.
30
+ - [ ] Tests pasan.
@@ -0,0 +1,55 @@
1
+ {
2
+ "slice_id": "slice-07-spec-create-experience",
3
+ "ticket": "QUIVER-23-07",
4
+ "type": "feature",
5
+ "title": "Spec creation experience from approved plans",
6
+ "objective": "Make spec generation feel like an explicit product step after reviewed approved plans.",
7
+ "description": "Add a higher-level spec create command or wrapper that consumes approved/reviewed inputs and creates spec artifacts predictably.",
8
+ "git": {
9
+ "branch_type": "feature",
10
+ "base_branch": "main",
11
+ "branch_slug": "spec-create-experience",
12
+ "branch_name": "feature/QUIVER-23-07-spec-create-experience"
13
+ },
14
+ "files": [
15
+ "src/create-quiver/commands/ai.js",
16
+ "src/create-quiver/commands/spec.js",
17
+ "src/create-quiver/lib/ai/spec-generator.js",
18
+ "src/create-quiver/lib/ai/spec-templates.js",
19
+ "docs/WORKFLOW.md.template",
20
+ "tests/commands/*.test.js",
21
+ "tests/lib/*.test.js"
22
+ ],
23
+ "depends_on": [
24
+ "slice-06-production-plan-review"
25
+ ],
26
+ "parallel_safe": "no",
27
+ "parallel_safe_reason": "Touches spec generation and command routing.",
28
+ "must": [
29
+ "Consume approved and reviewed plan input by default.",
30
+ "Generate `SPEC.md`, `STATUS.md`, `EVIDENCE_REPORT.md`, `EXECUTION_PLAN.md`, `pr.md`, `slice-00`, and slice handoffs.",
31
+ "Fail safely if target spec exists.",
32
+ "Keep `slice-00` mandatory.",
33
+ "Print next commands after generation."
34
+ ],
35
+ "not_included": [
36
+ "Executing slices.",
37
+ "Opening PRs.",
38
+ "Delegating agents."
39
+ ],
40
+ "acceptance": [
41
+ "Spec creation blocks on missing approved/reviewed plan.",
42
+ "Generated spec includes mandatory slice-00.",
43
+ "Generated `pr.md` exists.",
44
+ "Generated JSON parses.",
45
+ "Next safe commands are printed."
46
+ ],
47
+ "tests": [
48
+ "node --test tests/commands/spec-create.test.js tests/commands/ai-plan-spec-phase.test.js tests/lib/ai-spec-generator.test.js",
49
+ "git diff --check"
50
+ ],
51
+ "estimated_hours": 7,
52
+ "status": "completed",
53
+ "completed_at": "2026-05-21",
54
+ "blocked_reason": null
55
+ }
@@ -0,0 +1,32 @@
1
+ # CLOSURE BRIEF - slice-08: Executor prompt generation
2
+
3
+ ## Resumen de lo realizado
4
+
5
+ Se agrego `npx create-quiver ai prompt-slice` como comando de salida manual para asignar un slice a un agente executor con contexto minimo. El prompt se arma desde `slice.json`, `EXECUTION_BRIEF.md`, `CLOSURE_BRIEF.md` y un extracto breve de `SPEC.md`, sin incluir el spec completo por defecto.
6
+
7
+ ## Validacion contra criterios de aceptacion
8
+
9
+ - [x] Prompt minimo.
10
+ - [x] Sin SPEC completo por defecto.
11
+ - [x] Formato final incluido.
12
+ - [x] Tests pasan.
13
+
14
+ ## Cambios relevantes
15
+
16
+ - Nuevo builder `buildManualExecutorPrompt` en `src/create-quiver/lib/ai/executor.js`.
17
+ - Nuevo subcomando `ai prompt-slice`, con alias `ai executor-prompt`.
18
+ - Nuevo script generado `quiver:ai:prompt-slice`.
19
+ - README, `README_FOR_AI.md`, templates y docs generadas actualizadas con el flujo manual.
20
+ - Tests de CLI y libreria para contexto minimo, path del slice y faltantes de briefs.
21
+
22
+ ## Pendientes
23
+
24
+ Sin pendientes del slice.
25
+
26
+ ## Riesgos remanentes
27
+
28
+ El prompt manual no ejecuta ni valida al proveedor; la calidad final sigue dependiendo del agente executor elegido por el usuario.
29
+
30
+ ## Recomendaciones futuras
31
+
32
+ En `slice-09`, reutilizar este prompt como base de contexto para ejecucion delegada y mantener la salida manual como fallback de bajo riesgo.
@@ -0,0 +1,30 @@
1
+ # EXECUTION BRIEF - slice-08: Executor prompt generation
2
+
3
+ ## Objetivo
4
+
5
+ Generar prompts minimos para agentes ejecutores a partir de artefactos de un slice.
6
+
7
+ ## Alcance
8
+
9
+ - Leer `slice.json`, `EXECUTION_BRIEF.md`, `CLOSURE_BRIEF.md`.
10
+ - Incluir contexto minimo y restricciones.
11
+ - Imprimir prompt listo para pegar.
12
+
13
+ ## Criterios de aceptacion
14
+
15
+ - No incluye el SPEC completo por defecto.
16
+ - Incluye archivos permitidos, criterios y validaciones.
17
+ - Tiene formato de reporte final.
18
+ - Tests pasan.
19
+
20
+ ## Restricciones
21
+
22
+ - No ejecutar provider.
23
+ - No ejecutar el prompt generado contra proveedores dentro de este slice.
24
+ - Mantener la implementacion dentro de los archivos declarados en `slice.json`.
25
+
26
+ ## Checklist de finalizacion
27
+
28
+ - [x] Prompt generado.
29
+ - [x] Contexto minimizado.
30
+ - [x] Tests pasan.
@@ -0,0 +1,55 @@
1
+ {
2
+ "slice_id": "slice-08-executor-prompt-generation",
3
+ "ticket": "QUIVER-23-08",
4
+ "type": "feature",
5
+ "title": "Executor prompt generation for manual slice assignment",
6
+ "objective": "Generate minimal executor prompts from slice artifacts so users can assign slices without pasting long custom prompts.",
7
+ "description": "Productize the user's executor prompt as a generated, slice-specific prompt with minimal context and strict output contract.",
8
+ "git": {
9
+ "branch_type": "feature",
10
+ "base_branch": "main",
11
+ "branch_slug": "executor-prompt-generation",
12
+ "branch_name": "feature/QUIVER-23-08-executor-prompt-generation"
13
+ },
14
+ "files": [
15
+ "src/create-quiver/commands/ai.js",
16
+ "src/create-quiver/lib/ai/executor.js",
17
+ "src/create-quiver/lib/**",
18
+ "docs/AI_ONBOARDING_PROMPT.md.template",
19
+ "docs/COMMANDS.md.template",
20
+ "tests/commands/*.test.js",
21
+ "tests/lib/*.test.js"
22
+ ],
23
+ "depends_on": [
24
+ "slice-07-spec-create-experience"
25
+ ],
26
+ "parallel_safe": "no",
27
+ "parallel_safe_reason": "Depends on final generated slice artifact shape.",
28
+ "must": [
29
+ "Generate a prompt for one slice from `slice.json`, `EXECUTION_BRIEF.md`, and `CLOSURE_BRIEF.md`.",
30
+ "Include minimal SPEC excerpts only when needed.",
31
+ "Include allowed files, restrictions, acceptance criteria, validation commands, and output format.",
32
+ "Support dry-run output to console.",
33
+ "Avoid exposing secrets or full repo context."
34
+ ],
35
+ "not_included": [
36
+ "Executing the provider.",
37
+ "Delegating multiple slices.",
38
+ "Opening PRs."
39
+ ],
40
+ "acceptance": [
41
+ "Prompt generation works for a valid slice path.",
42
+ "Missing brief files fail clearly.",
43
+ "Output does not include full SPEC by default.",
44
+ "Prompt includes final report format.",
45
+ "Tests cover minimal context and path handling."
46
+ ],
47
+ "tests": [
48
+ "node --test tests/commands/ai-execute-slice.test.js tests/lib/ai-executor.test.js",
49
+ "git diff --check"
50
+ ],
51
+ "estimated_hours": 6,
52
+ "status": "completed",
53
+ "completed_at": "2026-05-21",
54
+ "blocked_reason": null
55
+ }
@@ -0,0 +1,33 @@
1
+ # CLOSURE BRIEF - slice-09: Delegated slice execution
2
+
3
+ ## Resumen de lo realizado
4
+
5
+ Se agrego ejecucion por modo para `ai execute-plan`: `auto` conserva la compatibilidad secuencial, `manual` imprime comandos `prompt-slice` sin ejecutar proveedores y `delegated` usa worktrees temporales para olas paralelas con scopes seguros. Las olas con conflictos o scope desconocido siguen cayendo a ejecucion secuencial.
6
+
7
+ ## Validacion contra criterios de aceptacion
8
+
9
+ - [x] Modo manual/delegado.
10
+ - [x] Paralelo seguro.
11
+ - [x] Un commit por slice.
12
+ - [x] Tests pasan.
13
+
14
+ ## Cambios relevantes
15
+
16
+ - Nuevo flag `--mode <auto|manual|delegated>` para `ai execute-plan`.
17
+ - Dry-run muestra comandos `ai prompt-slice` y, salvo en modo manual, comandos `ai execute-slice`.
18
+ - Modo delegado crea worktrees temporales para grupos paralelos, ejecuta cada slice con `commit: true` e integra los commits con `cherry-pick` en orden estable.
19
+ - Fallback secuencial cuando hay conflictos, scope desconocido o un solo slice.
20
+ - Tests agregados para modo manual, modo delegado con worktrees temporales e integracion de commits.
21
+ - README, `README_FOR_AI.md`, templates y docs generadas actualizadas con los modos.
22
+
23
+ ## Pendientes
24
+
25
+ Sin pendientes del slice.
26
+
27
+ ## Riesgos remanentes
28
+
29
+ Si falla un provider o un `cherry-pick`, Quiver deja los worktrees temporales para inspeccion y no intenta ocultar cambios. La recuperacion queda en manos del usuario para evitar borrar evidencia util.
30
+
31
+ ## Recomendaciones futuras
32
+
33
+ En `slice-10`, cubrir el flujo completo con smokes finales y revisar que la documentacion principal no duplique rutas equivalentes.
@@ -0,0 +1,34 @@
1
+ # EXECUTION BRIEF - slice-09: Delegated slice execution
2
+
3
+ ## Objetivo
4
+
5
+ Permitir ejecucion delegada de slices con seguridad de scopes, workspaces y commits.
6
+
7
+ ## Alcance
8
+
9
+ - Modo manual y delegado.
10
+ - Uso de perfil executor.
11
+ - Workspaces seguros para paralelismo.
12
+ - Un commit por slice.
13
+ - Reportes de fallo recuperables.
14
+
15
+ ## Criterios de aceptacion
16
+
17
+ - Dry-run muestra olas.
18
+ - Ejecucion real requiere flags explicitos.
19
+ - Paralelo solo con scopes seguros.
20
+ - Falla sin ocultar cambios.
21
+ - Tests pasan.
22
+
23
+ ## Restricciones
24
+
25
+ - No mergear PR.
26
+ - No instalar proveedores.
27
+ - No correr providers reales en CI.
28
+
29
+ ## Checklist de finalizacion
30
+
31
+ - [x] Dry-run validado.
32
+ - [x] Ejecucion con mocks validada.
33
+ - [x] Fallos recuperables.
34
+ - [x] Tests pasan.