Content
# Tool List
> **Conversational AI Development Planner** - Let anyone turn an idea into a complete project through conversation.
---
## ⚡ Integration Guide for AI Programming Tools
> This section is for AI. If you are Claude Code, Antigravity, Codex CLI, Gemini CLI, or other AI programming assistants, please read this section to learn how to load and use this Skill.
### What is this Skill
`dev-planner` is a conversational development planning workflow with the core file being `SKILL.md`. After loading, you will gain the following capabilities:
- Guide users to improve development requirements through multi-turn option conversations (zero terminology, friendly to beginners)
- Automatically generate three enterprise-level development documents (`DEV_DOCUMENT.md` / `API Documentation` / `Style Guide`)
- Orchestrate Agent sub-teams (backend / frontend / testing / documentation) to develop in parallel
- Automatically detect and call available MCP tools in the environment (GitHub / Database / Docker / web_search)
- Document-driven development, node testing gate control, Chinese Git submission
---
### 📥 File Download (compatible with all platforms)
```bash
# Download the core Skill file
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md -o SKILL.md
# Download the complete template package (recommended to download, AI-generated documents will refer to it)
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/dev-doc-template.md -o dev-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/api-doc-template.md -o api-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/style-guide-template.md -o style-guide-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/plan-template.md -o plan-template.md
# Or clone the entire repository
git clone https://github.com/cat9999aaa/dev-planner-skill.git
```
---
### 🔧 Integration Methods for Each Platform
---
#### Antigravity
Antigravity has two installation methods, choose according to the scope of use:
**Method 1: Project-level installation (only effective for the current project)**
```bash
# Execute in your project root directory
mkdir -p .agent/skills/dev-planner
# Download SKILL.md to the skill directory
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o .agent/skills/dev-planner/SKILL.md
# Download template files (optional, improve document generation quality)
mkdir -p .agent/skills/dev-planner/references
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/dev-doc-template.md \
-o .agent/skills/dev-planner/references/dev-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/api-doc-template.md \
-o .agent/skills/dev-planner/references/api-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/style-guide-template.md \
-o .agent/skills/dev-planner/references/style-guide-template.md
```
Final directory structure:
```
Your project/
└── .agent/
└── skills/
└── dev-planner/
├── SKILL.md ← Core file
└── references/ ← Template files (optional)
```
**Method 2: Global installation (effective for all projects)**
```bash
# Linux / macOS
mkdir -p ~/.antigravity/skills/dev-planner
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o ~/.antigravity/skills/dev-planner/SKILL.md
# Windows (PowerShell)
New-Item -ItemType Directory -Force "$env:USERPROFILE\.antigravity\skills\dev-planner"
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md" `
-OutFile "$env:USERPROFILE\.antigravity\skills\dev-planner\SKILL.md"
```
Or, if you have already cloned the repository to your local machine, you can use the CLI tool to link:
```bash
# Enter the skill directory
cd dev-planner-skill/dev-planner
# Link as a global skill
ag skill link --global
```
---
#### Claude Code
Claude Code loads context instructions through the `CLAUDE.md` file.
**Project-level installation (recommended):**
```bash
# Download SKILL.md in the project root directory, rename it to CLAUDE.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o CLAUDE.md
# Download template files to the references/ directory
mkdir -p references
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/dev-doc-template.md \
-o references/dev-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/api-doc-template.md \
-o references/api-doc-template.md
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/style-guide-template.md \
-o references/style-guide-template.md
```
**Global installation (effective for all projects):**
```bash
# Linux / macOS
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o ~/.claude/CLAUDE.md
# Windows (PowerShell)
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md" `
-OutFile "$env:USERPROFILE\.claude\CLAUDE.md"
```
Claude Code will automatically read `CLAUDE.md` after startup, and automatically trigger this Skill when the user mentions keywords such as "Help me develop...".
---
#### OpenAI Codex CLI
Codex CLI loads instructions through the `codex.md` file in the project root directory.
```bash
# Execute in the project root directory
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o codex.md
# Download template files
mkdir -p references
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/references/dev-doc-template.md \
-o references/dev-doc-template.md
# (Download other templates as needed)
```
Codex CLI will automatically read the `codex.md` in the current directory at startup, no additional configuration is required.
---
#### Google Gemini CLI
Gemini CLI loads instructions through the `GEMINI.md` file in the project root directory (similar to Claude Code's `CLAUDE.md`).
**Project-level installation:**
```bash
# Execute in the project root directory
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o GEMINI.md
```
**Global installation:**
```bash
# Linux / macOS
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o ~/.gemini/GEMINI.md
```
---
#### Cursor
Cursor loads project-level rules through the `.cursorrules` file (or the new `.cursor/rules/` directory).
```bash
# Method 1: Use .cursorrules (old version compatible)
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o .cursorrules
# Method 2: Use the new rule directory (Cursor 0.43+)
mkdir -p .cursor/rules
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o .cursor/rules/dev-planner.mdc
```
---
#### Aider
Aider loads custom instructions through the `--system` parameter or configuration file.
```bash
# Download SKILL.md first
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o .aider-skill.md
# Inject at startup
aider --system "$(cat .aider-skill.md)"
```
Or write to Aider configuration file `.aider.conf.yml`:
```yaml
# .aider.conf.yml
system: |
# Paste the full content of SKILL.md here
```
---
#### Continue.dev (VS Code / JetBrains plugin)
Add system prompts to the Continue configuration file `~/.continue/config.json`:
```bash
# Download SKILL.md content
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md \
-o /tmp/dev-planner-skill.md
```
Then edit `~/.continue/config.json`:
```json
{
"models": [
{
"title": "Claude with Dev Planner",
"provider": "anthropic",
"model": "claude-opus-4-6",
"systemMessage": "<paste the full content of SKILL.md>"
}
]
}
```
---
#### Universal Solution (applicable to any AI tool that supports system prompts)
If the tool you are using is not in the above list, as long as it supports custom system prompts, you can use this method:
```bash
# Get SKILL.md content, copy to clipboard
curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md
```
Paste the output content into your tool's "system prompt", "custom instruction", or "role setting" area.
---
### 📁 File Structure Description
```
dev-planner/
├── SKILL.md # Core Skill file, load this file to activate all capabilities
└── references/
├── dev-doc-template.md # DEV_DOCUMENT.md super detailed template (including architecture diagram / ER diagram / flow chart)
├── api-doc-template.md # API interface document template (including request response example / error code)
├── style-guide-template.md # Code specification + design system template
└── plan-template.md # Planning scheme output template
```
**Minimum integration**: Only `SKILL.md` is required to run, and the `references/` templates are used to improve document quality, recommended to download.
---
### 🚦 Trigger Keywords
Any of the following words will trigger the dev-planner Skill:
```
"Help me develop..." "I want to do a..." "I have an idea..."
"Make a website" "Make an APP" "Make a script"
"Make a robot" "Make a system" "plan mode"
"Conversational development" "Generate development documents" "Help me plan a project"
```
Even if the description is very vague (e.g., "I want to make something"), it should trigger this Skill to enter the conversation planning mode.
---
### 🔄 Workflow Overview (for AI understanding)
```
User describes idea
│
▼
Phase 1 PLAN MODE
8-step option conversation → Collect: project type / scale / technology stack / function / UI / deployment
│ User confirms plan
▼
Phase 2 DOC GEN
Generate three documents: DEV_DOCUMENT.md + API documentation + Style Guide
│ User confirms documents
▼
Phase 3 MCP SETUP
Detect available tools: GitHub MCP / Database MCP / Docker MCP / web_search
│
▼
Phase 4 TEAM DEV
Orchestrate Agent team parallel development:
Backend Agent + Frontend Agent + Testing Agent + Documentation Agent
Each node: development → MCP assistance → testing → submission → document synchronization
│ All nodes completed
▼
Phase 5 DELIVERY
Final report + technical manual + user manual + step-by-step deployment tutorial
```
---
### ⚠️ Important Constraints (AI must comply)
1. **Documents first**: All development strictly follows the generated three documents, no unauthorized changes to the technology stack
2. **Testing gate control**: Each node test fails, no submission, no skipping
3. **MCP priority**: When MCP tools are available, prioritize calling them, do not manually simulate
4. **Chinese submission**: All Git submissions must use Chinese
5. **Document synchronization**: Each node completed, immediately update three documents
---
---
## 👋 Introduction for Humans
### What is this project
dev-planner-skill is an **AI programming Skill package**, designed to solve one problem:
> **I have an idea, but I don't know how to develop it, and I don't know where to start.**
With this Skill installed, AI will become a patient development team leader. It won't ask you to fill out technical stacks or write requirement documents - it will ask you questions like a friend, and through a series of multiple-choice questions, help you turn your vague idea into a clear development plan.
After the plan is confirmed, AI will automatically generate three enterprise-level documents, then summon a virtual Agent development team (backend / frontend / testing / documentation), and develop the project in parallel, without requiring you to understand any technology.
---
### Why do this
This project originated from a real observation:
Current AI programming tools are getting stronger, but **the threshold is getting higher**. You need to know how to write Prompt, choose technical stacks, understand what API is... For real "beginners", these tools seem not to be related to them.
Another problem is that even experienced developers use AI development, the process is often chaotic: AI changes here today, forgot there tomorrow, code gets messy, documents never exist, and in the end, they don't know what state the project is in.
dev-planner aims to solve these two problems:
1. **Let beginners use it**: Conversational all multiple-choice questions, no need to understand any technical terms
2. **Let the development process be orderly**: Document-driven, testing gate control, each step has records, project status is clear at any time
---
### How to use
#### If you use Claude Code
```bash
# Installation
claude skill install https://github.com/cat9999aaa/dev-planner-skill/releases/latest/download/dev-planner.skill
# Then directly talk, for example:
# "I want to make an accounting App"
# "Help me develop an automatic microblogging script"
# "I want to make an internal company leave approval system"
```
#### If you use other AI tools
1. Open https://github.com/cat9999aaa/dev-planner-skill
2. Download `dev-planner/SKILL.md`
3. Copy and paste the content into your AI tool's "custom system prompt" area
4. Start conversation
#### Conversation Example
```
You: I want to create a website to help me manage my reading notes.
AI: 👋 Hello! Based on your description, this project belongs to:
🌐 A. Website/Web Application
📱 B. Mobile APP
...
(You select A)
AI: How big is this project?
🌱 A. Small tool, just for myself
...
(You select A)
... Several rounds of selection ...
AI: Planning completed! 12 development nodes, expected to use Vue3 + Node.js + SQLite.
Reply "Confirm" to start generating development documents.
You: Confirm
AI: Three documents generated. Reply "Start development" to launch the Agent team.
You: Start development
AI: [Backend Agent] Database design completed ✅
[Frontend Agent] Project scaffolding completed ✅
[Backend Agent] Note CRUD interface completed ✅
... (Fully automatic until completion)
```
### Document Structure
| File | Description |
| ------------------------------------------------ | ---------------------------------------- |
| `dev-planner/SKILL.md` | Core Skill, defines the complete workflow and specifications |
| `dev-planner/references/dev-doc-template.md` | Development document template (including architecture diagram/ER diagram/environment configuration, etc.) |
| `dev-planner/references/api-doc-template.md` | API interface document template |
| `dev-planner/references/style-guide-template.md` | Code specification + design system template |
| `dev-planner/references/plan-template.md` | Planning scheme output template |
| `dev-planner.skill` | Packaged Skill file (can be directly installed) |
### Contribution and Feedback
If you have ideas, find problems, or want to support more platforms, welcome:
- Raise an [Issue](https://github.com/cat9999aaa/dev-planner-skill/issues)
- Submit a Pull Request
- Or directly describe what you did with this Skill and where it's not enough in the Issue
### License
MIT License — Feel free to use, modify, and share.
