create-yss-spec 3.3.0 → 3.3.1

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 (197) hide show
  1. package/package.json +3 -2
  2. package/src/command-runner.mjs +107 -0
  3. package/src/self-update.js +7 -4
  4. package/src/template/instance-runtime.js +1 -1
  5. package/template/.agents/skills/.strategic-design-skills-manifest.json +2 -2
  6. package/template/.agents/skills/competitive-intelligence/SKILL.md +4 -4
  7. package/template/.agents/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  8. package/template/.agents/skills/grill-with-docs/SKILL.md +1 -1
  9. package/template/.agents/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  10. package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  11. package/template/.agents/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  12. package/template/.agents/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  13. package/template/.agents/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  14. package/template/.agents/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  15. package/template/.agents/skills/yss-product-lifecycle/SKILL.md +7 -4
  16. package/template/.agents/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  17. package/template/.agents/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  18. package/template/.agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  19. package/template/.agents/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  20. package/template/.agents/skills/yss-research/SKILL.md +1 -1
  21. package/template/.agents/skills/yss-stage-decision/SKILL.md +5 -3
  22. package/template/.agents/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  23. package/template/.claude/skills/competitive-intelligence/SKILL.md +4 -4
  24. package/template/.claude/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  25. package/template/.claude/skills/grill-with-docs/SKILL.md +1 -1
  26. package/template/.claude/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  27. package/template/.claude/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  28. package/template/.claude/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  29. package/template/.claude/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  30. package/template/.claude/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  31. package/template/.claude/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  32. package/template/.claude/skills/yss-product-lifecycle/SKILL.md +7 -4
  33. package/template/.claude/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  34. package/template/.claude/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  35. package/template/.claude/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  36. package/template/.claude/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  37. package/template/.claude/skills/yss-research/SKILL.md +1 -1
  38. package/template/.claude/skills/yss-stage-decision/SKILL.md +5 -3
  39. package/template/.claude/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  40. package/template/.codex/skills/competitive-intelligence/SKILL.md +4 -4
  41. package/template/.codex/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  42. package/template/.codex/skills/grill-with-docs/SKILL.md +1 -1
  43. package/template/.codex/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  44. package/template/.codex/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  45. package/template/.codex/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  46. package/template/.codex/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  47. package/template/.codex/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  48. package/template/.codex/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  49. package/template/.codex/skills/yss-product-lifecycle/SKILL.md +7 -4
  50. package/template/.codex/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  51. package/template/.codex/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  52. package/template/.codex/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  53. package/template/.codex/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  54. package/template/.codex/skills/yss-research/SKILL.md +1 -1
  55. package/template/.codex/skills/yss-stage-decision/SKILL.md +5 -3
  56. package/template/.codex/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  57. package/template/.cursor/skills/competitive-intelligence/SKILL.md +4 -4
  58. package/template/.cursor/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  59. package/template/.cursor/skills/grill-with-docs/SKILL.md +1 -1
  60. package/template/.cursor/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  61. package/template/.cursor/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  62. package/template/.cursor/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  63. package/template/.cursor/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  64. package/template/.cursor/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  65. package/template/.cursor/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  66. package/template/.cursor/skills/yss-product-lifecycle/SKILL.md +7 -4
  67. package/template/.cursor/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  68. package/template/.cursor/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  69. package/template/.cursor/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  70. package/template/.cursor/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  71. package/template/.cursor/skills/yss-research/SKILL.md +1 -1
  72. package/template/.cursor/skills/yss-stage-decision/SKILL.md +5 -3
  73. package/template/.cursor/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  74. package/template/.pi/skills/competitive-intelligence/SKILL.md +4 -4
  75. package/template/.pi/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  76. package/template/.pi/skills/grill-with-docs/SKILL.md +1 -1
  77. package/template/.pi/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  78. package/template/.pi/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  79. package/template/.pi/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  80. package/template/.pi/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  81. package/template/.pi/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  82. package/template/.pi/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  83. package/template/.pi/skills/yss-product-lifecycle/SKILL.md +7 -4
  84. package/template/.pi/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  85. package/template/.pi/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  86. package/template/.pi/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  87. package/template/.pi/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  88. package/template/.pi/skills/yss-research/SKILL.md +1 -1
  89. package/template/.pi/skills/yss-stage-decision/SKILL.md +5 -3
  90. package/template/.pi/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  91. package/template/.qoder/skills/competitive-intelligence/SKILL.md +4 -4
  92. package/template/.qoder/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  93. package/template/.qoder/skills/grill-with-docs/SKILL.md +1 -1
  94. package/template/.qoder/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  95. package/template/.qoder/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  96. package/template/.qoder/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  97. package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  98. package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  99. package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  100. package/template/.qoder/skills/yss-product-lifecycle/SKILL.md +7 -4
  101. package/template/.qoder/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  102. package/template/.qoder/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  103. package/template/.qoder/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  104. package/template/.qoder/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  105. package/template/.qoder/skills/yss-research/SKILL.md +1 -1
  106. package/template/.qoder/skills/yss-stage-decision/SKILL.md +5 -3
  107. package/template/.qoder/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  108. package/template/.trae/skills/competitive-intelligence/SKILL.md +4 -4
  109. package/template/.trae/skills/domain-modeling/CONTEXT-FORMAT.md +1 -1
  110. package/template/.trae/skills/grill-with-docs/SKILL.md +1 -1
  111. package/template/.trae/skills/setup-matt-pocock-skills/issue-tracker-local.md +1 -1
  112. package/template/.trae/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs +7 -7
  113. package/template/.trae/skills/yss-frontend-scaffold-generator/SKILL.md +1 -1
  114. package/template/.trae/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs +22 -8
  115. package/template/.trae/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs +5 -6
  116. package/template/.trae/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs +19 -1
  117. package/template/.trae/skills/yss-product-lifecycle/SKILL.md +7 -4
  118. package/template/.trae/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
  119. package/template/.trae/skills/yss-product-lifecycle/references/matt-yss-adapter.md +3 -3
  120. package/template/.trae/skills/yss-product-lifecycle/references/orchestration-contract.yaml +57 -6
  121. package/template/.trae/skills/yss-product-lifecycle/references/orchestration.md +11 -1
  122. package/template/.trae/skills/yss-research/SKILL.md +1 -1
  123. package/template/.trae/skills/yss-stage-decision/SKILL.md +5 -3
  124. package/template/.trae/skills/yss-stage-decision/references/stage-decision-package-contract.md +1 -1
  125. package/template/AGENTS.md +2 -2
  126. package/template/CONTEXT.md +3 -2
  127. package/template/README.md +3 -3
  128. package/template/docs/agents/digital-human-roles.md +1 -1
  129. package/template/docs/agents/digital-human-roles.yaml +11 -11
  130. package/template/docs/agents/issue-tracker.md +1 -1
  131. package/template/docs/agents/strategic-design-skills-integration.md +2 -0
  132. package/template/docs/architecture/README.md +1 -1
  133. package/template/docs/architecture/templates/business-architecture-template.md +1 -1
  134. package/template/docs/architecture/templates/functional-architecture-template.md +1 -1
  135. package/template/docs/design/README.md +1 -1
  136. package/template/docs/design/templates/interaction-spec-template.md +1 -1
  137. package/template/docs/design/templates/product-overview-design-template.md +1 -1
  138. package/template/docs/{discovery → plan}/IDEATION.md +5 -5
  139. package/template/docs/plan/README.md +9 -0
  140. package/template/docs/plan/entry-review.md +23 -0
  141. package/template/docs/plan/templates/plan-template.md +58 -0
  142. package/template/docs/process/harness-process-tailoring.md +1 -1
  143. package/template/docs/process/lifecycle-artifact-map.md +6 -6
  144. package/template/docs/process/lifecycle-registry-baseline.json +5 -1
  145. package/template/docs/process/lifecycle-registry.yaml +25 -20
  146. package/template/docs/process/plan-migration.md +13 -0
  147. package/template/docs/process/schemas/digital-human-task-package.schema.json +2 -0
  148. package/template/docs/process/schemas/lifecycle-checkpoint.schema.json +3 -0
  149. package/template/docs/process/schemas/lifecycle-registry.schema.json +1 -1
  150. package/template/docs/process/template-engineering-overview.md +2 -2
  151. package/template/docs/process/template-verification-profiles.yaml +2 -0
  152. package/template/docs/process/templates/context-reconciliation-template.yaml +2 -2
  153. package/template/docs/process/templates/lifecycle-checkpoint-template.yaml +1 -1
  154. package/template/docs/requirements/README.md +2 -2
  155. package/template/docs/templates/local-parent-ticket-template.md +1 -1
  156. package/template/docs/templates/subagent-task-package-template.md +1 -1
  157. package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214.md +1 -1
  158. package/template/scripts/cache-template-commit +2 -2
  159. package/template/scripts/fixtures/strategic-handoff/source-roles.json +7 -7
  160. package/template/scripts/fixtures/user-decision/plan-fixture.mjs +30 -0
  161. package/template/scripts/lib/backend-delivery.mjs +5 -2
  162. package/template/scripts/lib/command-runner.mjs +107 -0
  163. package/template/scripts/lib/context-reconciliation.mjs +34 -0
  164. package/template/scripts/lib/json-schema.mjs +42 -13
  165. package/template/scripts/lib/lifecycle-context-query.mjs +7 -3
  166. package/template/scripts/lib/lifecycle-transition.mjs +9 -3
  167. package/template/scripts/lib/plan-spec-entry.mjs +87 -0
  168. package/template/scripts/lib/scenario-checks.mjs +15 -12
  169. package/template/scripts/lib/skill-supply-chain.mjs +18 -2
  170. package/template/scripts/lib/strategic-handoff-io.mjs +5 -4
  171. package/template/scripts/lib/strategic-handoff.mjs +10 -9
  172. package/template/scripts/lib/task-package.mjs +2 -0
  173. package/template/scripts/lib/template-commit-cache.mjs +7 -5
  174. package/template/scripts/run-template-verification +9 -3
  175. package/template/scripts/sync-strategic-handoff-tools +9 -0
  176. package/template/scripts/verify-context-reconciliation +2 -48
  177. package/template/scripts/verify-context-reconciliation-scenarios +1 -1
  178. package/template/scripts/verify-lifecycle-checkpoint +2 -0
  179. package/template/scripts/verify-lifecycle-context-query-scenarios +28 -8
  180. package/template/scripts/verify-plan-spec-entry +11 -0
  181. package/template/scripts/verify-plan-spec-entry-scenarios +79 -0
  182. package/template/scripts/verify-script-performance-scenarios +56 -0
  183. package/template/scripts/verify-subagent-task-package-scenarios +9 -8
  184. package/template/scripts/verify-template-cache-scenarios +11 -1
  185. package/template/scripts/verify-user-decision-scenarios +4 -4
  186. package/template/skills-lock.json +17 -17
  187. package/template.manifest.json +2 -1
  188. package/template.snapshot.json +5 -5
  189. package/template/docs/discovery/README.md +0 -87
  190. package/template/docs/discovery/reports/.gitkeep +0 -0
  191. package/template/docs/discovery/reports/agent-governance-options.md +0 -71
  192. package/template/docs/discovery/reports/competitor-deep-dive/.gitkeep +0 -0
  193. package/template/docs/discovery/templates/discovery-template.md +0 -94
  194. /package/template/docs/{discovery → plan}/templates/competitive-analysis-template.md +0 -0
  195. /package/template/docs/{discovery → plan}/templates/competitive-matrix-template.md +0 -0
  196. /package/template/docs/{discovery → plan}/templates/market-analysis-template.md +0 -0
  197. /package/template/docs/{discovery → plan}/templates/user-pain-points-template.md +0 -0
