ccstart 2.2.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -27
- package/bin/create-project.js +473 -102
- package/package.json +3 -12
- package/template/claude/CLAUDE.md +11 -92
- package/template/claude/agents/backend.md +1 -1
- package/template/claude/agents/frontend.md +1 -1
- package/template/claude/hooks/claude-md-reminder.sh +15 -0
- package/template/claude/hooks/ticket-reminder.sh +19 -0
- package/template/claude/skills/create-script/SKILL.md +362 -0
- package/template/claude/skills/design-feature/SKILL.md +3 -3
- package/template/claude/skills/skill-creator/SKILL.md +1 -1
- package/template/claude/docs/ROADMAP.md +0 -62
- package/template/claude/docs/agent-orchestration.md +0 -183
- package/template/claude/skills/design-principles/skill.md +0 -237
package/README.md
CHANGED
|
@@ -5,20 +5,20 @@
|
|
|
5
5
|
[](https://opensource.org/licenses/MIT)
|
|
6
6
|
[](https://www.npmjs.com/package/ccstart)
|
|
7
7
|
|
|
8
|
-
Quick setup for Claude Code projects with built-in agents, skills,
|
|
8
|
+
Quick setup for Claude Code projects with built-in agents, skills, and tickets.
|
|
9
9
|
|
|
10
10
|
## Installation
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
|
-
#
|
|
14
|
-
npx ccstart
|
|
13
|
+
# To set up in a specific directory
|
|
14
|
+
npx ccstart <project directory>
|
|
15
15
|
|
|
16
16
|
# Setup in current directory
|
|
17
17
|
npx ccstart .
|
|
18
18
|
|
|
19
19
|
# Install globally (optional)
|
|
20
20
|
npm install -g ccstart
|
|
21
|
-
ccstart
|
|
21
|
+
ccstart <project directory>
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## What You Get
|
|
@@ -27,13 +27,11 @@ ccstart my-project
|
|
|
27
27
|
my-project/
|
|
28
28
|
├── CLAUDE.md # Project instructions for Claude
|
|
29
29
|
├── claude/
|
|
30
|
-
│ ├── agents/ # 4 specialized agents
|
|
31
|
-
│ ├── docs/ # ROADMAP.md + agent-orchestration.md
|
|
32
|
-
│ ├── skills/ # Workflow automation (commit, create-pr, etc.)
|
|
33
30
|
│ └── tickets/ # Task tracking system
|
|
34
31
|
└── .claude/
|
|
35
32
|
├── agents/ # Agents for Claude Code integration
|
|
36
|
-
|
|
33
|
+
├── skills/ # Skills for Claude Code integration
|
|
34
|
+
└── hooks/ # Hooks for Claude Code integration
|
|
37
35
|
```
|
|
38
36
|
|
|
39
37
|
## The Workflow
|
|
@@ -44,29 +42,17 @@ my-project/
|
|
|
44
42
|
2. **Agents** handle specialized tasks:
|
|
45
43
|
- `planner` - Strategic planning and task breakdown
|
|
46
44
|
- `checker` - Quality assurance and code review
|
|
47
|
-
- `backend` -
|
|
48
|
-
- `frontend` -
|
|
45
|
+
- `backend` - Backend architecture and API design
|
|
46
|
+
- `frontend` - Frontend architecture and UI design
|
|
49
47
|
3. **Skills** automate common workflows:
|
|
50
48
|
- `/commit` - Conventional commits
|
|
51
49
|
- `/create-pr` - Structured pull requests
|
|
52
50
|
- `/create-ticket` - Task ticket creation
|
|
53
51
|
- `/design-feature` - Feature design phases
|
|
52
|
+
- `/skill-creator` - Create new skills
|
|
53
|
+
- `/update-claude-md` - Update CLAUDE.md sections
|
|
54
54
|
4. **Tickets** track tasks with status emojis
|
|
55
55
|
|
|
56
|
-
### Agent Orchestration Workflows
|
|
57
|
-
|
|
58
|
-
Pre-configured workflows that coordinate agents:
|
|
59
|
-
|
|
60
|
-
| Workflow | Flow |
|
|
61
|
-
|----------|------|
|
|
62
|
-
| Feature Development | Planner → Backend/Frontend → Checker |
|
|
63
|
-
| Bug Fix | Planner → Backend/Frontend → Checker |
|
|
64
|
-
| API Development | Planner → Backend → Frontend → Checker |
|
|
65
|
-
| UI Components | Planner → Frontend → Checker |
|
|
66
|
-
| Quality Assurance | Planner → Checker → Fix → Checker |
|
|
67
|
-
|
|
68
|
-
See `claude/docs/agent-orchestration.md` for detailed workflow documentation.
|
|
69
|
-
|
|
70
56
|
## Command Line Options
|
|
71
57
|
|
|
72
58
|
```bash
|
|
@@ -86,10 +72,47 @@ Examples:
|
|
|
86
72
|
ccstart --agents # Preview available agents
|
|
87
73
|
```
|
|
88
74
|
|
|
75
|
+
## Interactive Setup
|
|
76
|
+
|
|
77
|
+
When you run `ccstart`, you'll be guided through three selection prompts:
|
|
78
|
+
|
|
79
|
+
### Agent Selection
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
? Choose your agents: (Press <space> to select, <a> to toggle all)
|
|
83
|
+
❯◯ planner
|
|
84
|
+
Strategic planning and task breakdown specialist
|
|
85
|
+
◯ checker
|
|
86
|
+
Quality assurance and code review specialist
|
|
87
|
+
◯ backend
|
|
88
|
+
Backend architecture and API design specialist
|
|
89
|
+
◯ frontend
|
|
90
|
+
Frontend architecture and UI design specialist
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Skill Selection
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
? Choose your skills: (Press <space> to select, <a> to toggle all)
|
|
97
|
+
❯◯ commit
|
|
98
|
+
Generate and execute git commits following conventional commit format
|
|
99
|
+
◯ create-pr
|
|
100
|
+
Create GitHub pull requests with properly structured descriptions
|
|
101
|
+
◯ create-ticket
|
|
102
|
+
Create task tickets with proper numbering and update ticket-list.md
|
|
103
|
+
◯ design-feature
|
|
104
|
+
Guide feature development through requirements and design phases
|
|
105
|
+
◯ skill-creator
|
|
106
|
+
Guide for creating new skills
|
|
107
|
+
◯ update-claude-md
|
|
108
|
+
Update CLAUDE.md sections through interactive Q&A
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Use `--all-agents` to skip agent selection and include all agents.
|
|
112
|
+
|
|
89
113
|
## Key Features
|
|
90
114
|
|
|
91
|
-
- **Interactive Agent Selection** - Choose which agents to include during setup
|
|
92
|
-
- **Agent Orchestration Workflows** - Pre-defined workflows that coordinate multiple agents
|
|
115
|
+
- **Interactive Agent & Skill Selection** - Choose which agents and skills to include during setup
|
|
93
116
|
- **Smart Conflict Resolution** - Handle existing files with skip/rename/overwrite options
|
|
94
117
|
- **Auto-detects Claude Code** - Creates .claude directory structure automatically
|
|
95
118
|
- **Dry Run Mode** - Preview changes before applying them
|
|
@@ -122,7 +145,7 @@ npm unlink -g ccstart
|
|
|
122
145
|
|
|
123
146
|
## Credits
|
|
124
147
|
|
|
125
|
-
Born from our discussions in TechOverflow with [vichannnnn](https://github.com/vichannnnn)
|
|
148
|
+
Born from our discussions in TechOverflow with [vichannnnn](https://github.com/vichannnnn) and [MrMarciaOng](https://github.com/MrMarciaOng).
|
|
126
149
|
|
|
127
150
|
## License
|
|
128
151
|
|