vault: add GSD methodology deep-dive with examples and zettelkasten insights

Comprehensive GSD analysis: 15 sections covering core philosophy (fresh
context per agent), 5 methodologies (dream extraction, goal-backward
verification, nyquist validation, wave execution, checkpoints), full
command reference (37+), agent system (16 agents with model routing),
config system, git integration, state management, session continuity,
community best practices, pitfalls, framework comparison (GSD vs ECC vs
BMAD vs SpecKit), and 4 detailed practical examples (new project, brownfield,
debugging, quick tasks).

Three zettelkasten notes: context rot vs window isolation tradeoffs,
goal-backward vs forward verification, plans-as-prompts design pattern.
This commit is contained in:
Yaojia Wang
2026-03-20 00:19:23 +01:00
parent f04cd63760
commit e61baf7e4e
5 changed files with 990 additions and 0 deletions

View File

@@ -0,0 +1,29 @@
---
created: "2026-03-20 10:01"
type: zettel
tags: [claude-code, context-window, ai-quality, gsd]
source: "https://github.com/gsd-build/get-shit-done"
---
# 上下文腐烂与全新窗口隔离
AI 编码 Agent 的输出质量随上下文填充率非线性下降:
- 0-30%: 峰值质量
- 50%+: 开始赶工
- 70%+: 幻觉风险显著增加
GSD 的解决方案是**激进隔离**: 每个任务执行器获得全新的 200K token 上下文窗口,编排器保持在 30-40% 使用率。这与 ECC 的"策略性压缩"(在逻辑节点手动 `/compact`)形成对比。
两种方法的权衡:
- **全新窗口**: 质量最佳,但 token 成本高(每个 Agent 独立 API 调用)
- **策略性压缩**: 成本低,但依赖人类判断何时压缩,且压缩可能丢失关键上下文
理想方案可能是两者结合: 对复杂多阶段项目用 GSD 的窗口隔离,对日常编码用 ECC 的策略压缩。
---
## Related
- [[GSD 方法论与最佳实践]]
- [[MCP数量与上下文窗口的反比关系]]

View File

@@ -0,0 +1,27 @@
---
created: "2026-03-20 10:02"
type: zettel
tags: [verification, methodology, ai-quality, gsd]
source: "https://github.com/gsd-build/get-shit-done"
---
# 目标回溯验证 vs 正向任务检查
传统软件验证是正向的: "任务 1 完成了吗?任务 2 完成了吗?全部完成 = 目标达成。" 这隐含假设任务列表是完备的。
GSD 的目标回溯验证(Goal-Backward Verification)反转方向: "用户应该能做什么?这个能力在代码中存在吗?不仅存在,还是真实实现(非桩代码)?不仅实现了,还与系统连接了?"
四级验证层次:
1. Exists — 文件在预期路径
2. Substantive — 真实实现,非 TODO/placeholder
3. Wired — 与系统其他部分连接import 被使用API 被调用)
4. Functional — 实际调用时能工作
这对 AI 生成代码尤其重要: LLM 擅长生成"看起来正确"的代码(通过 Level 1-2但经常遗漏连接Level 3。GSD 的桩代码检测模式专门针对这一弱点。
---
## Related
- [[GSD 方法论与最佳实践]]
- [[Hook驱动优于提示词驱动]]

View File

@@ -0,0 +1,27 @@
---
created: "2026-03-20 10:03"
type: zettel
tags: [prompt-engineering, ai-architecture, gsd]
source: "https://github.com/gsd-build/get-shit-done"
---
# Plans as Prompts 设计模式
GSD 中 PLAN.md 不是"被转化为 prompt 的文档"——它**就是** prompt。XML 结构(`<task>`, `<action>`, `<verify>`, `<done>`)直接指导执行器的行为。
这个设计消除了"文档到 prompt 的翻译损失": 传统方式需要一个中间步骤把文档理解为指令每次翻译都引入歧义。Plans as Prompts 让计划者直接写执行指令,跳过翻译。
关键约束使这成为可能:
- 每个计划 ≤ 50% 上下文预算(确保执行器有足够空间思考)
- XML 结构强制精确性(不是自然语言的模糊描述)
- `<verify>` 块要求每个任务都有可执行的验证命令
- `<done>` 块定义明确的完成状态
更广泛的启示: 当 AI Agent 是执行者时,规划文档应该以 Agent 的"母语"(结构化 prompt书写而非以人类的可读性为优先。
---
## Related
- [[GSD 方法论与最佳实践]]
- [[目标回溯验证vs正向任务检查]]