@@ -48,6 +48,34 @@ modes:
48
48
  orchestrate: bounded_write
49
49
  resume: rebuild_then_bounded_write
50
50
 
51
+ execution_efficiency:
52
+ context_query:
53
+ strategy: combine-mode-stage-work-unit-and-required-includes
54
+ read_scope: current-work-unit-and-triggered-impacts
55
+ reuse: already-read-unchanged-sources-within-current-task
56
+ refresh_on: [source-changed, new-impact, evidence-conflict, resume, handoff]
57
+ verification:
58
+ scope: current-artifacts-and-triggered-contracts
59
+ timing: after-artifact-write-before-approval-or-transition
60
+ duplicate_check: reuse-only-within-same-boundary-and-unchanged-inputs
61
+ unchanged_inputs: [artifact-bytes, upstream-bytes, validator-and-schema, command-and-options, repository-root]
62
+ freshness_unknown: rerun
63
+ always_revalidate_on: [resume, handoff, implementation-entry, merge, release]
64
+ template_regression_suite: template-maintenance-or-explicit-regression-task
65
+ per_work_unit_context_reconciliation: required
66
+ skip_triggered_gates: forbidden
67
+ interaction:
68
+ questions: batch-independent-current-stage-questions
69
+ user_decision_policy_ref: docs/agents/digital-human-roles.yaml#user_decision_policy
70
+ decision_evidence_ref: references/user-decisions.md
71
+ dependent_future_approvals: forbidden
72
+ checkpoint_policy_ref: checkpoint_policy
73
+ timing_evidence:
74
+ location: existing-checkpoint-verification-evidence
75
+ script_fields: [command, duration_ms, exit_code]
76
+ distinguish: [script-execution, agent-orchestration, human-wait]
77
+ unmeasured_duration: unknown
78
+
51
79
  # 有效的 YSS 仓库必须先由生命周期编排器接管入口;Matt flow 只负责选择工作方式。
52
80
  entry_routing:
53
81
  manifest: yss-project.yaml
@@ -210,7 +238,7 @@ lifecycle_native_entries:
210
238
  implement: lifecycle-validate-and-accept
211
239
 
212
240
  work_unit_routes:
213
- work-unit.discovery-opportunity:
241
+ work-unit.plan-opportunity:
214
242
  native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
215
243
  primary_skill: yss-product-lifecycle
216
244
  supporting_skills: [competitive-intelligence, yss-research]
@@ -218,7 +246,7 @@ work_unit_routes:
218
246
  route_by: {market_or_competitor_fact: competitive-intelligence, technical_or_standard_fact: yss-research:technical-evidence, strategy_fact: yss-research:strategy-evidence, no_external_fact: yss-product-lifecycle}
219
247
  applies_when: opportunity_or_external_fact_requires_validation
220
248
  not_applicable_reason: no_external_fact
221
- work-unit.discovery-requirements:
249
+ work-unit.plan-requirements:
222
250
  native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
223
251
  primary_skill: yss-product-lifecycle
224
252
  supporting_skills: [grilling, domain-modeling]
@@ -241,7 +269,7 @@ work_unit_routes:
241
269
  skills: [yss-stage-decision, domain-modeling, yss-research]
242
270
  research_contract: {profile: strategy-evidence, mode_before_gate: evidence-audited, artifact_owner: yss-research, downstream_owner: yss-stage-decision}
243
271
  human_gate: stage-decision-package-approved
244
- applies_when: discovery_to_spec_requires_stable_decision_package
272
+ applies_when: plan_to_spec_requires_stable_decision_package
245
273
  not_applicable_reason: existing_approved_stage_decision_current
246
274
  work-unit.spec-synthesis:
247
275
  native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
@@ -484,6 +512,10 @@ transition_graph:
484
512
  work-unit.intensity-aware-verification: [work-unit.intensity-aware-review]
485
513
  work-unit.intensity-aware-review: [work-unit.release-and-rollback]
486
514
  work-unit.release-and-rollback: []
515
+ work-unit.plan-opportunity: [work-unit.plan-requirements, work-unit.domain-strategy-design, work-unit.stage-decision, work-unit.spec-synthesis]
516
+ work-unit.plan-requirements: [work-unit.domain-strategy-design, work-unit.stage-decision, work-unit.spec-synthesis]
517
+ work-unit.domain-strategy-design: [work-unit.stage-decision, work-unit.spec-synthesis]
518
+ work-unit.stage-decision: [work-unit.spec-synthesis]
487
519
  work-unit.spec-synthesis: [work-unit.prototype-design, work-unit.technical-analysis, work-unit.implementation-repository-preparation]
