@openprd/cli 0.1.9 → 0.1.11

package/src/workspace-workflow.js

@@ -11,12 +11,16 @@ import { assertReviewPresentationReady, getReviewPresentationGate } from './revi
 import { syncSessionBindingFromReview, syncSessionBindingFromSnapshot } from './session-binding.js';
 import { timestamp } from './time.js';
 import { generateWorkUnitId, normalizeWorkUnitId, readWorkUnitBinding, resolveTargetRoot, writeWorkUnitBinding } from './work-unit.js';
-import { appendDecision, appendOpenQuestions, appendProgress, appendWorkflowEvent, buildClarificationPlan, buildClarificationState, buildCurrentStateSnapshot, buildWorkflowTaskGraph, CAPTURE_SOURCES, coerceCapturedValue, deriveGateLabels, detectWorkspaceScenario, extractMarkdownSection, FIELD_PATH_TO_STATE_KEY, isSupportedProductType, loadCurrentLaneSnapshot, loadLatestVersionSnapshot, loadWorkspace, normalizeVersionId, persistWorkspaceCurrentState, readActiveRequirementLane, readVersionIndex, readVersionSnapshot, renderFlowDoc, renderHandoffDoc, renderRolesDoc, resolveActiveTemplatePack, resolveCurrentProductType, validateWorkspace, writeVersionIndex, writeVersionSnapshot } from './workspace-core.js';
+import { appendDecision, appendOpenQuestions, appendProgress, appendWorkflowEvent, buildClarificationPlan, buildClarificationState, buildCurrentStateSnapshot, buildWorkflowTaskGraph, CAPTURE_SOURCES, coerceCapturedValue, deriveGateLabels, detectWorkspaceScenario, extractMarkdownSection, FIELD_PATH_TO_STATE_KEY, isSupportedProductType, loadCurrentLaneSnapshot, loadLatestVersionSnapshot, loadWorkspace, normalizeVersionId, persistWorkspaceCurrentState, readActiveRequirementLane, readVersionIndex, readVersionSnapshot, renderFlowDoc, renderHandoffDoc, renderRolesDoc, resolveActiveTemplatePack, resolveCurrentProductType, USER_CLARIFICATION_PATHS, validateWorkspace, writeVersionIndex, writeVersionSnapshot } from './workspace-core.js';
 
 function requirementGatePath(projectRoot) {
   return path.join(projectRoot, '.openprd', 'harness', 'requirement-gate.json');
 }
 
