intent-init

Intent Init

Initialize the project's IDD (Intent Driven Development) structure.

Features

1. Check current state - Scan the project to identify existing intent files or similar structures
2. Create directories - Set up the standard IDD directory structure
3. Generate templates - Create the entry INTENT.md and module-level templates
4. Configuration suggestions - Provide configuration suggestions based on the project type

Workflow

/intent-init
    ↓
┌───────────────────────────────────┐
│  Phase 1: 扫描现状                │
│  - 查找 intent/, specs/, docs/   │
│  - 识别 README, DESIGN 等文档    │
│  - 检测项目类型 (monorepo/单模块) │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 2: 展示发现                │
│  - 已有文档列表                   │
│  - 项目结构分析                   │
│  - 推荐的 IDD 结构                │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 3: 确认并创建              │
│  - AskUserQuestion 确认结构       │
│  - 创建目录和模板文件             │
│  - 可选：迁移现有文档             │
└───────────────────────────────────┘

Standard IDD directory structure

Single-module project

project/
├── intent/
│   └── INTENT.md           # 项目 Intent（入口）
├── src/
└── ...

Monorepo / multi-module project

project/
├── intent/
│   ├── INTENT.md           # 项目概述（入口）
│   └── architecture/
│       ├── DEPENDENCIES.md # 模块依赖图
│       └── BOUNDARIES.md   # 边界规则
│
├── src/
│   ├── module-a/
│   │   └── intent/
│   │       └── INTENT.md   # 模块 Intent
│   └── module-b/
│       └── intent/
│           └── INTENT.md
└── ...

Template content

Project-level INTENT.md

# [Project Name] Intent

> 一句话描述项目目标

状态: draft
最后更新: YYYY-MM-DD

## 愿景

[项目要解决的问题和目标]

## 架构概览

[ASCII 架构图]

## 模块索引

| 模块 | 职责 | Intent |
|------|------|--------|
| xxx | ... | [link] |

## 非目标

- [明确不做什么]

## 约束

- [技术约束]
- [业务约束]

Module-level INTENT.md

# [Module] Intent

> 模块职责一句话

状态: draft
最后更新: YYYY-MM-DD

## 职责

[模块做什么]

## 非目标

[模块不做什么]

## 数据结构

[核心数据结构定义]

## API

[对外接口定义]

## 示例

[输入 → 输出 示例]

Detection logic

Identify existing Intent structures

// 检查路径
const intentPaths = [
  'intent/INTENT.md',
  'INTENT.md',
  'docs/INTENT.md',
  'specs/',
  'design/',
];

// 检查内容特征
const intentMarkers = [
  '## 职责',
  '## 非目标',
  '::: locked',
  '::: reviewed',
];

Project type identification

// Monorepo 特征
const monorepoMarkers = [
  'packages/',
  'apps/',
  'src/modules/',
  'lerna.json',
  'pnpm-workspace.yaml',
];

Options

/intent-init              # 交互式初始化
/intent-init --dry-run    # 只展示计划，不执行
/intent-init --minimal    # 最小化结构
/intent-init --migrate    # 尝试迁移现有文档

Working with other commands

/intent-init              # 初始化结构
    ↓
/intent-interview         # 填充 Intent 内容
    ↓
/intent-review            # 审批关键 sections
    ↓
[开发]
    ↓
/intent-check             # 检查一致性