488
520
  work-unit.prototype-design: [work-unit.technical-analysis, work-unit.implementation-repository-preparation]
489
521
  work-unit.technical-analysis: [work-unit.implementation-repository-preparation]
@@ -495,6 +527,25 @@ transition_graph:
495
527
  - {from: work-unit.technical-analysis, to: work-unit.slice-implementation}
496
528
  - {from: work-unit.technical-analysis, to: work-unit.ticket-decomposition}
497
529
 
530
+ planning:
531
+ entry_validator: scripts/verify-plan-spec-entry
532
+ review_contract: docs/plan/entry-review.md
533
+ check_policy: docs/process/lifecycle-registry.yaml
534
+ default_check_status: pending
535
+ formal_spec_draft_requires_passed_entry: true
536
+ stage: stage.plan
537
+ record: artifact.plan-record
538
+ template: docs/plan/templates/plan-template.md
539
+ exit_policy: docs/process/lifecycle-registry.yaml
540
+ migration_policy: docs/process/plan-migration.md
541
+ critical_open_questions: block-before-spec
542
+ deferred_details_require: [noncritical_reason, owner, resolution_point, downstream_recipient]
543
+ reuse_requires: [source_ref, current_version, applicable_scope, reason]
544
+ downstream: work-unit.spec-synthesis
545
+ implementation_authorized: false
546
+ frontier_scope: current-plan-decisions
547
+ deferred_details: excluded-from-frontier-only-after-user-confirms-deferral
548
+
498
549
  grill_exit:
499
550
  required: [frontier_empty, facts_resolved_or_routed, decisions_confirmed, shared_understanding_confirmed, no_unresolved_runnable_blocker]
500
551
  facts_resolved_or_routed:
@@ -502,7 +553,7 @@ grill_exit:
502
553
  runnable_question: handoff-prototype-handoff
503
554
  external_decision: external-input-required
504
555
  user_confirmation_required: true
505
- output: discovery-evidence
556
+ output: plan-evidence
506
557
 
507
558
  ticket_role_transition:
508
559
  yss_active:
@@ -761,7 +812,7 @@ tracker:
761
812
  local_markdown:
762
813
  root: docs/.scratch
763
814
  legacy_roots: [.scratch, docs/requirements/tickets]
764
- feature_layout: [map.md, discovery, spec.md, spec-delta, parent-ticket.md, design, api, architecture, gates, verification, issues]
815
+ feature_layout: [map.md, plan, spec.md, spec-delta, parent-ticket.md, design, api, architecture, gates, verification, issues]
765
816
  primary_sync: local
766
817
  remote_ticket_required: false
767
818
  remote_mirror: optional
@@ -817,7 +868,7 @@ wayfinder_mode:
817
868
  - multi-session-or-multi-agent-work
818
869
  - unclear-decision-frontier
819
870
  - cross-domain-dependency-map-needed
820
- lifecycle_position: discovery-to-spec-planning
871
+ lifecycle_position: plan-to-spec-planning
821
872
  completion_route: wayfinder -> handoff -> to-spec
822
873
  does_not_replace: [lifecycle-gates, spec-baseline, ticket-formalization]
823
874
  forbidden_state_mutations: [ready-for-agent, gate-approval, ticket-role]
@@ -13,6 +13,16 @@
13
13
 
14
14
  连续阶段自动推进时累积 Ticket 同步和 Git 判断证据,在人工暂停、handoff、进入实现、合并或发布边界集中 checkpoint。发生阻塞、责任人变化或资产需要单独批准时立即落 checkpoint,不因合并记录而丢失阶段因果关系。
15
15
 
16
+ ## 执行成本
17
+
18
+ 执行策略以 `orchestration-contract.yaml.execution_efficiency` 为准,通过同一次 `query-lifecycle-context` 查询取得。Plan → Spec → Ticket 的耗时应分清脚本执行、Agent 读取与编排、人工等待;没有计时记录时不把总时长归因于摘要计算。
19
+
20
+ 同一工作单元把 mode、stage、work-unit 和必要 include 放进一次查询。查询已给出的内容不再整份读取;已读资料在当前任务内未变化时复用,变化、新影响或恢复时重新加载。只问当前阶段尚缺且会影响判断的问题,独立问题可合并;依赖尚未形成资产的后续批准仍按用户决定协议逐边界取得。
21
+
22
+ 资产写入稳定后、批准或流转前执行当前合同要求的验证。同一边界内,只有输入字节、上游、验证器/schema、参数和仓库根均已确认未变化且实际结果可读时,才引用已执行结果;不确定就重跑。每个工作单元仍生成并校验自己的 context reconciliation;恢复、交接、实现、合并和发布边界重新执行适用验证。`verify-*-scenarios` 与模板全量核验用于模板维护或明确的回归任务,不因产品阶段切换而重复执行;实例合同显式要求的检查仍须执行。
23
+
24
+ 脚本命令、实际退出码和 duration_ms 记入已有 checkpoint 的验证证据;Agent 编排和人工等待仅在有计时来源时记录,否则标为 unknown。无需为耗时再建一套阶段产物。
25
+
16
26
  ## 阶段边界
17
27
 
18
28
  Matt phase boundary 是工作阶段之间的上下文决策,不是新的生命周期状态。按以下顺序判断,第一项适用即停止判断:
@@ -59,7 +69,7 @@ tracker 选择和冲突按 `docs/agents/issue-tracker.md` 裁决:已持久化
59
69
 
60
70
  - `work-unit.technical-analysis` 由 `yss-technical-design` 组织后端技术设计,先按项目确认架构,再调用 DDD `yss-tactical-design` 或传统 MVC `yss-mvc-design`。状态、规则、一致性、持久化影响本身不意味着选择 DDD。无后端技术设计影响记录带原因的 `not-applicable`,其他 API / 前端技术分析继续各自路由。新合同使用 `artifact.technical-design`,通过 `evidence.technical-design-review` 回交现有架构审查;旧 DDD 稳定 ID 只读兼容。批准仍由生命周期维护,编译器消费批准且当前的设计起草实现合同;`stale`、`drift` 或 `new_impacts` 时不得继续 Ticket 正式化。
61
71
 
62
- - `work-unit.discovery-requirements` 实际调用 `grilling` 和 `domain-modeling`;`work-unit.discovery-opportunity` 按事实类型路由 `competitive-intelligence` 或 `yss-research`。`yss-research:quick` 只用于探索;外部证据进入领域战略、阶段决策或其他生命周期批准输入前必须升级为 `evidence-audited`。生命周期原生工作单元默认负责 Spec、Ticket 和实现资产;`to-spec`、`to-tickets`、`implement` 仅保留为显式兼容入口,结果必须回交生命周期验收。
72
+ - `work-unit.plan-requirements` 实际调用 `grilling` 和 `domain-modeling`;`work-unit.plan-opportunity` 按事实类型路由 `competitive-intelligence` 或 `yss-research`。`yss-research:quick` 只用于探索;外部证据进入领域战略、阶段决策或其他生命周期批准输入前必须升级为 `evidence-audited`。生命周期原生工作单元默认负责 Spec、Ticket 和实现资产;`to-spec`、`to-tickets`、`implement` 仅保留为显式兼容入口,结果必须回交生命周期验收。
63
73
  - 原生 `work-unit.ticket-decomposition` 只能在 OpenAPI Freeze 或无 API 影响记录后创建垂直切片,初始 Ticket 状态统一为 `ready-for-human`;生命周期复算完整公式后才能提升 `ready-for-agent`。该工作单元必须返回 `ticket_decomposition_result_ref` 和垂直切片引用,并作为实现的必经前置证据。
64
74
  - 原生 `work-unit.slice-implementation` 必须在生命周期批准并持久化 Slice Implementation Contract 和 Build Architecture Checklist 后执行;用户显式 `implement` 仍走兼容入口,不得绕过生命周期。