+function normalizedText(value) {
+  return String(value ?? '').replace(/\s+/g, ' ').trim();
+}
+
 const PRD_REVIEW_STATUSES = ['pending-confirmation', 'confirmed', 'needs-revision'];
 const CURRENT_SNAPSHOT_CACHE_KEYS = [
   'versionId',
@@ -30,6 +34,7 @@ const CURRENT_SNAPSHOT_CACHE_KEYS = [
 const REVIEW_PRESENTATION_RELEVANT_FIELD_PREFIXES = [
   'problem.',
   'users.',
+  'validation.',
   'goals.',
   'scope.',
   'scenarios.',
@@ -56,6 +61,28 @@ const REVIEW_PRESENTATION_RELEVANT_OVERRIDE_KEYS = new Set([
   'primaryUsers',
   'secondaryUsers',
   'stakeholders',
+  'community',
+  'seedUsers',
+  'communityFit',
+  'currentAlternative',
+  'painEvidence',
+  'manualPath',
+  'manualPlaybook',
+  'commitmentSignals',
+  'firstValidationStep',
+  'defaultAlivePlan',
+  'paymentProof',
+  'mvpSlice',
+  'weekendTest',
+  'smallestExecution',
+  'productizeGate',
+  'firstCustomerPath',
+  'pricingHypothesis',
+  'customerOneProfitability',
+  'growthDiscipline',
+  'reversibility',
+  'customerTruth',
+  'valuesFit',
   'goals',
   'successMetrics',
   'acceptanceGoals',
@@ -109,6 +136,28 @@ const SYNTHESIZE_CONTENT_OVERRIDE_KEYS = new Set([
   'primaryUsers',
   'secondaryUsers',
   'stakeholders',
+  'community',
+  'seedUsers',
+  'communityFit',
+  'currentAlternative',
+  'painEvidence',
+  'manualPath',
+  'manualPlaybook',
+  'commitmentSignals',
+  'firstValidationStep',
+  'defaultAlivePlan',
+  'paymentProof',
+  'mvpSlice',
+  'weekendTest',
+  'smallestExecution',
+  'productizeGate',
+  'firstCustomerPath',
+  'pricingHypothesis',
+  'customerOneProfitability',
+  'growthDiscipline',
+  'reversibility',
+  'customerTruth',
+  'valuesFit',
   'goals',
   'successMetrics',
   'acceptanceGoals',
@@ -157,6 +206,29 @@ const SYNTHESIZE_CONTENT_OVERRIDE_KEYS = new Set([
   'evalPlan',
 ]);
 
+function buildBrainstormSuggestion({ currentState, analysis, clarification, requirementGate }) {
+  const promptPreview = String(requirementGate?.promptPreview ?? '');
+  const explicit = /(脑暴|brainstorm|帮忙梳理|梳理一下|梳理下|先想清楚)/iu.test(promptPreview);
+  const missingRequiredFields = Number(analysis?.missingRequiredFields ?? 0);
+  const noProblemStatement = !normalizedText(currentState?.problemStatement);
+  const noPrimaryUsers = !Array.isArray(currentState?.primaryUsers) || currentState.primaryUsers.length === 0;
+  const shouldSuggest = explicit || (clarification?.shouldAskUser && missingRequiredFields >= 4) || (noProblemStatement && noPrimaryUsers && missingRequiredFields >= 3);
+  if (!shouldSuggest) {
+    return { recommended: false };
+  }
+  const reasons = [];
+  if (explicit) reasons.push('用户当前更像是在请求先梳理业务方向');
+  if (missingRequiredFields >= 4) reasons.push(`还有 ${missingRequiredFields} 个关键信息未确认`);
+  if (noProblemStatement) reasons.push('问题定义还不够稳定');
+  if (noPrimaryUsers) reasons.push('核心用户和场景还没锁定');
+  return {
+    recommended: true,
+    explicitTrigger: explicit,
+    reason: reasons.join('；'),
+    suggestedCommand: 'openprd brainstorm . --open',
+  };
+}
+
 function normalizePrdReviewStatus(status) {
   return PRD_REVIEW_STATUSES.includes(status) ? status : 'pending-confirmation';
 }
@@ -192,6 +264,41 @@ function requirementGateReferenceTimestamp(gate) {
   return gate?.confirmedAt ?? gate?.updatedAt ?? gate?.openedAt ?? null;
 }
 
+function requirementNextActionBlocksSynthesize(nextAction) {
+  return nextAction === 'clarify-user' || nextAction === 'classify' || nextAction === 'interview';
+}
+
+function gateHasClarificationConfirmation(gate) {
+  return Boolean(gate?.clarificationConfirmedAt || gate?.status === 'clarification-confirmed');
+}
+
+function latestUserConfirmedCaptureTimestamp(currentState, paths = null) {
+  const timestamps = Object.entries(currentState?.captureMeta ?? {})
+    .filter(([field, entry]) => (!paths || paths.has(field)) && entry?.source === 'user-confirmed')
+    .map(([, entry]) => entry?.capturedAt)
+    .filter(Boolean)
+    .map(String);
+  return timestamps.length > 0 ? timestamps.sort().at(-1) : null;
+}
+
+function latestConfirmedClarificationCaptureTimestamp(currentState) {
+  return latestUserConfirmedCaptureTimestamp(currentState, USER_CLARIFICATION_PATHS)
+    || latestUserConfirmedCaptureTimestamp(currentState);
+}
+
+function hasDerivedClarificationCaptureSince(currentState, gateAt) {
+  const reference = String(gateAt || '');
+  return Object.entries(currentState?.captureMeta ?? {}).some(([field, entry]) => {
+    if (!USER_CLARIFICATION_PATHS.has(field)) {
+      return false;
+    }
+    if (!entry?.capturedAt || String(entry.capturedAt) < reference) {
+      return false;
+    }
+    return Boolean(entry.source) && entry.source !== 'user-confirmed' && !NON_SEMANTIC_CAPTURE_SOURCES.has(entry.source);
+  });
+}
+
 function gateQuestionLimit(gate, fallback) {
   const raw = Number(gate?.approvalPolicy?.maxClarificationQuestions);
   if (!Number.isFinite(raw) || raw <= 0) {
@@ -210,7 +317,23 @@ function ensureFreshRequirementStateForSynthesize({ gate, currentState, override
   }
   const capturedAt = latestCaptureTimestamp(currentState);
   if (capturedAt && String(capturedAt) >= String(gateAt)) {
-    return;
+    if (!gateHasClarificationConfirmation(gate)) {
+      return;
+    }
+    const confirmedCaptureAt = latestConfirmedClarificationCaptureTimestamp(currentState);
+    const hasDerivedCapture = hasDerivedClarificationCaptureSince(currentState, gateAt);
+    if (confirmedCaptureAt && String(confirmedCaptureAt) >= String(gateAt) && !hasDerivedCapture) {
+      return;
+    }
+    throw new Error([
+      'OpenPrd 已阻止 synthesize：当前需求摘要虽已确认，但 current.json 还没有把本轮确认内容稳定写回。',
+      hasDerivedCapture
+        ? '检测到本轮仍有 user clarification 字段被写成 agent-inferred / project-derived；请先改用 openprd capture 按 canonical 字段路径并以 user-confirmed 写回，再继续 synthesize。'
+        : '请先用 openprd capture 按 canonical 字段路径并以 user-confirmed 写回本轮确认事实，再继续 synthesize。',
+      hasSynthesizeContentOverrides(overrides)
+        ? 'partial override 不能替代这一步 requirement write-back。'
+        : null,
+    ].filter(Boolean).join(' '));
   }
   throw new Error([
     'OpenPrd 已阻止 synthesize：当前有新的需求入口，但 current.json 还没有记录本轮确认答案。',
@@ -220,6 +343,27 @@ function ensureFreshRequirementStateForSynthesize({ gate, currentState, override
   ].join(' '));
 }
 
+async function ensureRequirementLaneReadyForSynthesize(ws) {
+  const guidance = await computeWorkspaceGuidance(ws, { questionLimit: 5 });
+  const missingRequiredFields = Number(guidance.analysis?.missingRequiredFields ?? 0);
+  const lacksProductType = !guidance.analysis?.productType;
+  const blockedByStructuredGap = guidance.nextAction === 'classify'
+    || guidance.nextAction === 'interview'
+    || (guidance.nextAction === 'clarify-user' && (lacksProductType || missingRequiredFields > 0));
+  if (!blockedByStructuredGap) {
+    return;
+  }
+  throw new Error([
+    'OpenPrd 已阻止 synthesize：当前 requirement lane 还没有离开需求补齐阶段。',
+    `当前下一步仍是 ${guidance.nextAction}。`,
+    guidance.reason ? `原因: ${guidance.reason}` : null,
+    guidance.suggestedCommand ? `建议先执行: ${guidance.suggestedCommand}。` : null,
+    Array.isArray(guidance.suggestedQuestions) && guidance.suggestedQuestions.length > 0
+      ? `优先补齐: ${guidance.suggestedQuestions.slice(0, 2).join('；')}。`
+      : null,
+  ].filter(Boolean).join(' '));
+}
+
 function resolveReviewPaths(ws, snapshot) {
   const canonicalReview = canonicalReviewPath(ws, snapshot.versionId);
   const activeReviewEntry = defaultReviewArtifactPath(ws);
@@ -383,7 +527,6 @@ function detectRequirementIntakeComplexity(gate) {
   ];
   const simpleConcretePatterns = [
     /按钮|文案|颜色|圆角|位置|间距|字号|图标|标题|空格|标点|错别字|拼写|label|copy/i,
-    /红圈|描边|边框|卡片|平铺|去掉|去除|移除|隐藏|对齐|留白|背景/,
     /从.+(改到|移到|移动到|换到|变成|改成|改为).+/,
   ];
   const reasons = [];
@@ -505,6 +648,67 @@ function collectProjectRiskProbes(gate, snapshot) {
   return probes;
 }
 
+function buildValidationFraming(sections = {}) {
+  const validation = sections.validation ?? {};
+  return {
+    community: shortList(validation.community, '需要先确认第一批最容易触达的 1 到 3 个社区、渠道或人群。'),
+    seedUsers: shortList(validation.seedUsers, '需要先确认至少 3 到 10 个具体先找谁聊、先服务谁。'),
+    communityFit: shortList(validation.communityFit, '需要先确认你为什么算这个社区里的自己人、他们在哪里聚集、为什么现在就能触达。'),
+    currentAlternative: shortList(validation.currentAlternative, '需要先确认他们现在主要靠什么替代方案在解决。'),
+    painEvidence: shortList(validation.painEvidence, '需要先确认这个问题到底有多痛、用户是否已经在为更差的办法花时间或花钱。'),
+    manualPath: shortList(validation.manualPath, '需要先确认不做完整产品时先怎么手工交付价值。'),
+    manualPlaybook: shortList(validation.manualPlaybook, '需要先确认手工交付的触发条件、步骤、工具、耗时和交接点。'),
+    commitmentSignals: shortList(validation.commitmentSignals, '需要先确认什么真实承诺能证明不是口头兴趣。'),
+    firstValidationStep: shortList(validation.firstValidationStep, '需要先确认最低成本先做哪一步验证。'),
+    defaultAlivePlan: shortList(validation.defaultAlivePlan, '需要先确认验证阶段怎样先活下来。'),
+    paymentProof: shortList(validation.paymentProof, '需要先确认有没有 10 个潜在用户样本、3/10 付费意愿或更强交易信号。'),
+    mvpSlice: shortList(validation.mvpSlice, '需要先确认第一版到底只做哪一件事。'),
+    weekendTest: shortList(validation.weekendTest, '需要先确认能不能压成周末级 MVP 或更轻的试跑。'),
+    smallestExecution: shortList(validation.smallestExecution, '需要先确认能否先用 spreadsheet、表单或 no-code 工具把价值跑出来。'),
+    productizeGate: shortList(validation.productizeGate, '需要先确认达到什么条件才允许继续产品化或加功能。'),
+    firstCustomerPath: shortList(validation.firstCustomerPath, '需要先确认第一批客户最现实的触达顺序。'),
+    pricingHypothesis: shortList(validation.pricingHypothesis, '需要先确认从第一个客户开始准备怎么收费。'),
+    customerOneProfitability: shortList(validation.customerOneProfitability, '需要先确认第一个客户如何覆盖时间和交付成本。'),
+    growthDiscipline: shortList(validation.growthDiscipline, '需要先确认销售、launch 和增长阶段准备守哪些纪律。'),
+    reversibility: shortList(validation.reversibility, '需要先确认验证结果一般时这条路是否容易回退，是否会逼出重招聘、长期绑定或重平台化。'),
+    customerTruth: shortList(validation.customerTruth, '需要先确认这更像在解决客户真问题还是满足内部冲动。'),
+    valuesFit: shortList(validation.valuesFit, '需要先确认这条路是否符合团队想坚持的价值观，以及它是不是你愿意长期住进去的业务形态。'),
+  };
+}
+
+function hasSatisfiedConfirmedClarificationWriteback({ gate, currentState, analysis, hasProductType }) {
+  if (!gateHasClarificationConfirmation(gate)) {
+    return false;
+  }
+  if (!hasProductType || Number(analysis?.missingRequiredFields ?? 0) > 0) {
+    return false;
+  }
+  const gateAt = requirementGateReferenceTimestamp(gate);
+  if (!gateAt) {
+    return false;
+  }
+  const confirmedCaptureAt = latestConfirmedClarificationCaptureTimestamp(currentState);
+  if (!confirmedCaptureAt || String(confirmedCaptureAt) < String(gateAt)) {
+    return false;
+  }
+  return !hasDerivedClarificationCaptureSince(currentState, gateAt);
+}
+
+function hasSatisfiedFreshRequirementWriteback({ gate, currentState, analysis, hasProductType }) {
+  if (!gate || gateHasClarificationConfirmation(gate)) {
+    return false;
+  }
+  if (!hasProductType || Number(analysis?.missingRequiredFields ?? 0) > 0) {
+    return false;
+  }
+  const gateAt = requirementGateReferenceTimestamp(gate);
+  if (!gateAt) {
+    return false;
+  }
+  const capturedAt = latestCaptureTimestamp(currentState);
+  return Boolean(capturedAt && String(capturedAt) >= String(gateAt));
+}
+
 function buildProjectFraming({ gate, snapshot, scenario, productType }) {
   const sections = snapshot.sections ?? {};
   const guardrailHints = [
@@ -512,6 +716,7 @@ function buildProjectFraming({ gate, snapshot, scenario, productType }) {
     ...normalizeTextList(sections.constraints?.dependencies),
   ];
   const riskProbes = collectProjectRiskProbes(gate, snapshot);
+  const validationFraming = buildValidationFraming(sections);
   return {
     audience: shortList(
       sections.users?.primaryUsers,
@@ -524,6 +729,7 @@ function buildProjectFraming({ gate, snapshot, scenario, productType }) {
     nonGoals: shortList(sections.scope?.outOfScope, '需要先确认本轮先不做什么。'),
     guardrails: shortList(guardrailHints, '需要先确认哪些现有能力、数据、流程或体验不能被破坏。'),
     architectureSignals: summarizeArchitectureSignals(gate, snapshot),
+    validationFraming,
     riskProbes,
     riskProbeSummary: shortList(riskProbes, '当前没有明显命中额外风险探针。'),
   };
@@ -553,7 +759,7 @@ function describeProductLensFocus(productType) {
 function requirementTypeDisplay(gate) {
   const tier = String(gate?.intent?.requirementTier ?? '').toLowerCase();
   if (tier === 'l0') {
-    return '快速修正（L0）';
+    return '直接处理（L0）';
   }
   if (tier === 'l1') {
     return '现有功能优化（L1）';
@@ -800,6 +1006,7 @@ function buildInlineClarification({ clarification, reflection, presentation }) {
   const prompt = reflection?.promptPreview || '本轮需求';
   const projectContext = reflection?.projectContext ?? {};
   const projectFraming = projectContext.projectFraming ?? {};
+  const validationFraming = projectFraming.validationFraming ?? {};
   const productType = projectContext.productType;
   const primaryQuestion = clarification.mustAskUser[0] ?? null;
   const followUpQuestions = clarification.mustAskUser.slice(1, presentation.mode === 'inline' ? 2 : 3);
@@ -830,6 +1037,27 @@ function buildInlineClarification({ clarification, reflection, presentation }) {
     `- 第一版先让用户做到：${projectFraming.firstSlice ?? '待确认'}。`,
     `- 这轮先不碰：${projectFraming.nonGoals ?? '待确认'}。`,
     `- 必须守住：${projectFraming.guardrails ?? '待确认'}。`,
+    `- 第一批最容易触达：${validationFraming.community ?? '待确认'}。`,
+    `- 社区契合与触达依据：${validationFraming.communityFit ?? '待确认'}。`,
+    `- 当前主要替代：${validationFraming.currentAlternative ?? '待确认'}。`,
+    `- 痛点与替代证据：${validationFraming.painEvidence ?? '待确认'}。`,
+    `- 先怎么手工交付：${validationFraming.manualPath ?? '待确认'}。`,
+    `- 手工作战卡：${validationFraming.manualPlaybook ?? '待确认'}。`,
+    `- 什么承诺才算真需求：${validationFraming.commitmentSignals ?? '待确认'}。`,
+    `- 最低成本先验证：${validationFraming.firstValidationStep ?? '待确认'}。`,
+    `- 怎么先活下来：${validationFraming.defaultAlivePlan ?? '待确认'}。`,
+    `- 付费验证信号：${validationFraming.paymentProof ?? '待确认'}。`,
+    `- 第一版只做一件事：${validationFraming.mvpSlice ?? '待确认'}。`,
+    `- 周末级验证长什么样：${validationFraming.weekendTest ?? '待确认'}。`,
+    `- 最小工具桥接：${validationFraming.smallestExecution ?? '待确认'}。`,
+    `- 产品化门槛：${validationFraming.productizeGate ?? '待确认'}。`,
+    `- 第一批客户路径：${validationFraming.firstCustomerPath ?? '待确认'}。`,
+    `- 初始收费假设：${validationFraming.pricingHypothesis ?? '待确认'}。`,
+    `- 客户 1 盈利路径：${validationFraming.customerOneProfitability ?? '待确认'}。`,
+    `- 销售与增长纪律：${validationFraming.growthDiscipline ?? '待确认'}。`,
+    `- 结果一般是否容易回退：${validationFraming.reversibility ?? '待确认'}。`,
+    `- 更像客户真问题还是自嗨：${validationFraming.customerTruth ?? '待确认'}。`,
+    `- 是否符合团队价值观：${validationFraming.valuesFit ?? '待确认'}。`,
   ];
   if (projectFraming.architectureSignals) {
     lines.push(`- 这次更可能会影响：${projectFraming.architectureSignals}。`);
@@ -950,6 +1178,21 @@ async function buildRequirementIntakeReflection({ projectRoot, ws, snapshot, ana
     productType: snapshot.productType ?? resolveCurrentProductType(ws),
   });
   const lensQuestion = buildLensReflectionQuestion(snapshot.productType ?? resolveCurrentProductType(ws));
+  const validationLoopQuestion = reflectionQuestion(
+    'validation-loop',
+    '验证与创业闭环',
+    '请确认第一批最容易触达的社区或用户是谁、你为什么算这个社区里的自己人、他们现在靠什么替代、问题到底有多痛、如果先不做完整产品怎么手工交付、手工作战卡怎么写、什么真实承诺最能证明值得继续，以及最低成本验证和先活下来底线是什么。'
+  );
+  const mvpAndSalesQuestion = reflectionQuestion(
+    'mvp-sales',
+    '最小 MVP 与首批成交',
+    '请确认第一版到底只做哪一件事、能不能压成周末级 MVP 或更轻试跑、能不能先用 spreadsheet 或 no-code 工具跑起来、第一批客户最现实的触达顺序是什么，以及从第一个客户开始准备怎么收费、有没有 10 个潜在用户样本和更强付费信号、达到什么条件才允许产品化。'
+  );
+  const minimalistReviewQuestion = reflectionQuestion(
+    'minimalist-review',
+    '可逆性 / 客户真问题 / 价值观',
+    '请确认如果验证结果一般，这条路有多可逆，是否会逼出重招聘、长期绑定或重平台化；这更像在解决客户真问题还是满足内部技术冲动；以及它是否符合团队现在想坚持的价值观、是不是你愿意长期住进去的业务形态。'
+  );
   const needsDeliveryShapeQuestion = !needsInterfaceSketch
     && (
       projectFraming.riskProbes.length > 0
@@ -959,6 +1202,9 @@ async function buildRequirementIntakeReflection({ projectRoot, ws, snapshot, ana
     ? [
         reflectionQuestion('intent', '意图与目标', '请确认我理解得对不对：这次主要是谁在什么场景下遇到什么问题，第一版最想先改善什么结果？'),
         lensQuestion,
+        validationLoopQuestion,
+        mvpAndSalesQuestion,
+        minimalistReviewQuestion,
         reflectionQuestion('project-context', '项目影响范围', '结合当前项目，请确认第一版最小可用切片是什么；哪些已有模块、入口、流程或历史需求必须复用，哪些可以调整？'),
         reflectionQuestion('scope-quality', '范围与验收', '请确认这次先做到哪一步就算有价值；哪些这轮先不动；哪些老用户习惯、现有业务结果或交付节奏不能被影响？'),
         needsInterfaceSketch
@@ -1011,6 +1257,8 @@ async function buildRequirementIntakeReflection({ projectRoot, ws, snapshot, ana
           `当前产品：${productName}；当前产品场景：${formatProductTypeDisplay(productType, { fallback: '待确认' })}；已记录问题：${currentProblem}`,
           `当前范围线索：${currentScope}`,
           `首轮画像：用户群体=${projectFraming.audience}；产品形态=${projectFraming.productShape}；第一版先做=${projectFraming.firstSlice}`,
+          `验证闭环：可触达人群=${projectFraming.validationFraming?.community}；社区契合=${projectFraming.validationFraming?.communityFit}；当前替代=${projectFraming.validationFraming?.currentAlternative}；痛点证据=${projectFraming.validationFraming?.painEvidence}；手工作战卡=${projectFraming.validationFraming?.manualPlaybook}`,
+          `最小成交链：一件事 MVP=${projectFraming.validationFraming?.mvpSlice}；周末级验证=${projectFraming.validationFraming?.weekendTest}；最小工具桥接=${projectFraming.validationFraming?.smallestExecution}；产品化门槛=${projectFraming.validationFraming?.productizeGate}`,
           activeChange ? `仍有 active change：${activeChange.activeChange}（${activeChange.status}），需要和本轮需求分开评估。` : '当前没有检测到 active change 冲突。',
         ],
       },
@@ -1020,6 +1268,8 @@ async function buildRequirementIntakeReflection({ projectRoot, ws, snapshot, ana
         findings: [
           `仍需确认的信息：${shortList(missing, '暂无明显缺口')}`,
           `边界与约束：先不做=${projectFraming.nonGoals}；不能破坏=${projectFraming.guardrails}`,
+          `商业验证：承诺信号=${projectFraming.validationFraming?.commitmentSignals}；低成本验证=${projectFraming.validationFraming?.firstValidationStep}；先活下来=${projectFraming.validationFraming?.defaultAlivePlan}；付费验证=${projectFraming.validationFraming?.paymentProof}；初始收费=${projectFraming.validationFraming?.pricingHypothesis}；客户 1 盈利=${projectFraming.validationFraming?.customerOneProfitability}；增长纪律=${projectFraming.validationFraming?.growthDiscipline}`,
+          `极简判断：最小工具桥接=${projectFraming.validationFraming?.smallestExecution}；产品化门槛=${projectFraming.validationFraming?.productizeGate}；可逆性=${projectFraming.validationFraming?.reversibility}；客户真问题=${projectFraming.validationFraming?.customerTruth}；价值观一致性=${projectFraming.validationFraming?.valuesFit}`,
           needsInterfaceSketch ? '需求看起来涉及界面或流程，需要先给用户确认草图或关键操作路径。' : `影响环节：${projectFraming.architectureSignals}`,
           `业务提醒：${projectFraming.riskProbeSummary}`,
           '进入实现前必须保留范围、非目标、异常路径和验收证据。',
@@ -1058,6 +1308,27 @@ function renderRequirementIntakeReflection(reflection) {
     `| 第一版先做 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.firstSlice ?? '待补充')} |`,
     `| 暂不处理 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.nonGoals ?? '待补充')} |`,
     `| 不能破坏 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.guardrails ?? '待补充')} |`,
+    `| 可触达人群 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.community ?? '待补充')} |`,
+    `| 社区契合与触达依据 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.communityFit ?? '待补充')} |`,
+    `| 当前替代 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.currentAlternative ?? '待补充')} |`,
+    `| 痛点与替代证据 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.painEvidence ?? '待补充')} |`,
+    `| 手工路径 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.manualPath ?? '待补充')} |`,
+    `| 手工作战卡 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.manualPlaybook ?? '待补充')} |`,
+    `| 承诺信号 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.commitmentSignals ?? '待补充')} |`,
+    `| 最低成本验证 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.firstValidationStep ?? '待补充')} |`,
+    `| 先活下来 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.defaultAlivePlan ?? '待补充')} |`,
+    `| 付费验证信号 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.paymentProof ?? '待补充')} |`,
+    `| 第一版只做一件事 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.mvpSlice ?? '待补充')} |`,
+    `| 周末级验证 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.weekendTest ?? '待补充')} |`,
+    `| 最小工具桥接 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.smallestExecution ?? '待补充')} |`,
+    `| 产品化门槛 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.productizeGate ?? '待补充')} |`,
+    `| 第一批客户路径 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.firstCustomerPath ?? '待补充')} |`,
+    `| 初始收费假设 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.pricingHypothesis ?? '待补充')} |`,
+    `| 客户 1 盈利路径 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.customerOneProfitability ?? '待补充')} |`,
+    `| 销售与增长纪律 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.growthDiscipline ?? '待补充')} |`,
+    `| 可逆性判断 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.reversibility ?? '待补充')} |`,
+    `| 客户真问题校验 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.customerTruth ?? '待补充')} |`,
+    `| 价值观一致性 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.validationFraming?.valuesFit ?? '待补充')} |`,
     `| 影响环节 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.architectureSignals ?? '待补充')} |`,
     `| 业务提醒 | ${escapeMarkdownTableCell(reflection.projectContext.projectFraming?.riskProbeSummary ?? '待补充')} |`,
     '',
@@ -1091,6 +1362,9 @@ function buildRequirementIntakeDepth(gate, reflection = null) {
   const fallbackLayers = [
     reflectionQuestion('product-context', '用户 / 产品形态 / 问题', '先确认：这是给谁用的、它更像个人产品 / 团队流程 / Agent 协作中的哪一种、为什么现在值得解决？'),
     reflectionQuestion('product-outcome', '第一版切片 / 目标 / 成功标准', '请确认第一版最小可用切片是什么；解决后用户先能完成什么，用什么业务结果或验收标准判断有效？'),
+    reflectionQuestion('product-validation', '验证闭环 / 承诺信号', '请确认第一批最容易触达的社区或用户是谁、你为什么算这个社区里的自己人、他们现在靠什么替代、问题到底有多痛、如果先不做完整产品怎么手工交付、手工作战卡怎么写、什么真实承诺最能证明值得继续，以及最低成本验证和先活下来底线是什么。'),
+    reflectionQuestion('product-mvp-sales', '最小 MVP / 首批成交', '请确认第一版到底只做哪一件事、能不能压成周末级 MVP 或更轻试跑、第一批客户最现实的触达顺序是什么，以及从第一个客户开始准备怎么收费、怎么验证客户 1 也能打平时间和交付成本。'),
+    reflectionQuestion('product-minimalist-review', '可逆性 / 客户真问题 / 价值观', '请确认如果验证结果一般，这条路有多可逆；这更像在解决客户真问题还是满足内部技术冲动；以及它是否符合团队现在想坚持的价值观、是不是你愿意长期住进去的业务形态。'),
     reflectionQuestion('product-flow', '范围 / 非目标 / 异常路径', '请拆出本轮先做什么、不做什么、哪些既有行为不能被破坏，以及关键失败路径和恢复方式。'),
     reflectionQuestion(
       'product-detail',
@@ -1226,11 +1500,15 @@ async function synthesizeWorkspace(projectRoot, overrides = {}) {
   if (!(await exists(ws.workspaceRoot))) {
     throw new Error(`Missing workspace: ${ws.workspaceRoot}`);
   }
+  const requirementGate = await readActiveRequirementGate(projectRoot);
   ensureFreshRequirementStateForSynthesize({
-    gate: await readActiveRequirementGate(projectRoot),
+    gate: requirementGate,
     currentState: ws.data.currentState ?? {},
     overrides,
   });
+  if (requirementGate?.active && gateHasClarificationConfirmation(requirementGate)) {
+    await ensureRequirementLaneReadyForSynthesize(ws);
+  }
 
   const versionIndex = await readVersionIndex(ws);
   const nextVersionNumber = overrides.versionNumber ?? (versionIndex.length > 0
@@ -1911,6 +2189,18 @@ async function computeWorkspaceGuidance(ws, options = {}) {
   const scenario = await detectWorkspaceScenario(ws.projectRoot, ws, versionIndex);
   const requirementGate = await readActiveRequirementGate(ws.projectRoot);
   const intakeSatisfiedByReview = prdReviewState.status === 'confirmed' && analysis.missingRequiredFields === 0;
+  const intakeSatisfiedByConfirmedWriteback = hasSatisfiedConfirmedClarificationWriteback({
+    gate: requirementGate,
+    currentState,
+    analysis,
+    hasProductType,
+  });
+  const intakeSatisfiedByFreshWriteback = hasSatisfiedFreshRequirementWriteback({
+    gate: requirementGate,
+    currentState,
+    analysis,
+    hasProductType,
+  });
   const intakeReflection = await buildRequirementIntakeReflection({
     projectRoot: ws.projectRoot,
     ws,
@@ -1927,7 +2217,9 @@ async function computeWorkspaceGuidance(ws, options = {}) {
     captureMeta: currentState.captureMeta ?? {},
     prdReviewState,
     limit: Number(options.questionLimit ?? 5),
-  }), requirementGate, intakeReflection, { satisfied: intakeSatisfiedByReview });
+  }), requirementGate, intakeReflection, {
+    satisfied: intakeSatisfiedByReview || intakeSatisfiedByConfirmedWriteback || intakeSatisfiedByFreshWriteback,
+  });
 
   let nextAction = 'synthesize';
   let reason = 'PRD 可以合成为第一个版本。';
@@ -1987,6 +2279,12 @@ async function computeWorkspaceGuidance(ws, options = {}) {
 
   const taskGraph = buildWorkflowTaskGraph(analysisSnapshot, analysis, { diagramState, prdReviewState, clarificationState: clarification });
   const gates = deriveGateLabels({ nextAction, diagramState, clarification });
+  const brainstormSuggestion = buildBrainstormSuggestion({
+    currentState,
+    analysis,
+    clarification,
+    requirementGate,
+  });
 
   return {
     versionIndex,
@@ -2002,6 +2300,7 @@ async function computeWorkspaceGuidance(ws, options = {}) {
     suggestedCommand,
     suggestedQuestions,
     gates,
+    brainstormSuggestion,
   };
 }
 
@@ -2065,7 +2364,8 @@ async function nextWorkspace(projectRoot) {
       currentGate: gates.currentGate,
       upcomingGate: gates.upcomingGate,
     },
-    workflow: ['clarify', 'classify', 'interview', 'synthesize', 'diagram', 'review', 'freeze', 'handoff'],
+    brainstormSuggestion: guidance.brainstormSuggestion,
+    workflow: ['brainstorm', 'clarify', 'classify', 'interview', 'synthesize', 'diagram', 'review', 'freeze', 'handoff'],
   };
 }
 

package/.openprd/benchmarks/evidence/milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code.md

@@ -1,14 +0,0 @@
-# milvus.io/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
-
-- ID: milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code
-- 状态: approved
-- 场景: agent-harness, pr-review-harness
-- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
-- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
-- 研究方式: official_page_first
-- 来源: https://milvus.io/ar/blog/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
-
-## 备注
-
-AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge recommendation
-

package/.openprd/benchmarks/evidence/nolanlawson-com-using-ai-to-write-better-code-more-slowly.md

@@ -1,14 +0,0 @@
-# nolanlawson.com/using-ai-to-write-better-code-more-slowly
-
-- ID: nolanlawson-com-using-ai-to-write-better-code-more-slowly
-- 状态: approved
-- 场景: agent-harness, pr-review-harness
-- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
-- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
-- 研究方式: official_page_first
-- 来源: https://nolanlawson.com/2026/05/25/using-ai-to-write-better-code-more-slowly/
-
-## 备注
-
-AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge recommendation
-

package/.openprd/discovery/config.json

@@ -1,35 +0,0 @@
-{
-  "activeChange": "adaptive-project-framing",
-  "taskSharding": {
-    "maxItemsPerFile": 25,
-    "handoffRequired": true,
-    "firstFile": "tasks.md",
-    "nextFilePattern": "tasks-###.md"
-  },
-  "taskMetadata": {
-    "stableIdPattern": "T###.##",
-    "required": [
-      "done",
-      "verify"
-    ],
-    "optional": [
-      "deps",
-      "type",
-      "test-layer",
-      "test-size",
-      "test-scope",
-      "evidence",
-      "evidence-plan",
-      "upgrade-reason",
-      "waiver",
-      "waiver-reason",
-      "execution-mode",
-      "parallel-group",
-      "write-scope",
-      "owner-role",
-      "local-verify",
-      "integration-owner"
-    ],
-    "dependencyOrder": "dependencies must appear before dependents"
-  }
-}

package/.openprd/engagements/active/flows.md

@@ -1,35 +0,0 @@
-# 流程
-
-## 主流程
-
-- 用户第一次提需求时，OpenPrd 先输出一页项目画像：用户群体、产品形态、第一版先做、先不做、不能破坏、技术落点和风险探针
-- 如果用户表达已经足够清楚，Agent 直接用系统归纳的画像摘要请用户确认
-- 如果用户表达模糊，Agent 先追问少量高价值问题，必要时给 2 到 3 个方向或行业原型供用户选择
-- 画像确认后再进入后续 PRD、review、change 和 tasks 流程
-
-## Mermaid 流程图
-
-```mermaid
-flowchart LR
-  entry["入口触发<br/>用户第一次提需求时，OpenPrd 先输出一页项目画像：用户群体、产品形态、第一版先做、先不做、不能破坏、技术落点和风险探针"]
-  experience["产品内步骤<br/>如果用户表达已经足够清楚，Agent 直接用系统归纳的画像摘要请用户确认"]
-  decision{"决策点<br/>用户一开始只有一句模糊想法，需要先给候选方向而不是硬追问技术细节"}
-  success(["成功结果<br/>首轮 clarify 能输出结构化的项目画像摘要，并包含用户群体、产品形态、第一版先做、先不做和不能破坏项"])
-  failure[["失败与恢复<br/>入口过重，导致 Vibe Coding 用户在第一次提需时无法回答"]]
-  entry -->|"用户第一次提需求时，OpenPrd 先输出一页项目画像：用户群体、产品形态、第一版…"| experience
-  experience -->|"如果用户表达已经足够清楚，Agent 直接用系统归纳的画像摘要请用户确认"| decision
-  decision -->|"在第一次提需时先形成一页轻量项目画像，而不是直接跳进局部需求修改"| success
-  decision -.->|"入口过重，导致 Vibe Coding 用户在第一次提需时无法回答"| failure
-```
-
-## 边界情况
-
-- 用户一开始只有一句模糊想法，需要先给候选方向而不是硬追问技术细节
-- 已有项目上下文时应优先沿用已知事实，而不是把所有画像问题重问一遍
-- 局部 copy、样式或小交互修正不应被错误升级成重画像流程
-
-## 失败模式
-
-- 入口过重，导致 Vibe Coding 用户在第一次提需时无法回答
-- 入口过轻，导致 Agent 没有先确认项目边界就直接落地
-- 错误复用旧 active change 或旧 PRD 上下文，导致实现偏题

package/.openprd/engagements/active/handoff.md

@@ -1,16 +0,0 @@
-# 交接
-
-- 版本: v0005
-- 产品类型: agent
-- 模板包: agent
-- Digest: 7f0e2d2730982a2ae96647d2377f6204e54f8adadf1b18b05f4bc7167046c575
-- 负责人: Codex
-- 下一步: 生成新的 change 和 tasks，并按首轮项目画像流程修改 workflow、模板、文档和测试。
-- 目标系统: OpenPrd
-
-## 变化摘要
-
-- 新增：clarify 生成的 intake-reflection 应包含首轮项目画像和风险探针
-- 新增：inline clarification 应显式展示适用对象、产品形态、第一版先做、先不做、不能破坏和技术落点
-- 新增：冷启动 kickoff 问题改成画像导向问题，而不是抽象的通用提问
-- 新增：类型专项 intake 模板改成更贴近产品与业务语言的提问方式