人类的意图,AI 的执行。

传递意图,
而非代码。

定义 Why、What 和 Not。技术栈、架构、时间线、实现方式:让 AI 来选择。

快速开始 核心概念
"除了意图之外的一切都是选择。"
Why、What 和 Not 属于你。其余的交给 AI。

01 — 问题所在

AI 让生成变得廉价。没有意图,速度只会制造噪音。有了意图,速度便成为清晰。

没有 Intent

  • AI 选择了你从未要求的技术栈
  • AI 编造了无人需要的时间线
  • AI 膨胀了规格说明、用户故事和流程
  • 8 个文件,3,740 行,132KB 的噪音
  • 你仍然不知道什么应该存在

有了 Intent

  • Why:为什么这个必须存在
  • What:什么必须成立
  • Not:AI 不能越过的边界
  • 1 个文件,47 行,纯信号
  • AI 执行而非猜测

02 — 框架

一份 Intent 文档有三个部分,仅此而已。没有变更日志。

Why

为什么要做这件事?

阐明问题、目标和成功标准。如果这些改变了,意图就改变了。

What

我们在构建什么?

阐明功能、流程和边界情况。保持具体,但绝不指定技术栈、架构或时间线。

Not

我们永远不做什么?

阐明 AI 不可逾越的红线。范围限制、安全规则、质量标准、禁止的操作。

演进

学到的东西去哪里?

直接写进 Why、What 和 Not 本身。重要的学习会改写其中一行;什么都没改写的学习,暂时还不重要。INTENT.md 始终呈现当前的 Intent。变更原因记录在 commit 消息中。

03 — 生命周期

Intent 不是静态的。每一次实验都会改写 Why / What / Not,直到它们不再变动,或证据终结它们。

seed
→
exploring
→
clarified
→
build
dropped
← 任何状态都可以在这里终结。这是好事。
# INTENT.md # INTENT — Legacy Converter > status: exploring ## Why Problem: Legacy projects can't leverage vibe coding. Hypothesis: Generating a CLAUDE.md is the missing bridge. Validation: Convert one typed project, measure dev speed. ## What - [ ] Scan legacy codebase structure - [ ] Generate vibe-coding-ready CLAUDE.md - [ ] Report type coverage as a readiness score ## Not Forbidden: Never modify source files without explicit confirmation Scope: TypeScript only for now Out of scope: Automated refactoring suggestions
# git log --oneline INTENT.md — the history of intent, outside the file e41a9c2 Not: drop refactoring suggestions (interviews: nobody trusted them) 7b03d5f Why: CLAUDE.md generation is the bridge (interviews: most requested) 2c8f1e0 What: add readiness score (prototype v1: type coverage was the key signal)

04 — 流水线

人类定义意图并判断结果。AI 负责其余一切。

✍
编写 Intent
编写 Why / What / Not
人类
⚙
生成规格说明
AI 将意图转化为任务
AI
💻
实现
AI 代理编写代码
AI
🔍
验证
AI 审查、测试和代码检查
AI
🚀
部署
CI/CD 推送到生产环境
AI
💡
学习与决策
审查结果。更新意图或终止它
人类

05 — 原则

四条规则。违反它们,AI 就会开始猜测。

永远不写 How

Intent 设定约束,而非实现方式。写"不使用外部缓存层",而不是"使用 Redis"。

承认不确定性

用 (?) 标记未知项。诚实的不确定性胜过虚假的精确。

快速终止

如果想法已死,把状态设为 dropped,并在 commit 中说明原因。一个被终止的 intent 能节省未来的时间。

Intent 精度 = 输出质量

"做一个好应用"是噪音。"新用户在 30 秒内获得价值"才是 intent。

从意图开始。

写下 Why/What/Not。让 AI 选择其余的一切。

快速开始 GitHub
English 한국어 日本語