65
75
  - `Workflow Execution Result.next_route` 必须通过生命周期转换校验;Spec、原型和技术分析不得直接跳转到 Ticket 正式化或实现,必须先完成 `work-unit.implementation-repository-preparation`,再进入 `work-unit.ticket-decomposition`。
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: yss-research
3
- description: Research technical or product-strategy questions with traceable evidence before YSS Discovery, Spec, domain-strategy, API, architecture, or implementation decisions. Use for current facts, standards, third-party APIs, business constraints, user problems, domain-boundary evidence, or when the deprecated `research` alias is invoked.
3
+ description: Research technical or product-strategy questions with traceable evidence before YSS Plan, Spec, domain-strategy, API, architecture, or implementation decisions. Use for current facts, standards, third-party APIs, business constraints, user problems, domain-boundary evidence, or when the deprecated `research` alias is invoked.
4
4
  ---
5
5
 
6
6
  # YSS Research
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: yss-stage-decision
3
- description: 编排 Discovery 到 Spec 入口的方案决策与业务边界、协作和规则设计;当需求、业务责任区、统一业务词汇或下游影响尚未稳定时使用。
3
+ description: 编排 Plan 到 Spec 入口的方案决策与业务边界、协作和规则设计;当需求、业务责任区、统一业务词汇或下游影响尚未稳定时使用。
4
4
  ---
5
5
 
6
6
  # YSS Stage Decision
@@ -9,14 +9,16 @@ description: 编排 Discovery 到 Spec 入口的方案决策与业务边界、
9
9
 
10
10
  ## 适用边界
11
11
 
12
- - 适用于 `project-instance` 的 Discovery → Spec 入口。
12
+ - 适用于 `project-instance` 的 Plan → Spec 入口。
13
13
  - `template-source` 只维护本技能、Schema、验证器和合成 Fixture,不生成具体产品领域资产。
14
14
  - 业务边界与协作工作单元只回答:有哪些业务板块、每个业务责任区负责什么、不同责任区如何交接、使用哪些统一业务词汇、发生哪些业务事实、有哪些待确认的关键业务对象和不可违反的业务规则。
15
15
  - Entity、Aggregate、Repository、Java 类、数据库表和 OpenAPI Freeze 留给下游工作单元。
16
16
 
17
17
  ## 执行顺序
18
18
 
19
- 1. 读取 `yss-project.yaml`、`CONTEXT.md`、既有 Discovery/Spec、ADR 和父 Ticket/checkpoint。
19
+ Plan 的目标与退出条件由 `docs/process/lifecycle-registry.yaml` 持有;从 `docs/plan/templates/plan-template.md` 汇总输入。旧资产按 `docs/process/plan-migration.md` 重新整理并核查,关键未决项不得延期到 Spec,非关键项记录责任人、解决时点与接收方。
20
+
21
+ 1. 读取 `yss-project.yaml`、`CONTEXT.md`、既有 Plan/Spec、ADR 和父 Ticket/checkpoint。
20
22
  2. 分离事实、决策、假设、约束和未决项;技术事实走 `yss-research` 的 `technical-evidence`,领域边界、业务规则、MVP、非目标、成功标准或阶段推进依据等决策证据走 `strategy-evidence`,市场/竞品事实走 `competitive-intelligence`。
21
23
  3. 从业务故事、已发生的事实、规则、责任人和失败路径识别业务板块与业务责任区,不从数据库表或调用链直接反推边界。
22
24
  4. 为每个业务责任区建立统一业务词汇;对跨责任区协作记录规则提供方、规则使用方、业务决策权、信息传递方向和口径转换负责人。
@@ -1,6 +1,6 @@
1
1
  # 方案决策包合同
2
2
 
3
- 内部对象 `stage_decision_package` 是 Discovery、需求/产品/商务决策与业务边界和规则设计之间的冻结入口。它记录“做什么、为什么做、范围是什么、哪些仍未决”,不复制业务边界与规则事实。
3
+ 内部对象 `stage_decision_package` 是 Plan、需求/产品/商务决策与业务边界和规则设计之间的冻结入口。它记录“做什么、为什么做、范围是什么、哪些仍未决”,不复制业务边界与规则事实。
4
4
 
5
5
  ## 必须包含
6
6
 
@@ -38,11 +38,11 @@
38
38
 
39
39
  ## 5. `project-instance` 产品研发路由
40
40
 
41
- 主流程:分诊 → Discovery → Spec / 功能架构 → 产品设计 → 工程契约 → Ticket → 切片 → 验证 / 发布 / 复盘。
41
+ 主流程:分诊 → Plan → Spec / 功能架构 → 产品设计 → 工程契约 → Ticket → 切片 → 验证 / 发布 / 复盘。
42
42
 
43
43
  - 先按 `docs/process/harness-process-tailoring.md` 判定影响面和最近可信阶段,再由 `yss-product-lifecycle` 执行 `docs/process/lifecycle-registry.yaml`;阅读导航见 `docs/process/lifecycle-artifact-map.md`。
44
44
  - 命中门禁必须完成;仅未命中时记录带原因的 `not-applicable`,不得生成空文档或混淆门禁、产物、工作单元、证据。安全 / 权限写入普通 Spec、契约、架构、验收和 seam,按实际影响触发门禁。
45
- - 新功能和较大变更先进入 Discovery;`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅为用户显式兼容入口。API 变更先形成 OpenAPI 3.1 Draft,审查后 Freeze,再实现。
45
+ - 新功能和较大变更先进入 Plan;`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅为用户显式兼容入口。API 变更先形成 OpenAPI 3.1 Draft,审查后 Freeze,再实现。
46
46
  - Spec Delta 只记冻结基线的高风险行为差异。OpenAPI Freeze 或无 API 影响记录后拆窄垂直切片,禁止仅按技术层横拆。
47
47
  - `seam-deferred` 必须记录风险、责任人、后续 Ticket、验证计划和目标版本或发布日期。
48
48
 
@@ -15,6 +15,7 @@ context_schema_version: 1
15
15
 
16
16
  | 术语 | 含义 | 英文标识 | 避免 / 备注 |
17
17
  |---|---|---|---|
18
+ | Plan(战略规划) | 确认目标、业务边界、关键规则、MVP / 非目标、优先级和交接责任,为 Spec 提供已确认的战略输入。 | — | 问题探索是其中按需开展的活动;不等同于 AI-DLC 官方阶段名、交付排期或实现合同的 Context Plan。旧阶段 ID 已弃用,不提供兼容解析。 |
18
19
  | Agent | 执行特定工作流步骤的 AI 协作者。 | — | 不要与生物人审查者、数字人角色或 Ticket 状态混用。运行时实例(Cursor Agent、Claude Code、Grok Bot 等)是 Agent 的承载,不是角色本身。 |
19
20
  | 运行时绑定 | 把数字人角色落到某个 Agent 平台的适配声明,权威清单在数字人角色注册表的 `runtimes`。 | — | 不要为每个平台复制一套职称职责。 |
20
21
  | Grok Bot | Grok 平台上的持久数字队友实例;对应 `runtime.grok`。 | — | 不是数字人角色、技能或门禁。 |
@@ -26,9 +27,9 @@ context_schema_version: 1
26
27
  | 运行时副作用审批 | 对发消息、改生产、付款、删数据等工具动作的账号级确认。 | — | 点 Allow 不等于门禁已批准或可发布。避免只称「Grok 平台审批」。 |
27
28
  | Ticket 状态 | Tracker 五态:`needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human`、`wontfix`。 | — | 不要称为数字人角色或「标准角色」。 |
28
29
  | 阶段协作组 | 某阶段需要共同可见会签的逻辑成员集合。 | — | 不是某个产品的群聊;平台人数上限只写在对应 `runtimes`。 |
