Sync: add productivity workflow notes

wiki/concepts/PreBuildValidation.md

@@ -0,0 +1,40 @@
+---
+title: "PreBuild Validation"
+type: concept
+tags: [decision-gate, ai-agent, pre-build, competition-analysis]
+sources: [pre-build-idea-validator]
+last_updated: 2026-04-27
+---
+
+## Definition
+在 AI Agent 开始编写代码之前，自动进行市场竞争验证的流程机制。通过 [[idea-reality-mcp]] 扫描多个平台，评估赛道饱和度，以分数形式反馈给 Agent 作为决策依据。
+
+## How It Works
+1. **触发**：OpenClaw Agent 接收到任何新项目/功能/工具的构建指令
+2. **扫描**：idea_reality_check() 调用 MCP server 并行查询 GitHub + HN + npm + PyPI + Product Hunt
+3. **评估**：返回 reality_signal 分数（0-100）
+4. **决策门控**：
+   - 高分（>70）→ Agent STOP → 向用户报告竞品 + 询问决策
+   - 中分（30-70）→ 展示 pivot_hints → 建议差异化方向
+   - 低分（<30）→ Agent 直接开始构建
+5. **执行**：始终在写任何代码之前先展示分数和竞品信息
+
+## Key Design Principle
+- **[[Reality Signal]] 作为 Gate**：分数决定是否可以继续，而非人工主动触发
+- **自动化嵌入 Agent Instructions**：Pre-Build Validation 通过 OpenClaw 的 agent instructions 实现，无需每次手动调用
+- **Deep Mode**：重要决策可使用 `depth="deep"` 扫描全部5个数据源（适合黑客松批量验证10个想法）
+
+## Value
+- 防止独立开发者犯最昂贵的错误：**在一个已被解决的问题上花费大量时间**
+- 避免 6+ 小时的编码后才发现 GitHub 上已有 143,000+ 同类仓库的尴尬
+- 将"直觉判断"升级为"数据驱动决策"
+
+## Related Concepts
+- [[Reality Signal]]：PreBuild Validation 的核心量化指标
+- [[Autonomous Project Management]]：与 PreBuild Validation 的张力——自主性边界（高竞争时 Agent 应 STOP vs. Agent 应持续推进）
+- [[Market Research & Product Factory]]：PreBuild Validation 互补——前者挖痛点找方向，后者在动手前验证赛道竞争密度
+
+## Aliases
+- Pre-Build Idea Validation
+- Idea Validation
+- Competition Analysis Gate