cc-devflow 1.0.1 → 1.0.3
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/.claude/agents/architecture-designer.md +7 -7
- package/.claude/agents/bug-analyzer.md +7 -7
- package/.claude/agents/code-reviewer.md +5 -5
- package/.claude/agents/compatibility-checker.md +7 -7
- package/.claude/agents/consistency-checker.md +6 -6
- package/.claude/agents/impact-analyzer.md +7 -7
- package/.claude/agents/planner.md +7 -7
- package/.claude/agents/prd-writer.md +15 -15
- package/.claude/agents/project-guidelines-generator.md +13 -13
- package/.claude/agents/qa-tester.md +11 -11
- package/.claude/agents/release-manager.md +14 -14
- package/.claude/agents/security-reviewer.md +12 -12
- package/.claude/agents/style-guide-generator.md +1 -1
- package/.claude/agents/tech-architect.md +10 -10
- package/.claude/agents/ui-designer.md +12 -12
- package/.claude/commands/flow-constitution.md +1 -1
- package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +1 -1
- package/.claude/docs/templates/EPIC_TEMPLATE.md +3 -3
- package/.claude/docs/templates/PRD_TEMPLATE.md +1 -1
- package/.claude/docs/templates/TASKS_TEMPLATE.md +4 -4
- package/.claude/guides/workflow-guides/flow-orchestrator.md +10 -10
- package/.claude/scripts/check-task-status.sh +33 -9
- package/.claude/scripts/manage-constitution.sh +2 -2
- package/.claude/scripts/validate-constitution.sh +1 -1
- package/.claude/skills/cc-devflow-orchestrator/SKILL.md +1 -1
- package/.claude/skills/constitution-guardian/SKILL.md +3 -3
- package/.claude/skills/devflow-constitution-quick-ref/SKILL.md +11 -11
- package/.claude/skills/skill-rules.json +1 -1
- package/.claude/tests/constitution/test_agent_assignment.sh +1 -1
- package/.claude/tests/constitution/test_article_coverage.sh +1 -1
- package/.claude/tests/constitution/test_template_completeness.sh +4 -4
- package/.claude/tests/constitution/test_version_consistency.sh +3 -3
- package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/affected-repos.txt +1 -0
- package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/edited-files.log +2 -0
- package/README.md +27 -6
- package/README.zh-CN.md +27 -6
- package/package.json +2 -2
|
@@ -102,7 +102,7 @@ Detected:
|
|
|
102
102
|
📋 ACTION:
|
|
103
103
|
1. Complete all TODOs/FIXMEs before saving
|
|
104
104
|
2. Move secrets to environment variables (.env, not committed)
|
|
105
|
-
3. Review
|
|
105
|
+
3. Review `.claude/rules/project-constitution.md` v2.0.0
|
|
106
106
|
4. Run /flow-verify for comprehensive check
|
|
107
107
|
|
|
108
108
|
Source: Constitution Articles I.1, III.1
|
|
@@ -198,7 +198,7 @@ Users can bypass Constitution guardian in specific scenarios:
|
|
|
198
198
|
- Double insurance: Guardrail catches most issues, Script catches remaining
|
|
199
199
|
|
|
200
200
|
### Constitution Document
|
|
201
|
-
- **Source of Truth**: `.claude/
|
|
201
|
+
- **Source of Truth**: `.claude/rules/project-constitution.md` v2.0.0
|
|
202
202
|
- **Contains**: All 10 Articles with detailed rules
|
|
203
203
|
- **This guardrail**: Extracts Articles I.1, III.1 prohibition rules only
|
|
204
204
|
|
|
@@ -236,7 +236,7 @@ In `.claude/skills/skill-rules.json`:
|
|
|
236
236
|
"password:\\s*['\"][^'\"]+['\"]"
|
|
237
237
|
]
|
|
238
238
|
},
|
|
239
|
-
"blockMessage": "⚠️ BLOCKED - Constitution Violation\n\nDetected:\n- Partial implementation (Article I.1)\n- Hardcoded secrets (Article III.1)\n\n📋 ACTION:\n1. Complete all TODOs/FIXMEs\n2. Move secrets to config system\n3. Run /flow-verify\n\nSource: .claude/
|
|
239
|
+
"blockMessage": "⚠️ BLOCKED - Constitution Violation\n\nDetected:\n- Partial implementation (Article I.1)\n- Hardcoded secrets (Article III.1)\n\n📋 ACTION:\n1. Complete all TODOs/FIXMEs\n2. Move secrets to config system\n3. Run /flow-verify\n\nSource: .claude/rules/project-constitution.md v2.0.0",
|
|
240
240
|
"skipConditions": {
|
|
241
241
|
"sessionSkillUsed": true,
|
|
242
242
|
"fileMarkers": ["@constitution-verified"],
|
|
@@ -8,7 +8,7 @@ description: Quick reference guide to CC-DevFlow Constitution v2.0.0 with links
|
|
|
8
8
|
## Purpose
|
|
9
9
|
Provide quick summaries of all 10 Constitutional Articles with links to full Constitution document. This skill does NOT duplicate the complete Constitution text.
|
|
10
10
|
|
|
11
|
-
**Full Constitution**:
|
|
11
|
+
**Full Constitution**: `.claude/rules/project-constitution.md` v2.0.0
|
|
12
12
|
|
|
13
13
|
## Constitution Overview
|
|
14
14
|
|
|
@@ -40,7 +40,7 @@ Quality is the non-negotiable baseline.
|
|
|
40
40
|
❌ "defer to v2"
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
**For Details**: See
|
|
43
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-i-quality-first-质量至上`
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
@@ -66,7 +66,7 @@ Maintain codebase uniformity and predictability.
|
|
|
66
66
|
❌ 800-line file // Exceeds limit
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
**For Details**: See
|
|
69
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-ii-architectural-consistency-架构一致性`
|
|
70
70
|
|
|
71
71
|
---
|
|
72
72
|
|
|
@@ -92,7 +92,7 @@ Security is foundational, not an afterthought.
|
|
|
92
92
|
❌ const PASSWORD = "admin123" // Hardcoded
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
**For Details**: See
|
|
95
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-iii-security-first-安全优先`
|
|
96
96
|
|
|
97
97
|
---
|
|
98
98
|
|
|
@@ -118,7 +118,7 @@ Performance is user experience; proactive optimization required.
|
|
|
118
118
|
❌ no connection.close() // Resource leak
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
**For Details**: See
|
|
121
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-iv-performance-accountability-性能责任`
|
|
122
122
|
|
|
123
123
|
---
|
|
124
124
|
|
|
@@ -144,7 +144,7 @@ Code must be understandable, modifiable, and extensible.
|
|
|
144
144
|
❌ 800-line function // Exceeds limit
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
**For Details**: See
|
|
147
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-v-maintainability-可维护性`
|
|
148
148
|
|
|
149
149
|
---
|
|
150
150
|
|
|
@@ -173,7 +173,7 @@ Phase 3: Write Implementation
|
|
|
173
173
|
→ Goal: Make tests pass
|
|
174
174
|
```
|
|
175
175
|
|
|
176
|
-
**For Details**: See
|
|
176
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-vi-test-first-development-测试优先开发`
|
|
177
177
|
|
|
178
178
|
---
|
|
179
179
|
|
|
@@ -199,7 +199,7 @@ Default to simplicity; complexity requires justification.
|
|
|
199
199
|
❌ Custom ORM wrapper # Unnecessary abstraction
|
|
200
200
|
```
|
|
201
201
|
|
|
202
|
-
**For Details**: See
|
|
202
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-vii-simplicity-gate-简单性闸门`
|
|
203
203
|
|
|
204
204
|
---
|
|
205
205
|
|
|
@@ -225,7 +225,7 @@ Prefer concrete code over abstractions until three+ use cases proven.
|
|
|
225
225
|
❌ Custom framework wrapper // Over-abstraction
|
|
226
226
|
```
|
|
227
227
|
|
|
228
|
-
**For Details**: See
|
|
228
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-viii-anti-abstraction-反抽象化`
|
|
229
229
|
|
|
230
230
|
---
|
|
231
231
|
|
|
@@ -253,7 +253,7 @@ Test contracts/integrations before internal logic.
|
|
|
253
253
|
4. Unit tests (internal logic)
|
|
254
254
|
```
|
|
255
255
|
|
|
256
|
-
**For Details**: See
|
|
256
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-ix-integration-first-testing-集成优先测试`
|
|
257
257
|
|
|
258
258
|
---
|
|
259
259
|
|
|
@@ -279,7 +279,7 @@ Prevent scope creep; enforce strict requirement boundaries.
|
|
|
279
279
|
❌ Adding unplanned features during /flow-dev # Feature expansion
|
|
280
280
|
```
|
|
281
281
|
|
|
282
|
-
**For Details**: See
|
|
282
|
+
**For Details**: See `.claude/rules/project-constitution.md#article-x-requirement-boundary-需求边界`
|
|
283
283
|
|
|
284
284
|
---
|
|
285
285
|
|
|
@@ -120,7 +120,7 @@
|
|
|
120
120
|
"secret:\\s*['\"][^'\"]+['\"]"
|
|
121
121
|
]
|
|
122
122
|
},
|
|
123
|
-
"blockMessage": "⚠️ BLOCKED - Constitution Violation\n\nDetected:\n- Partial implementation (Article I.1 - NO PARTIAL IMPLEMENTATION)\n- OR Hardcoded secrets (Article III.1 - NO HARDCODED SECRETS)\n\n📋 ACTION:\n1. Complete all TODOs/FIXMEs before saving\n2. Move secrets to environment variables (.env, not committed)\n3. Review .claude/
|
|
123
|
+
"blockMessage": "⚠️ BLOCKED - Constitution Violation\n\nDetected:\n- Partial implementation (Article I.1 - NO PARTIAL IMPLEMENTATION)\n- OR Hardcoded secrets (Article III.1 - NO HARDCODED SECRETS)\n\n📋 ACTION:\n1. Complete all TODOs/FIXMEs before saving\n2. Move secrets to environment variables (.env, not committed)\n3. Review .claude/rules/project-constitution.md v2.0.0\n4. Run /flow-verify for comprehensive check\n\nSource: Constitution Articles I.1, III.1\nFile: {file_path}\n\n💡 SKIP: Add `@constitution-verified` comment or set SKIP_CONSTITUTION_CHECK=1",
|
|
124
124
|
"skipConditions": {
|
|
125
125
|
"sessionSkillUsed": true,
|
|
126
126
|
"fileMarkers": [
|
|
@@ -140,7 +140,7 @@ test_all_agents_reference_constitution() {
|
|
|
140
140
|
}
|
|
141
141
|
|
|
142
142
|
test_agents_reference_current_version() {
|
|
143
|
-
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/
|
|
143
|
+
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/rules/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
|
|
144
144
|
|
|
145
145
|
local agents=(
|
|
146
146
|
"$REPO_ROOT/.claude/agents/prd-writer.md"
|
|
@@ -161,7 +161,7 @@ test_article_X_has_enforcement_points() {
|
|
|
161
161
|
}
|
|
162
162
|
|
|
163
163
|
test_all_articles_documented_in_constitution() {
|
|
164
|
-
local constitution="$REPO_ROOT/.claude/
|
|
164
|
+
local constitution="$REPO_ROOT/.claude/rules/project-constitution.md"
|
|
165
165
|
|
|
166
166
|
for article in I II III IV V VI VII VIII IX X; do
|
|
167
167
|
assert_file_contains "$constitution" "## Article $article:" "Constitution should document Article $article"
|
|
@@ -26,7 +26,7 @@ test_prd_template_has_constitution_check() {
|
|
|
26
26
|
|
|
27
27
|
assert_file_exists "$template" "PRD_TEMPLATE.md should exist"
|
|
28
28
|
assert_file_contains "$template" "## Constitution Check" "PRD template should have Constitution Check section"
|
|
29
|
-
assert_file_contains "$template" ".claude/
|
|
29
|
+
assert_file_contains "$template" ".claude/rules/project-constitution.md" "PRD template should reference Constitution file"
|
|
30
30
|
}
|
|
31
31
|
|
|
32
32
|
test_epic_template_has_constitution_check() {
|
|
@@ -34,7 +34,7 @@ test_epic_template_has_constitution_check() {
|
|
|
34
34
|
|
|
35
35
|
assert_file_exists "$template" "EPIC_TEMPLATE.md should exist"
|
|
36
36
|
assert_file_contains "$template" "## Constitution Check" "EPIC template should have Constitution Check section"
|
|
37
|
-
assert_file_contains "$template" ".claude/
|
|
37
|
+
assert_file_contains "$template" ".claude/rules/project-constitution.md" "EPIC template should reference Constitution file"
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
test_tasks_template_has_constitution_alignment() {
|
|
@@ -42,7 +42,7 @@ test_tasks_template_has_constitution_alignment() {
|
|
|
42
42
|
|
|
43
43
|
assert_file_exists "$template" "TASKS_TEMPLATE.md should exist"
|
|
44
44
|
assert_file_contains "$template" "Constitution Alignment|Constitution Compliance" "TASKS template should have Constitution section"
|
|
45
|
-
assert_file_contains "$template" ".claude/
|
|
45
|
+
assert_file_contains "$template" ".claude/rules/project-constitution.md" "TASKS template should reference Constitution file"
|
|
46
46
|
}
|
|
47
47
|
|
|
48
48
|
test_prd_template_has_article_references() {
|
|
@@ -81,7 +81,7 @@ test_epic_template_has_complexity_tracking() {
|
|
|
81
81
|
}
|
|
82
82
|
|
|
83
83
|
test_all_templates_reference_current_version() {
|
|
84
|
-
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/
|
|
84
|
+
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/rules/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
|
|
85
85
|
|
|
86
86
|
local templates=(
|
|
87
87
|
"$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
|
|
@@ -22,7 +22,7 @@ fi
|
|
|
22
22
|
# ============================================================================
|
|
23
23
|
|
|
24
24
|
test_constitution_version_readable() {
|
|
25
|
-
local constitution_file="$REPO_ROOT/.claude/
|
|
25
|
+
local constitution_file="$REPO_ROOT/.claude/rules/project-constitution.md"
|
|
26
26
|
|
|
27
27
|
assert_file_exists "$constitution_file" "Constitution file should exist"
|
|
28
28
|
|
|
@@ -61,7 +61,7 @@ test_all_templates_reference_same_version() {
|
|
|
61
61
|
}
|
|
62
62
|
|
|
63
63
|
test_all_agents_reference_same_version() {
|
|
64
|
-
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/
|
|
64
|
+
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/rules/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
|
|
65
65
|
|
|
66
66
|
local agents_dir="$REPO_ROOT/.claude/agents"
|
|
67
67
|
local inconsistent_count=0
|
|
@@ -81,7 +81,7 @@ test_all_agents_reference_same_version() {
|
|
|
81
81
|
}
|
|
82
82
|
|
|
83
83
|
test_claude_md_references_current_version() {
|
|
84
|
-
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/
|
|
84
|
+
local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/rules/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
|
|
85
85
|
|
|
86
86
|
local claude_md="$REPO_ROOT/CLAUDE.md"
|
|
87
87
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
root
|
package/README.md
CHANGED
|
@@ -123,21 +123,42 @@ Dual-layer execution model: Research Agents (11, read-only analysis) + Main Agen
|
|
|
123
123
|
|
|
124
124
|
### Installation
|
|
125
125
|
|
|
126
|
-
|
|
127
|
-
pnpm dlx tiged Dimon94/cc-devflow/.claude .claude
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
### CLI (Global Install, Multi-Platform)
|
|
126
|
+
#### Method 1: Install from npm (Recommended)
|
|
131
127
|
|
|
132
128
|
```bash
|
|
129
|
+
# Install globally
|
|
130
|
+
npm install -g cc-devflow
|
|
131
|
+
# or
|
|
133
132
|
pnpm add -g cc-devflow
|
|
133
|
+
|
|
134
|
+
# Initialize in your project
|
|
134
135
|
cc-devflow init
|
|
136
|
+
|
|
137
|
+
# Compile for specific platform (optional)
|
|
135
138
|
cc-devflow adapt --platform cursor
|
|
139
|
+
cc-devflow adapt --platform codex
|
|
140
|
+
cc-devflow adapt --platform antigravity
|
|
141
|
+
cc-devflow adapt --platform qwen
|
|
136
142
|
```
|
|
137
143
|
|
|
144
|
+
#### Method 2: Manual Installation
|
|
145
|
+
|
|
138
146
|
```bash
|
|
147
|
+
pnpm dlx tiged Dimon94/cc-devflow/.claude .claude
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### CLI Usage
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
# Initialize in current directory
|
|
154
|
+
cc-devflow init
|
|
155
|
+
|
|
156
|
+
# Initialize in specific directory
|
|
139
157
|
cc-devflow init --dir /path/to/project
|
|
140
|
-
|
|
158
|
+
|
|
159
|
+
# Compile for specific platform
|
|
160
|
+
cc-devflow adapt --platform codex
|
|
161
|
+
cc-devflow adapt --cwd /path/to/project --platform cursor
|
|
141
162
|
```
|
|
142
163
|
|
|
143
164
|
### Optional Dependencies
|
package/README.zh-CN.md
CHANGED
|
@@ -123,21 +123,42 @@ export SKIP_TDD_ENFORCER=1
|
|
|
123
123
|
|
|
124
124
|
### 安装
|
|
125
125
|
|
|
126
|
-
|
|
127
|
-
pnpm dlx tiged Dimon94/cc-devflow/.claude .claude
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
### CLI(全局安装,多平台)
|
|
126
|
+
#### 方式 1: 从 npm 安装(推荐)
|
|
131
127
|
|
|
132
128
|
```bash
|
|
129
|
+
# 全局安装
|
|
130
|
+
npm install -g cc-devflow
|
|
131
|
+
# 或
|
|
133
132
|
pnpm add -g cc-devflow
|
|
133
|
+
|
|
134
|
+
# 在项目中初始化
|
|
134
135
|
cc-devflow init
|
|
136
|
+
|
|
137
|
+
# 编译到特定平台(可选)
|
|
135
138
|
cc-devflow adapt --platform cursor
|
|
139
|
+
cc-devflow adapt --platform codex
|
|
140
|
+
cc-devflow adapt --platform antigravity
|
|
141
|
+
cc-devflow adapt --platform qwen
|
|
136
142
|
```
|
|
137
143
|
|
|
144
|
+
#### 方式 2: 手动安装
|
|
145
|
+
|
|
138
146
|
```bash
|
|
147
|
+
pnpm dlx tiged Dimon94/cc-devflow/.claude .claude
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### CLI 使用
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
# 在当前目录初始化
|
|
154
|
+
cc-devflow init
|
|
155
|
+
|
|
156
|
+
# 在指定目录初始化
|
|
139
157
|
cc-devflow init --dir /path/to/project
|
|
140
|
-
|
|
158
|
+
|
|
159
|
+
# 编译到特定平台
|
|
160
|
+
cc-devflow adapt --platform codex
|
|
161
|
+
cc-devflow adapt --cwd /path/to/project --platform cursor
|
|
141
162
|
```
|
|
142
163
|
|
|
143
164
|
### 验证安装
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cc-devflow",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.3",
|
|
4
4
|
"description": "DevFlow CLI tool",
|
|
5
5
|
"main": "bin/cc-devflow.js",
|
|
6
6
|
"bin": {
|
|
@@ -36,8 +36,8 @@
|
|
|
36
36
|
"adapt:antigravity": "node bin/adapt.js --platform antigravity"
|
|
37
37
|
},
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"gray-matter": "^4.0.3",
|
|
40
39
|
"@iarna/toml": "^2.2.5",
|
|
40
|
+
"gray-matter": "^4.0.3",
|
|
41
41
|
"js-yaml": "^4.1.0",
|
|
42
42
|
"zod": "^3.22.4"
|
|
43
43
|
},
|