29
- | 需求经理 | 主责 Discovery 语言、用户/MVP/非目标、Spec 正文与测试 seam 的数字人角色。 | — | 不拥有原型视觉定稿,不 Freeze API,不写实现。 |
30
+ | 需求经理 | 主责 Plan 语言、用户/MVP/非目标、Spec 正文与测试 seam 的数字人角色。 | — | 不拥有原型视觉定稿,不 Freeze API,不写实现。 |
30
31
  | 产品经理 | 主责优先级、产品设计影响、原型确认建议、范围裁剪以及商业约束、交付承诺、发布窗口和商业非目标的数字人角色。 | — | 不写生产代码,不单独 Freeze API;对外商务合同和正式承诺须由生物人批准。 |
31
- | 商业约束 | Discovery 与发布阶段需要确认的商业边界、交付承诺、发布窗口和商业非目标。 | — | 由产品经理负责数字人侧的整理与协调;不等同于独立的“商务”数字人角色。 |
32
+ | 商业约束 | Plan 与发布阶段需要确认的商业边界、交付承诺、发布窗口和商业非目标。 | — | 由产品经理负责数字人侧的整理与协调;不等同于独立的“商务”数字人角色。 |
32
33
  | Agent 入口规则 | Agent 启动任务时必须先遵守的全局路由、硬门禁和禁止事项。 | — | 不作为 YSS 后端、前端或其他专项编码规范的完整手册。 |
33
34
  | 标准文档语言 | 面向业务、产品、架构、实施、审查、发布和复盘的持久化文档所使用的默认语言。 | — | 统一使用简体中文;英文专有名词、代码标识、API 路径、schema、文件名和协议 metadata 保持原样。 |
34
35
  | Matt Engineering Skills | 来自 `mattpocock/skills` 的轻量工程流程技能集合。 | — | 用于澄清、Spec、Ticket、实现、TDD、诊断、审查和架构治理,不替代 YSS 专项规范。 |
@@ -23,7 +23,7 @@
23
23
  │ ├── api/ ← OpenAPI 3.1 契约
24
24
  │ ├── adr/ ← 架构决策记录
25
25
  │ ├── requirements/ ← Spec / 用户故事 / 需求草案 / 垂直切片
26
- │ ├── discovery/ ← 机会探索、市场、竞品和用户材料
26
+ │ ├── plan/ ← 战略规划与 Spec 上游输入
27
27
  │ ├── design/ ← 产品设计、原型、交互说明和状态矩阵
28
28
  │ ├── architecture/ ← 架构设计与审查模板
29
29
  │ ├── releases/ ← 发布说明
@@ -42,7 +42,7 @@
42
42
  1. 先读取 `yss-project.yaml`,按 `repository_mode` 选择模板维护或产品研发生命周期。
43
43
  2. 必读入口为 `AGENTS.md` 与 `CONTEXT.md`;流程事实分别以生命周期映射和裁剪指南为准。
44
44
  3. `template-source` 修改后先按 `maintenance-intensity.yaml` 判定 L1 / L2 / L3,默认用 `scripts/verify-template-fast` 达到 `implementation-ready`;L3 日常采用维护者自检,正式发布前执行完整门禁;只有共享 skill 变更才运行 `scripts/sync-skills` 和 `scripts/update-skill-lock`。
45
- 4. `project-instance` 默认从 `yss-product-lifecycle` 的 `route` 模式开始,再由原生 `work-unit.*` 推进 Discovery、Spec、产品设计、工程契约和 Ticket 正式化;`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅作为用户显式调用的兼容入口。
45
+ 4. `project-instance` 默认从 `yss-product-lifecycle` 的 `route` 模式开始,再由原生 `work-unit.*` 推进 Plan、Spec、产品设计、工程契约和 Ticket 正式化;`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅作为用户显式调用的兼容入口。
46
46
  5. 实现仓库接入、YSS 路由、独立审查、fresh verification 和 Git checkpoint 以 `AGENTS.md` 的硬门禁为准。
47
47
 
