Assess whether a project is suitable for IDD, and educate on the IDD methodology.
Two modes
1. Assessment Mode
/intent-assess
Analyze the current project and assess whether it is suitable for adopting IDD.
2. Learning Mode
/intent-assess --learn
Educate on the IDD methodology and explain the core concepts.
Assessment Mode
Workflow
/intent-assess
↓
┌───────────────────────────────────┐
│ Phase 1: 项目分析 │
│ - 项目类型识别 │
│ - 代码库规模 │
│ - 现有文档情况 │
│ - 团队协作模式 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 适配度评估 │
│ - 计算匹配分数 │
│ - 识别优势和挑战 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 建议 │
│ - 是否推荐 IDD │
│ - 如何开始 │
│ - 替代方案（如不适合） │
└───────────────────────────────────┘
Assessment dimensions
| Dimension | Favorable for IDD | Unfavorable for IDD |
|---|---|---|
| Project type | System software, frameworks, libraries | Simple scripts, one-off projects |
| Code size | Medium to large (>5k LOC) | Small (<1k LOC) |
| Team collaboration | Multi-person collaboration, AI-assisted | Solo independent development |
| Architecture complexity | Multiple modules, boundaries needed | Single module, simple structure |
| Iteration approach | Continuous iteration, long-term maintenance | One-time delivery |
| AI tool usage | Using Claude/Copilot | Purely manual development |
Sample assessment report
# IDD Assessment Report
> Project: ainecore
> Date: 2026-01-19
## 适配度评分: 85/100 ⭐⭐⭐⭐
## 项目特征
| 特征 | 当前状态 | IDD 契合度 |
|------|---------|-----------|
| 项目类型 | 框架/平台 | ✅ 高 |
| 代码规模 | ~15k LOC | ✅ 高 |
| 模块数量 | 12 个 | ✅ 高 |
| 团队规模 | 3 人 + AI | ✅ 高 |
| 现有文档 | 部分 | 🟡 中 |
## 优势
- ✅ 多模块架构，需要清晰边界定义
- ✅ 使用 AI 辅助开发，Intent 可指导 AI
- ✅ 长期维护项目，文档价值高
- ✅ 已有部分设计文档，可迁移
## 挑战
- ⚠️ 需要建立 Intent 编写习惯
- ⚠️ 现有代码需要补充 Intent
- ⚠️ 团队需要学习 IDD 方法
## 建议
### 推荐: 采用 IDD ✅
该项目非常适合 IDD：
1. 多模块架构需要清晰的边界和契约
2. AI 辅助开发可以直接使用 Intent 作为上下文
3. 长期维护价值高
### 启动建议
1. **从核心模块开始**
- 先为 `src/core/` 编写 Intent
- 建立 Intent 模板和规范
2. **渐进式推广**
- 新功能必须先写 Intent
- 老代码逐步补充
3. **工具配套**
- 安装 IDD plugin
- 配置 CI/CD 集成
### 预期收益
- 🎯 AI 编码效率提升 ~30%
- 🎯 架构边界更清晰
- 🎯 新成员 onboard 更快
- 🎯 减少 "文档过时" 问题
Learning Mode
Interactive teaching
/intent-assess --learn
Teach IDD through a Q&A format:
┌───────────────────────────────────┐
│ 欢迎学习 IDD！ │
│ │
│ 我将介绍： │
│ 1. 什么是 IDD │
│ 2. IDD vs TDD vs SDD │
│ 3. Intent 文件结构 │
│ 4. 实际案例 │
│ │
│ 你想从哪个话题开始？ │
└───────────────────────────────────┘
Core concept explanations
1. What is IDD
开发方法论演进：
Traditional: Code → Test → Docs
(文档经常过时)
SDD: Spec → Code → Test
(Spec 分散，难以维护)
TDD: Test → Code → Docs
(测试不能捕捉设计理由)
IDD: Intent → Test → Code → Sync
(Intent 作为唯一真相来源)
2. The three-layer structure of Intent
┌─────────────────────────────────────┐
│ Layer 1: 结构图 (Structure) │
│ - 目录结构、数据结构、模块关系 │
│ - ASCII 图优先 │
├─────────────────────────────────────┤
│ Layer 2: 约束规则 (Constraints) │
│ - 依赖方向、边界规则、不变式 │
│ - 可转化为测试断言 │
├─────────────────────────────────────┤
│ Layer 3: 行为示例 (Examples) │
│ - 输入 → 输出 示例 │
│ - 边界情况 │
└─────────────────────────────────────┘
3. IDD vs SDD comparison
| 维度 | SDD | IDD |
|------|-----|-----|
| 组织方式 | 按类型 (功能/UX/技术) | 按模块 |
| 核心载体 | 文字描述 | 结构图 |
| 粒度 | 细分 User Story | 完整 Pattern |
| Task 管理 | 独立 Task 文件 | AI 自主分解 |
| LLM 友好度 | 需要拼装上下文 | 一次理解完整 |
4. Real-world cases
Show a real Intent file and explain the role of each part.
Quick reference
/intent-assess --learn --topic <topic>
Optional topics:
what- What is IDDvs-sdd- IDD vs SDD comparisonvs-tdd- IDD vs TDD comparisonstructure- Intent file structureworkflow- IDD workflowapproval- Section approval mechanismbest-practices- Best practices
Working with other commands
/intent-assess # 评估项目
↓ (如果适合)
/intent-assess --learn # 学习 IDD
↓
/intent-init # 初始化 IDD
↓
/intent-interview # 创建 Intent