48
48
  YSS skills 的公开发布投影维护在 [iloveZzz/yss-spec-dev-skills](https://github.com/iloveZzz/yss-spec-dev-skills),发布清单和导出命令见 [skills 维护说明](./docs/agents/skills-maintenance.md)。
@@ -115,7 +115,7 @@ scripts/verify-template-fast
115
115
  | [docs/agents/README.md](./docs/agents/README.md) | Agent 协作文档目录说明 |
116
116
  | [docs/agents/skills-maintenance.md](./docs/agents/skills-maintenance.md) | Agent skills 安装与维护 |
117
117
  | [docs/user-guide/yss-ui-mcp.md](./docs/user-guide/yss-ui-mcp.md) | YSS UI MCP 项目配置、全局安装边界与自检 |
118
- | [docs/discovery/IDEATION.md](./docs/discovery/IDEATION.md) | 机会构想方法 |
118
+ | [docs/plan/IDEATION.md](./docs/plan/IDEATION.md) | 机会构想方法 |
119
119
  | [docs/architecture/README.md](./docs/architecture/README.md) | 架构设计 + 审查清单 |
120
120
  | [docs/testing/README.md](./docs/testing/README.md) | 测试策略 |
121
121
 
@@ -12,7 +12,7 @@
12
12
  |---|---|---|
13
13
  | 数字人角色 | 职称配置(需求经理、产品经理、前端工程师…) | Ticket 五态、某个平台的 Bot |
14
14
  | 主控数字人 | 生命周期编排器的运行时实例 | 第八个业务职称 |
15
- | 职能工作单元 | Discovery / Spec / Code / Review | 职称 |
15
+ | 职能工作单元 | Plan / Spec / Code / Review | 职称 |
16
16
  | 执行态 | Explorer / Drafter / Worker / Reviewer / Verifier | 数字人角色 |
17
17
  | 运行时绑定 | 如何在 Cursor / Claude / Grok 等落地 | 角色职责本身 |
18
18
 
@@ -67,7 +67,7 @@ orchestrator:
67
67
  kind: orchestrator
68
68
  title: YSS 生命周期主控
69
69
  default_dual_hat: [role.project-manager]
70
- stages: [stage.entry-triage, stage.discovery, stage.spec-architecture, stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective]
70
+ stages: [stage.entry-triage, stage.plan, stage.spec-architecture, stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective]
71
71
  core_skills: [yss-product-lifecycle, yss-implementation-contract-compiler]
72
72
  forbidden_skills: [yss-domain, yss-ui, yss-ui-business-page-generation, yss-web-controller, yss-repository, implement]
73
73
  description: >-
@@ -84,12 +84,12 @@ roles:
84
84
  kind: digital-human
85
85
  contract_version: 1
86
86
  title: YSS 需求经理
87
- stages: [stage.discovery, stage.spec-architecture]
88
- draft_artifact_ids: [artifact.discovery-record, artifact.spec]
87
+ stages: [stage.plan, stage.spec-architecture]
88
+ draft_artifact_ids: [artifact.plan-record, artifact.spec]
89
89
  core_skills: [grilling, domain-modeling, yss-research, competitive-intelligence, grill-with-docs]
90
90
  forbidden_skills: [yss-ui, yss-domain, yss-web-controller, yss-repository, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, yss-frontend-scaffold-generator, implement, tdd]
91
91
  description: >-
92
- Own Discovery language, users, MVP, non-goals, success criteria, test
92
+ Own Plan language, users, MVP, non-goals, success criteria, test
93
93
  seams, and Spec prose. Propose CONTEXT.md glossary entries. Do not freeze
94
94
  visual prototypes, OpenAPI, or code. Do not guess unconfirmed business
95
95
  rules. Hand off to the orchestrator when the frontier is empty.
@@ -99,14 +99,14 @@ roles:
99
99
  kind: digital-human
100
100
  contract_version: 1
101
101
  title: YSS 产品经理
102
- stages: [stage.discovery, stage.spec-architecture, stage.product-design, stage.verification-release-retrospective]
102
+ stages: [stage.plan, stage.spec-architecture, stage.product-design, stage.verification-release-retrospective]
103
103
  draft_artifact_ids: [artifact.product-overview, artifact.functional-architecture, artifact.interaction-spec, artifact.state-matrix, artifact.prototype-confirmation]
104
104
  core_skills: [yss-design-system, yss-prototype-stage, prototype-review, yss-antdv-next-design, yss-research, competitive-intelligence]
105
105
  forbidden_skills: [yss-ui, yss-domain, yss-repository, yss-web-controller, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, implement, tdd]
106
106
  description: >-
107
107
  Own priority, product-design impact, interaction, state matrix, prototype
108
108
  confirmation recommendation, and the commercial constraints, delivery
109
- commitments, release window, and commercial non-goals for Discovery and
109
+ commitments, release window, and commercial non-goals for Plan and
110
110
  release. May reject Spec scope. Do not write production code or freeze
111
111
  OpenAPI alone. Do not independently approve external commercial contracts
112
112
  or formal commitments; those require biological-human approval. Frontend
@@ -119,7 +119,7 @@ roles:
119
119
  kind: digital-human
120
120
  contract_version: 1
121
121
  title: YSS 项目经理
122
- stages: [stage.entry-triage, stage.discovery, stage.spec-architecture, stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective]
122
+ stages: [stage.entry-triage, stage.plan, stage.spec-architecture, stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective]
123
123
  draft_artifact_ids: [artifact.parent-ticket, artifact.vertical-slice-ticket]
124
124
  core_skills: [yss-product-lifecycle, handoff, implementation-repo-onboarding, cross-repo-implementation-routing]
125
125
  forbidden_skills: [yss-domain, yss-ui, implement, tdd, yss-web-controller]
@@ -180,9 +180,9 @@ roles:
180
180
  feature implementation. Must be a different instance from the implementer.
181
181
 
182
182
  stage_groups:
183
- - id: group.discovery
184
- name: Discovery
185
- stage: stage.discovery
183
+ - id: group.plan
184
+ name: Plan
185
+ stage: stage.plan
186
186
  members: [role.lifecycle-orchestrator, role.requirements-manager, role.product-manager]
187
187
  - id: group.spec
188
188
  name: Spec
@@ -274,7 +274,7 @@ user_decision_policy:
274
274
  - gate.architecture-reviewed
275
275
  - gate.release-ready
276
276
  work_units:
277
- work-unit.discovery-requirements: discovery-conclusion
277
+ work-unit.plan-requirements: plan-conclusion
278
278
  work-unit.service-project-initialization: scaffold-choice
279
279
  work-unit.implementation-repository-preparation: scaffold-choice
280
280
  work-unit.slice-implementation: implementation-scope
@@ -41,7 +41,7 @@ Local 主 tracker 的完整功能包结构如下:
41
41
  ```text
42
42
  docs/.scratch/<feature>/
43
43
  ├── map.md
44
- ├── discovery/
44
+ ├── plan/
45
45
  ├── spec.md
46
46
  ├── spec-delta/
47
47
  ├── parent-ticket.md
@@ -11,6 +11,8 @@
11
11
 
12
12
  父模板通过 `.agents/skills/.strategic-design-skills-manifest.json` 固定上游 Git revision、路径和 tree hash。公共 ID 不因 profile 改名;共享规则先在战略设计源仓演进,再由父模板同步。
13
13
 
14
+ 本轮 Plan 调整的 `yss-stage-decision` hash 对应战略设计子仓 commit `3a358684c5684ada433dca4fd97ee187050ca6d8`;父模板的 `source_revision` 与 gitlink 已同步。实施记录见 `.template-source/evidence/maintenance/2026-09-09-plan/`。
15
+
14
16
  ## 父模板薄适配
15
17
 
16
18
  父模板承载完整产品研发生命周期,只允许在以下位置保留最小语境差异:
@@ -10,7 +10,7 @@
10
10
 
11
11
  | 产物 | 产出阶段 | 重点问题 | 建议文件 |
12
12
  |------|----------|----------|----------|
13
- | 业务架构 | 机会探索 / Discovery / 产品定义 | 用户是谁、价值流是什么、产品在业务生态中的边界在哪里 | `<feature>-business-architecture.md` |
13
+ | 业务架构 | 机会探索 / Plan / 产品定义 | 用户是谁、价值流是什么、产品在业务生态中的边界在哪里 | `<feature>-business-architecture.md` |
14
14
  | 产品总体设计 / 功能架构 | Spec 初稿之后、页面 / 原型 / 交互设计之前 | 用户主流程、业务对象、功能域、模块边界、页面/API/数据影响、优先级、依赖和 MVP 非目标范围是什么 | `<feature>-product-overview-design.md` 或 `<feature>-functional-architecture.md` |
15
15
  | 系统概要设计 / 系统总体架构 | 工程基线 / 系统 / 数据架构设计 | 服务/模块如何构建、部署、集成、运维、回滚和演进 | `<feature>-system-overview-design.md`、`<feature>-system-architecture.md` 或 `<feature>-architecture.md` |
16
16
  | 数据架构 | 详细设计 / 持久化开发前 | 概念/逻辑/物理模型、元模型、版本、血缘、查询、索引和存储策略是什么 | `<feature>-data-architecture.md` |
@@ -14,7 +14,7 @@ owner: ai
14
14
 
15
15
  | 资产 | 路径 / 链接 | 状态 | 备注 |
16
16
  |------|-------------|------|------|
17
- | Discovery | | | |
17
+ | Plan | | | |
18
18
  | 竞品 / 市场分析 | | | |
19
19
  | CONTEXT 术语 | | | |
20
20
  | 现有业务流程 | | | |
@@ -16,7 +16,7 @@ owner: ai
16
16
  |------|-------------|------|------|
17
17
  | Spec 初稿 | | | |
18
18
  | 业务架构 | | | |
19
- | Discovery | | | |
19
+ | Plan | | | |
20
20
  | CONTEXT 术语 | | | |
21
21
 
22
22
  ## 2. 功能目标与边界
@@ -63,5 +63,5 @@ Token 或组件视觉变体变更必须先修改 `DESIGN.md`,再更新派生
63
63
  docs/.scratch/<feature>/design/diagrams/
64
64
  docs/.scratch/<feature>/design/prototypes/
65
65
  docs/.scratch/<feature>/architecture/diagrams/
66
- docs/.scratch/<feature>/discovery/diagrams/
66
+ docs/.scratch/<feature>/plan/diagrams/
67
67
  ```
@@ -9,7 +9,7 @@
9
9
  | Spec 初稿 | `docs/.scratch/<feature>/spec.md` | 原型评审后需要回填和校准 |
10
10
  | 产品总体设计 / 功能架构 | `docs/.scratch/<feature>/design/<feature>-product-overview-design.md` | 必需;缺失时先返回产品总体设计阶段 |
11
11
  | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
12
- | Discovery | `docs/.scratch/<feature>/discovery/<feature>-discovery.md` | 可选 |
12
+ | Plan | `docs/.scratch/<feature>/plan/<feature>-discovery.md` | 可选 |
13
13
  | 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需;记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
14
14
  | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
15
15
  | 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 低保真评审后按 H1/H2 档位补齐;H2 AntD 条件取事实;真实组件待验事项交接到前端实现计划,产出后必须获得用户确认 |
@@ -14,7 +14,7 @@ owner: ai
14
14
 
15
15
  | 资产 | 路径 / 链接 | 状态 | 备注 |
16
16
  |------|-------------|------|------|
17
- | Discovery / 竞品分析 | | | |
17
+ | Plan / 竞品分析 | | | |
18
18
  | 业务架构 | | | |
19
19
  | Spec 初稿 | | | |
20
20
  | CONTEXT 术语 | | | |
@@ -1,6 +1,6 @@
1
1
  # 机会构想 (Ideation) — 发现与需求之间的假设生成
2
2
 
3
- > **Phase:生成可验证假设,再用 Discovery 事实校准。AI 是发散、挑战和组合机会的加速器。**
3
+ > **Plan 内部方法:生成可验证假设,再用 事实核查 事实校准。AI 是发散、挑战和组合机会的加速器。**
4
4
 
5
5
  ---
6
6
 
@@ -11,7 +11,7 @@ Ideation 不等同于 Matt skills `需求澄清`:
11
11
  | 项 | 定位 | 输出 |
12
12
  |---|---|---|
13
13
  | Ideation Agent | 产品机会探索角色,回答“可能做什么、是否值得探索” | 候选机会、假设、挑战点、组合方案 |
14
- | Discovery Agent | 事实验证角色,回答“证据支持什么、用户真实痛点是什么” | 市场、竞品、用户洞察、MVP 边界输入 |
14
+ | 事实核查角色 | 事实验证角色,回答“证据支持什么、用户真实痛点是什么” | 市场、竞品、用户洞察、MVP 边界输入 |
15
15
  | Matt skills `需求澄清` | 方法论 skill,回答“某个已选方向如何形成技术方案” | 设计说明、方案取舍、风险识别、进入计划前的批准点 |
16
16
 
17
17
  推荐关系:
@@ -20,7 +20,7 @@ Ideation 不等同于 Matt skills `需求澄清`:
20
20
  市场 / 竞品 / 用户事实 <-> 机会构想假设 <-> MVP 边界
21
21
  ```
22
22
 
23
- 如果只有一个模糊主题,可以先 Ideation 再 Discovery;如果已经有竞品、用户或行业材料,应先 Discovery 再 Ideation。二者循环到 Spec 前,必须收敛用户、痛点、做什么、不做什么和成功标准。
23
+ 如果只有一个模糊主题,可以先 Ideation 再 事实核查;如果已经有竞品、用户或行业材料,应先 事实核查 再 Ideation。二者循环到 Spec 前,必须收敛用户、痛点、做什么、不做什么和成功标准。
24
24
 
25
25
  ---
26
26
 
@@ -90,7 +90,7 @@ Substitute / Combine / Adapt / Modify / Put to another use / Eliminate / Reverse
90
90
  ## AI-Human Loop
91
91
 
92
92
  ```
93
- 人类提主题或 Discovery 事实 → AI 发散候选机会 → 人类选择 Top 10
94
- → AI 挑战者分析 → Discovery 验证证据 → AI 连接者找模式
93
+ 人类提主题或 事实核查 事实 → AI 发散候选机会 → 人类选择 Top 10
94
+ → AI 挑战者分析 → 事实核查 验证证据 → AI 连接者找模式
95
95
  → 收敛 MVP 边界 → 确认是否进入 Spec / Ticket 或 Matt skills 需求澄清 技术方案设计
96
96
  ```
@@ -0,0 +1,9 @@
1
+ # Plan(战略规划)
2
+
3
+ Plan 为 Spec 提供已确认的战略输入。目标和退出条件引用 [生命周期注册表](../process/lifecycle-registry.yaml),裁剪引用 [影响面规则](../process/harness-process-tailoring.md)。
4
+
5
+ 从 [规划模板](templates/plan-template.md) 开始。先识别哪些结论仍有效、哪些问题需要探索,再确认目标、业务边界、关键规则、MVP / 非目标、优先级和交接责任。业务边界与规则设计、方案决策包保留各自权威正文,Plan 通过引用组织输入,不重复定义。
6
+
7
+ 问题探索是阶段内部按需开展的活动;市场和竞品事实使用 `competitive-intelligence`,技术或战略证据使用 `yss-research`。机会构想与事实核查可以反复迭代,关键问题解决后才申请进入 Spec。
8
+
9
+ 历史资产处理见 [迁移说明](../process/plan-migration.md)。
@@ -0,0 +1,23 @@
1
+ # Plan → Spec 入口审阅
2
+
3
+ 正式 Spec 起草之前必须通过 `node scripts/verify-plan-spec-entry <state.yaml>`;显式 `to-spec`、恢复、任务包派发和下一路由均不得绕过。Plan 不通过时可继续无依赖调研,不创建正式 Spec 草稿。此检查复用 `plan-conclusion` 用户决定,不新增批准阶段,也不授权实现。
4
+
5
+ 检查 ID 与条件门禁取自 `docs/process/lifecycle-registry.yaml` 的 `stage.plan.spec_entry`。查询 Plan 或相关工作单元自动加载 `planning`、`grill_exit` 和全量检查,初始均为 `pending`。自动加载不代表勾选通过。
6
+
7
+ ## 持久化合同
8
+
9
+ 入口状态包含 `feature_id`、`plan_review_ref`、`plan_user_decision_ref`。这三个字段同样用于任务包、checkpoint 和完成态 Workflow Execution Result;不从历史阶段、路径或默认值推断。
10
+
11
+ `plan_review_ref` 指向 YAML / JSON:
12
+
13
+ - `schema_version: 1`、`kind: plan-entry-review`、与入口一致的 `feature_id`。
14
+ - `plan_ref`:本次 Plan 正文;`context_reconciliation_ref`:本次已通过的 Context 调和记录。
15
+ - `basis`:非空 `{ref, digest}` 列表,digest 为实际文件字节的 `sha256:` 摘要。必须包含 Plan 正文、根 `CONTEXT.md`、生命周期注册表、Context 调和记录及各检查和门禁引用的文件。远程事实先保存可追溯证据快照。
16
+ - `checks`:注册表要求的全部检查 ID,每项包含 `status: pending | passed` 和非空 `evidence_refs`,引用 `basis`。必需检查不接受 `not-applicable`。缺项、未知项、pending 均阻断。
17
+ - `open_items`:显式数组,空数组代表无未决项。每项有 `id`、`critical`、`runnable_blocker`、`status` 和 `evidence_refs`。影响业务边界、关键规则或 MVP 的问题属于 critical。`resolved` 须有解决证据;仅非关键、非可执行阻塞项可 `deferred`,并填写 `noncritical_reason`、`owner`、`resolution_point`、`downstream_recipient`。延期内容随整个审阅包展示并取得用户确认。
18
+ - `impacts`:显式评估 `domain_strategy`(领域边界、词汇、协作或核心规则影响)和 `stage_decision`(需要稳定阶段决策合同)。证据和判断必须呈现给用户;缺值不解释为 false。
19
+ - `gates`:注册表 Plan 门禁全部逐项记录。命中项须 `status: approved`、`approval_ref`、`subject_ref`、`approval_scope`、`evidence_refs`,会签记录及对应资产均加入 `basis`;未命中项须 `status: not-applicable`、`reason`、`evidence_refs`,并由用户确认影响面判断。阶段决策门禁的上游依赖必须批准,不能用 N/A 跳过。
20
+
21
+ 先固定审阅包及依据,展示当前内容、范围、风险、延期、N/A 理由和下一动作,再取得真实用户回复。`plan_user_decision_ref` 采用 `docs/process/schemas/user-decision.schema.json`:边界为 `plan-conclusion`,subject 为当前 `plan_review_ref`,scope 包含当前 `feature_id`。不得将旧“继续”、数字人会签或合成测试回复当作本次批准。
22
+
23
+ 审阅包、注册表、Plan、词汇、依据或批准来源变化均要求重新校验;摘要漂移时重新展示并取得当前确认。检查器保证结构、引用、摘要和回复绑定,不证明业务事实或身份来源绝对真实;主控仍须按证据核查影响面,不能为了放行而填 false 或空问题列表。
@@ -0,0 +1,58 @@
1
+ ---
2
+ pipeline: <feature-id>
3
+ stage: plan
4
+ status: draft
5
+ owner: <负责人>
6
+ ---
7
+
8
+ # <功能名称> Plan(战略规划)
9
+
10
+ > 生命周期身份:`stage.plan` / `artifact.plan-record`。按影响面填写,不制造未命中项的空产物。进入 Spec 的退出条件以 `docs/process/lifecycle-registry.yaml` 为准。
11
+
12
+ ## 1. 输入与复用依据
13
+
14
+ | 资产 / 证据引用 | 版本 | 本次仍有效的依据 | 需要重新探索的部分 |
15
+ |---|---|---|---|
16
+
17
+ ## 2. 用户、问题与目标
18
+
19
+ - 目标用户和关键业务故事:
20
+ - 问题、为什么现在做:
21
+ - 期望结果、成功标准及验证方式:
22
+ - 约束、假设及事实证据:
23
+
24
+ ## 3. 战略资产引用
25
+
26
+ | 权威资产 | 当前版本 / 引用 | 确认状态 / 未命中原因 |
27
+ |---|---|---|
28
+ | 根 CONTEXT.md | | |
29
+ | 业务边界与规则设计 | | |
30
+ | 方案决策包 | | |
31
+
32
+ 业务责任区、关键规则和协作关系消费上述资产,不复制为第二套正文。
33
+
34
+ ## 4. MVP、非目标和优先级
35
+
36
+ | 能力 / 范围 | MVP / 非目标 | 优先级及依据 | 成功信号 |
37
+ |---|---|---|---|
38
+
39
+ ## 5. 下游影响与交接
40
+
41
+ | 下游阶段 / 接收方 | 输入引用 | 责任人 | 待细化内容 | 命中门禁 |
42
+ |---|---|---|---|---|
43
+
44
+ 详细页面、API、技术模型和实现切片在后续阶段细化;此处只登记影响与交接责任。
45
+
46
+ ## 6. 未决项
47
+
48
+ | 问题 | 是否影响业务边界 / 关键规则 / MVP | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
49
+ |---|---|---|---|---|---|
50
+
51
+ ## 7. 退出核查与用户决定
52
+
53
+ - [ ] 已按注册表核查 Plan 退出条件;关键未决项已解决。
54
+ - [ ] 非关键未决项有依据、责任人、解决时点及接收方;无 runnable blocker。
55
+ - [ ] 用户已确认规划结论,命中的门禁及根词汇对账证据可读且版本当前。
56
+ - 当前资产版本、确认范围和原始用户决定引用:
57
+ - 结论:ready-for-human / blocked / 已满足进入 Spec 的条件(附证据)。
58
+ - 下一工作单元:
@@ -18,7 +18,7 @@
18
18
  | 模板源维护 | 影响面分析 | 修改单一事实来源、按验证与审查强度分级执行证据、必要的技能投影同步、fresh verification / review | 产品 Spec、产品设计、OpenAPI、运行时代码 |
19
19
  | 小改动 | 入口分诊 | 影响面、主 tracker 同步、fresh verification | Spec、架构、原型、切片(没有触发条件时) |
20
20
  | 中等变更 | 最近可信的 Spec / 架构阶段 | Spec、功能架构、必要工程审查、父 Ticket 和切片 | 未命中的 UI、数据或 API 门禁 |
21
- | 全新产品 / 模块 | Discovery | Discovery、Spec、产品总体设计、功能架构、必要设计 / 契约审查、父 Ticket 和切片 | 未命中的 UI、数据或 API 门禁 |
21
+ | 全新产品 / 模块 | Plan | Plan、Spec、产品总体设计、功能架构、必要设计 / 契约审查、父 Ticket 和切片 | 未命中的 UI、数据或 API 门禁 |
22
22
  | 高风险变更 | 既有冻结基线 | Spec Delta、架构 / 数据 / 工程审查、契约复核、切片和回滚设计 | 与风险证据无关的门禁 |
23
23
 
24
24
  任何裁剪都必须写明原因和证据,不生成空文档。对跨仓库变更,Harness 记录必须绑定实现仓库、分支、CI、验证命令、发布顺序和回滚点;没有前端、后端或 OpenAPI 影响时显式记录 `not-applicable`。
@@ -10,7 +10,7 @@
10
10
  | 稳定 ID | 阶段 | 目标 | 退出标准 |
11
11
  |---|---|---|---|
12
12
  | `stage.entry-triage` | 入口分诊 | 确认仓库身份、问题范围和影响面。 | yss-project.yaml 合法,影响面和最近可信阶段可解释。 |
13
- | `stage.discovery` | Discovery | 澄清问题、用户、约束和机会。 | 问题边界、关键假设和待确认项已记录。 |
13
+ | `stage.plan` | Plan(战略规划) | 确认目标、业务边界、关键规则、MVP / 非目标、优先级和交接责任,为 Spec 提供战略输入;按影响面探索并复用仍有效的结论。 | 用户确认规划结论,命中的战略与阶段决策门禁通过;影响业务边界、关键规则或 MVP 的问题已解决,其他未决项有责任人和解决时点;下游可进入 Spec,不代表可实现。 |
14
14
  | `stage.spec-architecture` | Spec / 功能架构 | 固化解决方案和功能边界。 | Spec 基线和功能边界可审查。 |
15
15
  | `stage.product-design` | 产品设计 | 在存在产品设计影响时校准页面流和状态。 | 命中的设计门禁通过;未命中项记录 not-applicable 及原因。 |
16
16
  | `stage.system-data-engineering` | 系统 / 数据架构与工程契约 | 固化系统、数据、工程基线和 API 契约。 | 受影响工程契约冻结或记录无 API 影响;required 脚手架证据齐全。 |
@@ -28,8 +28,8 @@
28
28
  |---|---|---|---|---|---|
29
29
  | `gate.frontend-delivery-inputs-verified` | 前端联合输入核验 | `stage.system-data-engineering` | 专职前端 profile 或显式 frontend_delivery 绑定的任务启动、恢复、合同编译、实现和验证;实际执行 scripts/verify-frontend-delivery,输入就绪不等于实现获批。 | 无 | `evidence.fresh-verification` |
30
30
  | `gate.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 | 无 | `evidence.repository-identity-check` |
31
- | `gate.domain-strategy-approved` | 业务边界与规则确认 | `stage.discovery` | 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
32
- | `gate.stage-decision-package-approved` | 阶段决策包批准 | `stage.discovery` | Discovery 到 Spec 入口需要稳定的阶段决策合同。 | `gate.domain-strategy-approved` | `evidence.stage-decision-package`、`evidence.approval-record` |
31
+ | `gate.domain-strategy-approved` | 业务边界与规则确认 | `stage.plan` | 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
32
+ | `gate.stage-decision-package-approved` | 阶段决策包批准 | `stage.plan` | Plan 到 Spec 入口需要稳定的阶段决策合同。 | `gate.domain-strategy-approved` | `evidence.stage-decision-package`、`evidence.approval-record` |
33
33
  | `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线。 | 无 | `evidence.approval-record` |
34
34
  | `gate.prototype-reviewed` | 原型评审 | `stage.product-design` | 命中产品设计影响,且低保真页面、流程、状态或 API 反推需要独立评审。 | 无 | `evidence.prototype-review-result` |
35
35
  | `gate.prototype-verified` | 原型交付物验证 | `stage.product-design` | 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准;真实组件验证留到前端实现阶段。 | 无 | `evidence.prototype-profile-decision`、`evidence.prototype-deliverable-verification` |
@@ -50,9 +50,9 @@
50
50
  | 稳定 ID | 产物 | 所属阶段 | 触发条件 |
51
51
  |---|---|---|---|
52
52
  | `artifact.impact-assessment` | 影响面分析 | `stage.entry-triage` | 每次变更。 |
53
- | `artifact.domain-strategy` | 业务边界与规则设计 | `stage.discovery` | 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。 |
54
- | `artifact.stage-decision-package` | 方案决策包 | `stage.discovery` | Discovery 到 Spec 入口需要结构化上游决策。 |
55
- | `artifact.discovery-record` | Discovery 记录 | `stage.discovery` | 新问题或边界不清。 |
53
+ | `artifact.domain-strategy` | 业务边界与规则设计 | `stage.plan` | 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。 |
54
+ | `artifact.stage-decision-package` | 方案决策包 | `stage.plan` | Plan 到 Spec 入口需要结构化上游决策。 |
55
+ | `artifact.plan-record` | Plan 记录 | `stage.plan` | 新问题或边界不清。 |
56
56
  | `artifact.spec` | Spec | `stage.spec-architecture` | 新功能、行为变化或范围扩大。 |
57
57
  | `artifact.product-overview` | 产品总体设计 | `stage.spec-architecture` | 进入 Spec 基线。 |
58
58
  | `artifact.functional-architecture` | 功能架构 | `stage.spec-architecture` | 新模块或跨边界变化。 |