@champpaba/claude-agent-kit 3.0.2 → 3.2.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/.claude/CHANGELOG.md +707 -0
- package/.claude/CLAUDE.md +128 -613
- package/.claude/agents/_shared/pre-work-checklist.md +108 -7
- package/.claude/commands/cdev.md +36 -0
- package/.claude/commands/csetup.md +292 -1791
- package/.claude/commands/cview.md +364 -364
- package/.claude/contexts/design/accessibility.md +611 -611
- package/.claude/contexts/design/layout.md +400 -400
- package/.claude/contexts/design/responsive.md +551 -551
- package/.claude/contexts/design/shadows.md +522 -522
- package/.claude/contexts/design/typography.md +465 -465
- package/.claude/contexts/domain/README.md +164 -164
- package/.claude/contexts/patterns/agent-coordination.md +388 -388
- package/.claude/contexts/patterns/development-principles.md +513 -513
- package/.claude/contexts/patterns/error-handling.md +478 -478
- package/.claude/contexts/patterns/logging.md +424 -424
- package/.claude/contexts/patterns/tdd-classification.md +516 -516
- package/.claude/contexts/patterns/testing.md +413 -413
- package/.claude/lib/README.md +3 -3
- package/.claude/lib/detailed-guides/taskmaster-analysis.md +1 -1
- package/.claude/lib/task-analyzer.md +144 -0
- package/.claude/lib/tdd-workflow.md +2 -1
- package/.claude/lib/validation-gates.md +484 -484
- package/.claude/settings.local.json +42 -42
- package/.claude/templates/PROJECT_STATUS.template.yml +16 -41
- package/.claude/templates/context-template.md +45 -45
- package/.claude/templates/flags-template.json +42 -42
- package/.claude/templates/phases-sections/accessibility-test.md +17 -17
- package/.claude/templates/phases-sections/api-design.md +37 -37
- package/.claude/templates/phases-sections/backend-tests.md +16 -16
- package/.claude/templates/phases-sections/backend.md +37 -37
- package/.claude/templates/phases-sections/business-logic-validation.md +16 -16
- package/.claude/templates/phases-sections/component-tests.md +17 -17
- package/.claude/templates/phases-sections/contract-backend.md +16 -16
- package/.claude/templates/phases-sections/contract-frontend.md +16 -16
- package/.claude/templates/phases-sections/database.md +35 -35
- package/.claude/templates/phases-sections/e2e-tests.md +16 -16
- package/.claude/templates/phases-sections/fix-implementation.md +17 -17
- package/.claude/templates/phases-sections/frontend-integration.md +18 -18
- package/.claude/templates/phases-sections/manual-flow-test.md +15 -15
- package/.claude/templates/phases-sections/manual-ux-test.md +16 -16
- package/.claude/templates/phases-sections/refactor-implementation.md +17 -17
- package/.claude/templates/phases-sections/refactor.md +16 -16
- package/.claude/templates/phases-sections/regression-tests.md +15 -15
- package/.claude/templates/phases-sections/responsive-test.md +16 -16
- package/.claude/templates/phases-sections/script-implementation.md +43 -43
- package/.claude/templates/phases-sections/test-coverage.md +16 -16
- package/.claude/templates/phases-sections/user-approval.md +14 -14
- package/LICENSE +21 -21
- package/package.json +1 -1
- package/.claude/lib/tdd-classifier.md +0 -345
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
{
|
|
2
|
-
"permissions": {
|
|
3
|
-
"allow": [
|
|
4
|
-
"Bash(git add:*)",
|
|
5
|
-
"Bash(env)",
|
|
6
|
-
"Bash(npx:*)",
|
|
7
|
-
"mcp__context7__resolve-library-id",
|
|
8
|
-
"mcp__context7__get-library-docs",
|
|
9
|
-
"Bash(where:*)",
|
|
10
|
-
"Bash(claude mcp add chrome-devtools npx chrome-devtools-mcp@latest)",
|
|
11
|
-
"Read(//c/Users/User/**)",
|
|
12
|
-
"Bash(cat:*)",
|
|
13
|
-
"Bash(tasklist:*)",
|
|
14
|
-
"Bash(start chrome:*)",
|
|
15
|
-
"Bash(curl:*)",
|
|
16
|
-
"mcp__chrome-devtools__list_pages",
|
|
17
|
-
"mcp__chrome-devtools__new_page",
|
|
18
|
-
"Bash(taskkill:*)",
|
|
19
|
-
"mcp__chrome-devtools__take_snapshot",
|
|
20
|
-
"mcp__chrome-devtools__navigate_page",
|
|
21
|
-
"mcp__chrome-devtools__fill",
|
|
22
|
-
"mcp__chrome-devtools__click",
|
|
23
|
-
"mcp__chrome-devtools__take_screenshot",
|
|
24
|
-
"Bash(/agents uxui-frontend)",
|
|
25
|
-
"WebFetch(domain:github.com)",
|
|
26
|
-
"WebFetch(domain:raw.githubusercontent.com)",
|
|
27
|
-
"Bash(git -C \"E:\\project\\claude-multi-agent-template\" status)",
|
|
28
|
-
"Bash(npm init:*)",
|
|
29
|
-
"Bash(npm install:*)",
|
|
30
|
-
"Bash(npm run build:*)",
|
|
31
|
-
"Bash(find:*)",
|
|
32
|
-
"Bash(npm test:*)",
|
|
33
|
-
"Bash(npm run dev:*)",
|
|
34
|
-
"Bash(git commit:*)",
|
|
35
|
-
"Bash(git config:*)",
|
|
36
|
-
"Bash(git push:*)",
|
|
37
|
-
"Bash(git log:*)"
|
|
38
|
-
],
|
|
39
|
-
"deny": [],
|
|
40
|
-
"ask": []
|
|
41
|
-
}
|
|
42
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"permissions": {
|
|
3
|
+
"allow": [
|
|
4
|
+
"Bash(git add:*)",
|
|
5
|
+
"Bash(env)",
|
|
6
|
+
"Bash(npx:*)",
|
|
7
|
+
"mcp__context7__resolve-library-id",
|
|
8
|
+
"mcp__context7__get-library-docs",
|
|
9
|
+
"Bash(where:*)",
|
|
10
|
+
"Bash(claude mcp add chrome-devtools npx chrome-devtools-mcp@latest)",
|
|
11
|
+
"Read(//c/Users/User/**)",
|
|
12
|
+
"Bash(cat:*)",
|
|
13
|
+
"Bash(tasklist:*)",
|
|
14
|
+
"Bash(start chrome:*)",
|
|
15
|
+
"Bash(curl:*)",
|
|
16
|
+
"mcp__chrome-devtools__list_pages",
|
|
17
|
+
"mcp__chrome-devtools__new_page",
|
|
18
|
+
"Bash(taskkill:*)",
|
|
19
|
+
"mcp__chrome-devtools__take_snapshot",
|
|
20
|
+
"mcp__chrome-devtools__navigate_page",
|
|
21
|
+
"mcp__chrome-devtools__fill",
|
|
22
|
+
"mcp__chrome-devtools__click",
|
|
23
|
+
"mcp__chrome-devtools__take_screenshot",
|
|
24
|
+
"Bash(/agents uxui-frontend)",
|
|
25
|
+
"WebFetch(domain:github.com)",
|
|
26
|
+
"WebFetch(domain:raw.githubusercontent.com)",
|
|
27
|
+
"Bash(git -C \"E:\\project\\claude-multi-agent-template\" status)",
|
|
28
|
+
"Bash(npm init:*)",
|
|
29
|
+
"Bash(npm install:*)",
|
|
30
|
+
"Bash(npm run build:*)",
|
|
31
|
+
"Bash(find:*)",
|
|
32
|
+
"Bash(npm test:*)",
|
|
33
|
+
"Bash(npm run dev:*)",
|
|
34
|
+
"Bash(git commit:*)",
|
|
35
|
+
"Bash(git config:*)",
|
|
36
|
+
"Bash(git push:*)",
|
|
37
|
+
"Bash(git log:*)"
|
|
38
|
+
],
|
|
39
|
+
"deny": [],
|
|
40
|
+
"ask": []
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -6,6 +6,11 @@
|
|
|
6
6
|
# - New Claude sessions lose context about infrastructure state, blockers, and priorities
|
|
7
7
|
# - Reading multiple files (README, archived proposals, tasks.md) wastes tokens
|
|
8
8
|
# - This single file provides quick context snapshot for AI sessions
|
|
9
|
+
#
|
|
10
|
+
# v2.2.0 (claude-mem integration):
|
|
11
|
+
# - REMOVED: decisions, notes, future_ideas → claude-mem handles automatically
|
|
12
|
+
# - KEPT: blockers, priorities, technical_debt → requires human decision
|
|
13
|
+
# - Query past decisions: ask Claude "what decisions about X?" → mem-search auto-invoked
|
|
9
14
|
|
|
10
15
|
last_updated: "YYYY-MM-DD"
|
|
11
16
|
|
|
@@ -104,21 +109,6 @@ next_priorities: []
|
|
|
104
109
|
# - id: user-profile
|
|
105
110
|
# reason: "Dependency for RIASEC save feature"
|
|
106
111
|
|
|
107
|
-
# -------------------------------------------------------------------
|
|
108
|
-
# FUTURE IDEAS
|
|
109
|
-
# Features/enhancements discussed but not yet planned
|
|
110
|
-
# Captured from: "อยากให้มี...", "want to add...", "later...", "in the future..."
|
|
111
|
-
# -------------------------------------------------------------------
|
|
112
|
-
future_ideas: []
|
|
113
|
-
# Example:
|
|
114
|
-
# - idea: "Dark mode support"
|
|
115
|
-
# context: "User requested during review"
|
|
116
|
-
# date: "2025-12-01"
|
|
117
|
-
#
|
|
118
|
-
# - idea: "Export to PDF"
|
|
119
|
-
# context: "Nice to have for reports"
|
|
120
|
-
# date: "2025-11-28"
|
|
121
|
-
|
|
122
112
|
# -------------------------------------------------------------------
|
|
123
113
|
# TECHNICAL DEBT
|
|
124
114
|
# Known issues to fix later
|
|
@@ -134,32 +124,6 @@ technical_debt: []
|
|
|
134
124
|
# reason: "Currently crashes on API errors"
|
|
135
125
|
# priority: high
|
|
136
126
|
|
|
137
|
-
# -------------------------------------------------------------------
|
|
138
|
-
# DECISIONS
|
|
139
|
-
# Important technical/product decisions made
|
|
140
|
-
# Captured from: "ตัดสินใจว่า...", "we decided...", "going with...", "chose X over Y"
|
|
141
|
-
# -------------------------------------------------------------------
|
|
142
|
-
decisions: []
|
|
143
|
-
# Example:
|
|
144
|
-
# - decision: "Use better-auth over NextAuth"
|
|
145
|
-
# reason: "Better TypeScript support, simpler API"
|
|
146
|
-
# date: "2025-12-01"
|
|
147
|
-
#
|
|
148
|
-
# - decision: "PostgreSQL over MongoDB"
|
|
149
|
-
# reason: "Relational data, ACID compliance needed"
|
|
150
|
-
# date: "2025-11-30"
|
|
151
|
-
|
|
152
|
-
# -------------------------------------------------------------------
|
|
153
|
-
# NOTES
|
|
154
|
-
# Free-form context that doesn't fit above
|
|
155
|
-
# -------------------------------------------------------------------
|
|
156
|
-
notes: |
|
|
157
|
-
Add any additional context here.
|
|
158
|
-
Examples:
|
|
159
|
-
- Dev server running on localhost:3000
|
|
160
|
-
- Test with: curl http://localhost:3000/health
|
|
161
|
-
- Staging environment: https://staging.example.com
|
|
162
|
-
|
|
163
127
|
# -------------------------------------------------------------------
|
|
164
128
|
# REFERENCES (optional)
|
|
165
129
|
# Quick links to important project files
|
|
@@ -168,3 +132,14 @@ references:
|
|
|
168
132
|
# roadmap: "docs/proposal_list.md"
|
|
169
133
|
# architecture: "openspec/specs/architecture.md"
|
|
170
134
|
# design_tokens: "design-system/data.yaml"
|
|
135
|
+
|
|
136
|
+
# -------------------------------------------------------------------
|
|
137
|
+
# QUERYING PAST CONTEXT (claude-mem)
|
|
138
|
+
# -------------------------------------------------------------------
|
|
139
|
+
# These fields were REMOVED because claude-mem handles them automatically:
|
|
140
|
+
# - decisions → Query: "what decisions about X?"
|
|
141
|
+
# - notes/learnings → Query: "what did we learn about X?"
|
|
142
|
+
# - future_ideas → Query: "what ideas for X?"
|
|
143
|
+
#
|
|
144
|
+
# claude-mem auto-captures observations from tool usage.
|
|
145
|
+
# Just ask naturally - mem-search skill is auto-invoked.
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# Agent Context: {CHANGE_ID} {CHANGE_TITLE}
|
|
2
|
-
|
|
3
|
-
## Change Info
|
|
4
|
-
- **ID:** {CHANGE_ID}
|
|
5
|
-
- **Type:** {CHANGE_TYPE}
|
|
6
|
-
- **Status:** Phase {CURRENT_PHASE_NUMBER}/{TOTAL_PHASES}
|
|
7
|
-
- **Created:** {CREATED_DATE}
|
|
8
|
-
|
|
9
|
-
## References
|
|
10
|
-
**IMPORTANT:** Agents MUST read these before starting work!
|
|
11
|
-
|
|
12
|
-
- **Proposal:** [../proposal.md](../proposal.md) - Business requirements and scope
|
|
13
|
-
- **Tasks:** [../tasks.md](../tasks.md) - Implementation checklist
|
|
14
|
-
- **Design:** [../design.md](../design.md) - Technical decisions (if exists)
|
|
15
|
-
- **Specs:** ../specs/ - Delta requirements
|
|
16
|
-
|
|
17
|
-
## Tech Stack
|
|
18
|
-
|
|
19
|
-
### Core (from project-level)
|
|
20
|
-
Reference: `@/.claude/contexts/domain/project/best-practices/`
|
|
21
|
-
|
|
22
|
-
{CORE_TECH_LIST}
|
|
23
|
-
|
|
24
|
-
### Additional (Change-specific)
|
|
25
|
-
**New tech for this Change only:**
|
|
26
|
-
|
|
27
|
-
{ADDITIONAL_TECH_LIST}
|
|
28
|
-
|
|
29
|
-
## Change-Specific Patterns
|
|
30
|
-
|
|
31
|
-
{CHANGE_SPECIFIC_PATTERNS}
|
|
32
|
-
|
|
33
|
-
## Agent Instructions per Phase
|
|
34
|
-
|
|
35
|
-
{AGENT_INSTRUCTIONS}
|
|
36
|
-
|
|
37
|
-
## Phase Tracking
|
|
38
|
-
**Current phase:** {CURRENT_PHASE}
|
|
39
|
-
|
|
40
|
-
See `flags.json` for detailed tracking.
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
**Last updated:** {UPDATED_DATE}
|
|
45
|
-
**Phase:** {CURRENT_PHASE} ({STATUS})
|
|
1
|
+
# Agent Context: {CHANGE_ID} {CHANGE_TITLE}
|
|
2
|
+
|
|
3
|
+
## Change Info
|
|
4
|
+
- **ID:** {CHANGE_ID}
|
|
5
|
+
- **Type:** {CHANGE_TYPE}
|
|
6
|
+
- **Status:** Phase {CURRENT_PHASE_NUMBER}/{TOTAL_PHASES}
|
|
7
|
+
- **Created:** {CREATED_DATE}
|
|
8
|
+
|
|
9
|
+
## References
|
|
10
|
+
**IMPORTANT:** Agents MUST read these before starting work!
|
|
11
|
+
|
|
12
|
+
- **Proposal:** [../proposal.md](../proposal.md) - Business requirements and scope
|
|
13
|
+
- **Tasks:** [../tasks.md](../tasks.md) - Implementation checklist
|
|
14
|
+
- **Design:** [../design.md](../design.md) - Technical decisions (if exists)
|
|
15
|
+
- **Specs:** ../specs/ - Delta requirements
|
|
16
|
+
|
|
17
|
+
## Tech Stack
|
|
18
|
+
|
|
19
|
+
### Core (from project-level)
|
|
20
|
+
Reference: `@/.claude/contexts/domain/project/best-practices/`
|
|
21
|
+
|
|
22
|
+
{CORE_TECH_LIST}
|
|
23
|
+
|
|
24
|
+
### Additional (Change-specific)
|
|
25
|
+
**New tech for this Change only:**
|
|
26
|
+
|
|
27
|
+
{ADDITIONAL_TECH_LIST}
|
|
28
|
+
|
|
29
|
+
## Change-Specific Patterns
|
|
30
|
+
|
|
31
|
+
{CHANGE_SPECIFIC_PATTERNS}
|
|
32
|
+
|
|
33
|
+
## Agent Instructions per Phase
|
|
34
|
+
|
|
35
|
+
{AGENT_INSTRUCTIONS}
|
|
36
|
+
|
|
37
|
+
## Phase Tracking
|
|
38
|
+
**Current phase:** {CURRENT_PHASE}
|
|
39
|
+
|
|
40
|
+
See `flags.json` for detailed tracking.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
**Last updated:** {UPDATED_DATE}
|
|
45
|
+
**Phase:** {CURRENT_PHASE} ({STATUS})
|
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": "1.0.0",
|
|
3
|
-
"change_id": "",
|
|
4
|
-
"change_type": "",
|
|
5
|
-
"template": "",
|
|
6
|
-
"created_at": "",
|
|
7
|
-
"updated_at": "",
|
|
8
|
-
|
|
9
|
-
"current_phase": "",
|
|
10
|
-
|
|
11
|
-
"phases": {},
|
|
12
|
-
|
|
13
|
-
"meta": {
|
|
14
|
-
"total_phases": 0,
|
|
15
|
-
"completed_phases": 0,
|
|
16
|
-
"in_progress_phases": 0,
|
|
17
|
-
"pending_phases": 0,
|
|
18
|
-
"progress_percentage": 0,
|
|
19
|
-
|
|
20
|
-
"total_estimated_minutes": 0,
|
|
21
|
-
"total_actual_minutes": 0,
|
|
22
|
-
"time_remaining_estimate": 0,
|
|
23
|
-
|
|
24
|
-
"tests_total": 0,
|
|
25
|
-
"tests_passed": 0,
|
|
26
|
-
"tests_failed": 0,
|
|
27
|
-
"coverage_percentage": 0,
|
|
28
|
-
|
|
29
|
-
"issues_found": 0,
|
|
30
|
-
"issues_fixed": 0,
|
|
31
|
-
"issues_remaining": 0,
|
|
32
|
-
|
|
33
|
-
"files_created": 0,
|
|
34
|
-
"files_modified": 0
|
|
35
|
-
},
|
|
36
|
-
|
|
37
|
-
"ready_to_archive": false,
|
|
38
|
-
"blocked": false,
|
|
39
|
-
"blocking_reason": null,
|
|
40
|
-
|
|
41
|
-
"history": []
|
|
42
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"version": "1.0.0",
|
|
3
|
+
"change_id": "",
|
|
4
|
+
"change_type": "",
|
|
5
|
+
"template": "",
|
|
6
|
+
"created_at": "",
|
|
7
|
+
"updated_at": "",
|
|
8
|
+
|
|
9
|
+
"current_phase": "",
|
|
10
|
+
|
|
11
|
+
"phases": {},
|
|
12
|
+
|
|
13
|
+
"meta": {
|
|
14
|
+
"total_phases": 0,
|
|
15
|
+
"completed_phases": 0,
|
|
16
|
+
"in_progress_phases": 0,
|
|
17
|
+
"pending_phases": 0,
|
|
18
|
+
"progress_percentage": 0,
|
|
19
|
+
|
|
20
|
+
"total_estimated_minutes": 0,
|
|
21
|
+
"total_actual_minutes": 0,
|
|
22
|
+
"time_remaining_estimate": 0,
|
|
23
|
+
|
|
24
|
+
"tests_total": 0,
|
|
25
|
+
"tests_passed": 0,
|
|
26
|
+
"tests_failed": 0,
|
|
27
|
+
"coverage_percentage": 0,
|
|
28
|
+
|
|
29
|
+
"issues_found": 0,
|
|
30
|
+
"issues_fixed": 0,
|
|
31
|
+
"issues_remaining": 0,
|
|
32
|
+
|
|
33
|
+
"files_created": 0,
|
|
34
|
+
"files_modified": 0
|
|
35
|
+
},
|
|
36
|
+
|
|
37
|
+
"ready_to_archive": false,
|
|
38
|
+
"blocked": false,
|
|
39
|
+
"blocking_reason": null,
|
|
40
|
+
|
|
41
|
+
"history": []
|
|
42
|
+
}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# Phase: Accessibility Test
|
|
2
|
-
|
|
3
|
-
**Agent:** `test-debug`
|
|
4
|
-
**Metadata:** `| automated | accessibility |`
|
|
5
|
-
**Estimated time:** 10 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
Run automated accessibility tests (Lighthouse, axe-core).
|
|
9
|
-
|
|
10
|
-
## ✅ Success Criteria
|
|
11
|
-
- [ ] Lighthouse score ≥ 95
|
|
12
|
-
- [ ] Contrast ratios pass WCAG AAA
|
|
13
|
-
- [ ] ARIA labels complete
|
|
14
|
-
|
|
15
|
-
## 📤 Output
|
|
16
|
-
- Test report
|
|
17
|
-
- Update flags.json
|
|
1
|
+
# Phase: Accessibility Test
|
|
2
|
+
|
|
3
|
+
**Agent:** `test-debug`
|
|
4
|
+
**Metadata:** `| automated | accessibility |`
|
|
5
|
+
**Estimated time:** 10 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
Run automated accessibility tests (Lighthouse, axe-core).
|
|
9
|
+
|
|
10
|
+
## ✅ Success Criteria
|
|
11
|
+
- [ ] Lighthouse score ≥ 95
|
|
12
|
+
- [ ] Contrast ratios pass WCAG AAA
|
|
13
|
+
- [ ] ARIA labels complete
|
|
14
|
+
|
|
15
|
+
## 📤 Output
|
|
16
|
+
- Test report
|
|
17
|
+
- Update flags.json
|
|
@@ -1,37 +1,37 @@
|
|
|
1
|
-
# Phase: API Specification
|
|
2
|
-
|
|
3
|
-
**Agent:** `integration`
|
|
4
|
-
**Metadata:** `| api-design |`
|
|
5
|
-
**Estimated time:** 30 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
|
|
9
|
-
Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
|
|
10
|
-
|
|
11
|
-
## 📚 Context Loading
|
|
12
|
-
|
|
13
|
-
- ✅ `../proposal.md` → Business requirements
|
|
14
|
-
- ✅ `../tasks.md` → API endpoints to implement
|
|
15
|
-
- ✅ Frontend mockup code → Data requirements
|
|
16
|
-
- ⚠️ `error-handling.md` → API error patterns
|
|
17
|
-
|
|
18
|
-
## 📝 Tasks
|
|
19
|
-
|
|
20
|
-
1. Analyze frontend mockup → Determine data needs
|
|
21
|
-
2. Design API endpoints (RESTful)
|
|
22
|
-
3. Define request/response schemas (JSON Schema)
|
|
23
|
-
4. Define error responses (4xx, 5xx)
|
|
24
|
-
5. Create OpenAPI 3.0 spec file
|
|
25
|
-
|
|
26
|
-
## ✅ Success Criteria
|
|
27
|
-
|
|
28
|
-
- [ ] OpenAPI 3.0 spec complete
|
|
29
|
-
- [ ] All endpoints documented
|
|
30
|
-
- [ ] Request/response schemas defined with examples
|
|
31
|
-
- [ ] Error responses defined
|
|
32
|
-
|
|
33
|
-
## 📤 Output
|
|
34
|
-
|
|
35
|
-
- `.claude/openapi.yaml` (OpenAPI 3.0 spec)
|
|
36
|
-
- API documentation (Swagger UI / Redoc)
|
|
37
|
-
- Update flags.json
|
|
1
|
+
# Phase: API Specification
|
|
2
|
+
|
|
3
|
+
**Agent:** `integration`
|
|
4
|
+
**Metadata:** `| api-design |`
|
|
5
|
+
**Estimated time:** 30 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
|
|
9
|
+
Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
|
|
10
|
+
|
|
11
|
+
## 📚 Context Loading
|
|
12
|
+
|
|
13
|
+
- ✅ `../proposal.md` → Business requirements
|
|
14
|
+
- ✅ `../tasks.md` → API endpoints to implement
|
|
15
|
+
- ✅ Frontend mockup code → Data requirements
|
|
16
|
+
- ⚠️ `error-handling.md` → API error patterns
|
|
17
|
+
|
|
18
|
+
## 📝 Tasks
|
|
19
|
+
|
|
20
|
+
1. Analyze frontend mockup → Determine data needs
|
|
21
|
+
2. Design API endpoints (RESTful)
|
|
22
|
+
3. Define request/response schemas (JSON Schema)
|
|
23
|
+
4. Define error responses (4xx, 5xx)
|
|
24
|
+
5. Create OpenAPI 3.0 spec file
|
|
25
|
+
|
|
26
|
+
## ✅ Success Criteria
|
|
27
|
+
|
|
28
|
+
- [ ] OpenAPI 3.0 spec complete
|
|
29
|
+
- [ ] All endpoints documented
|
|
30
|
+
- [ ] Request/response schemas defined with examples
|
|
31
|
+
- [ ] Error responses defined
|
|
32
|
+
|
|
33
|
+
## 📤 Output
|
|
34
|
+
|
|
35
|
+
- `.claude/openapi.yaml` (OpenAPI 3.0 spec)
|
|
36
|
+
- API documentation (Swagger UI / Redoc)
|
|
37
|
+
- Update flags.json
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# Phase: Backend Tests
|
|
2
|
-
|
|
3
|
-
**Agent:** `test-debug`
|
|
4
|
-
**Metadata:** `| automated | TDD |`
|
|
5
|
-
**Estimated time:** 15 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
Run unit and integration tests for backend.
|
|
9
|
-
|
|
10
|
-
## ✅ Success Criteria
|
|
11
|
-
- [ ] All tests pass
|
|
12
|
-
- [ ] Coverage ≥ 80%
|
|
13
|
-
|
|
14
|
-
## 📤 Output
|
|
15
|
-
- Coverage report
|
|
16
|
-
- Update flags.json
|
|
1
|
+
# Phase: Backend Tests
|
|
2
|
+
|
|
3
|
+
**Agent:** `test-debug`
|
|
4
|
+
**Metadata:** `| automated | TDD |`
|
|
5
|
+
**Estimated time:** 15 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
Run unit and integration tests for backend.
|
|
9
|
+
|
|
10
|
+
## ✅ Success Criteria
|
|
11
|
+
- [ ] All tests pass
|
|
12
|
+
- [ ] Coverage ≥ 80%
|
|
13
|
+
|
|
14
|
+
## 📤 Output
|
|
15
|
+
- Coverage report
|
|
16
|
+
- Update flags.json
|
|
@@ -1,37 +1,37 @@
|
|
|
1
|
-
# Phase: Backend Implementation
|
|
2
|
-
|
|
3
|
-
**Agent:** `backend`
|
|
4
|
-
**Metadata:** `| TDD | api-work | production |`
|
|
5
|
-
**Estimated time:** 120 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
|
|
9
|
-
Implement API endpoints following OpenAPI specification. Include business logic, validation, error handling, and logging.
|
|
10
|
-
|
|
11
|
-
## 📚 Context Loading
|
|
12
|
-
|
|
13
|
-
- ✅ `tech-stack.md` → Package manager, framework version
|
|
14
|
-
- ✅ `.claude/openapi.yaml` → API contract
|
|
15
|
-
- ✅ `testing.md` (RED-GREEN-REFACTOR section)
|
|
16
|
-
- ✅ `error-handling.md` → API error patterns
|
|
17
|
-
- ✅ `logging.md` → Production logging
|
|
18
|
-
|
|
19
|
-
## 📝 Follow TDD (RED → GREEN → REFACTOR)
|
|
20
|
-
|
|
21
|
-
1. **RED:** Write failing tests first
|
|
22
|
-
2. **GREEN:** Implement to pass tests
|
|
23
|
-
3. **REFACTOR:** Clean up code
|
|
24
|
-
|
|
25
|
-
## ✅ Success Criteria
|
|
26
|
-
|
|
27
|
-
- [ ] All endpoints implemented (match OpenAPI spec)
|
|
28
|
-
- [ ] All tests pass (TDD: RED → GREEN → REFACTOR)
|
|
29
|
-
- [ ] Error handling implemented
|
|
30
|
-
- [ ] Logging added
|
|
31
|
-
- [ ] Code coverage ≥ 80%
|
|
32
|
-
|
|
33
|
-
## 📤 Output
|
|
34
|
-
|
|
35
|
-
- API routes files
|
|
36
|
-
- Tests files
|
|
37
|
-
- Update flags.json
|
|
1
|
+
# Phase: Backend Implementation
|
|
2
|
+
|
|
3
|
+
**Agent:** `backend`
|
|
4
|
+
**Metadata:** `| TDD | api-work | production |`
|
|
5
|
+
**Estimated time:** 120 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
|
|
9
|
+
Implement API endpoints following OpenAPI specification. Include business logic, validation, error handling, and logging.
|
|
10
|
+
|
|
11
|
+
## 📚 Context Loading
|
|
12
|
+
|
|
13
|
+
- ✅ `tech-stack.md` → Package manager, framework version
|
|
14
|
+
- ✅ `.claude/openapi.yaml` → API contract
|
|
15
|
+
- ✅ `testing.md` (RED-GREEN-REFACTOR section)
|
|
16
|
+
- ✅ `error-handling.md` → API error patterns
|
|
17
|
+
- ✅ `logging.md` → Production logging
|
|
18
|
+
|
|
19
|
+
## 📝 Follow TDD (RED → GREEN → REFACTOR)
|
|
20
|
+
|
|
21
|
+
1. **RED:** Write failing tests first
|
|
22
|
+
2. **GREEN:** Implement to pass tests
|
|
23
|
+
3. **REFACTOR:** Clean up code
|
|
24
|
+
|
|
25
|
+
## ✅ Success Criteria
|
|
26
|
+
|
|
27
|
+
- [ ] All endpoints implemented (match OpenAPI spec)
|
|
28
|
+
- [ ] All tests pass (TDD: RED → GREEN → REFACTOR)
|
|
29
|
+
- [ ] Error handling implemented
|
|
30
|
+
- [ ] Logging added
|
|
31
|
+
- [ ] Code coverage ≥ 80%
|
|
32
|
+
|
|
33
|
+
## 📤 Output
|
|
34
|
+
|
|
35
|
+
- API routes files
|
|
36
|
+
- Tests files
|
|
37
|
+
- Update flags.json
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# Phase: Business Logic Validation
|
|
2
|
-
|
|
3
|
-
**Agent:** `integration`
|
|
4
|
-
**Metadata:** `| validation |`
|
|
5
|
-
**Estimated time:** 10 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
Validate implementation matches business requirements from proposal.
|
|
9
|
-
|
|
10
|
-
## ✅ Success Criteria
|
|
11
|
-
- [ ] All requirements from proposal covered
|
|
12
|
-
- [ ] No discrepancies found
|
|
13
|
-
|
|
14
|
-
## 📤 Output
|
|
15
|
-
- Validation report
|
|
16
|
-
- Update flags.json
|
|
1
|
+
# Phase: Business Logic Validation
|
|
2
|
+
|
|
3
|
+
**Agent:** `integration`
|
|
4
|
+
**Metadata:** `| validation |`
|
|
5
|
+
**Estimated time:** 10 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
Validate implementation matches business requirements from proposal.
|
|
9
|
+
|
|
10
|
+
## ✅ Success Criteria
|
|
11
|
+
- [ ] All requirements from proposal covered
|
|
12
|
+
- [ ] No discrepancies found
|
|
13
|
+
|
|
14
|
+
## 📤 Output
|
|
15
|
+
- Validation report
|
|
16
|
+
- Update flags.json
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# Phase: Component Tests
|
|
2
|
-
|
|
3
|
-
**Agent:** `test-debug`
|
|
4
|
-
**Metadata:** `| unit-test | frontend |`
|
|
5
|
-
**Estimated time:** 20 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
Write unit tests for frontend components.
|
|
9
|
-
|
|
10
|
-
## ✅ Success Criteria
|
|
11
|
-
- [ ] All component tests pass
|
|
12
|
-
- [ ] Coverage ≥ 70%
|
|
13
|
-
|
|
14
|
-
## 📤 Output
|
|
15
|
-
- Test files
|
|
16
|
-
- Coverage report
|
|
17
|
-
- Update flags.json
|
|
1
|
+
# Phase: Component Tests
|
|
2
|
+
|
|
3
|
+
**Agent:** `test-debug`
|
|
4
|
+
**Metadata:** `| unit-test | frontend |`
|
|
5
|
+
**Estimated time:** 20 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
Write unit tests for frontend components.
|
|
9
|
+
|
|
10
|
+
## ✅ Success Criteria
|
|
11
|
+
- [ ] All component tests pass
|
|
12
|
+
- [ ] Coverage ≥ 70%
|
|
13
|
+
|
|
14
|
+
## 📤 Output
|
|
15
|
+
- Test files
|
|
16
|
+
- Coverage report
|
|
17
|
+
- Update flags.json
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# Phase: Contract Test (Backend)
|
|
2
|
-
|
|
3
|
-
**Agent:** `integration`
|
|
4
|
-
**Metadata:** `| contract | validation |`
|
|
5
|
-
**Estimated time:** 10 minutes
|
|
6
|
-
|
|
7
|
-
## 🎯 Purpose
|
|
8
|
-
Validate backend implementation matches OpenAPI spec.
|
|
9
|
-
|
|
10
|
-
## ✅ Success Criteria
|
|
11
|
-
- [ ] All endpoints match spec
|
|
12
|
-
- [ ] No schema violations
|
|
13
|
-
|
|
14
|
-
## 📤 Output
|
|
15
|
-
- Contract test report
|
|
16
|
-
- Update flags.json
|
|
1
|
+
# Phase: Contract Test (Backend)
|
|
2
|
+
|
|
3
|
+
**Agent:** `integration`
|
|
4
|
+
**Metadata:** `| contract | validation |`
|
|
5
|
+
**Estimated time:** 10 minutes
|
|
6
|
+
|
|
7
|
+
## 🎯 Purpose
|
|
8
|
+
Validate backend implementation matches OpenAPI spec.
|
|
9
|
+
|
|
10
|
+
## ✅ Success Criteria
|
|
11
|
+
- [ ] All endpoints match spec
|
|
12
|
+
- [ ] No schema violations
|
|
13
|
+
|
|
14
|
+
## 📤 Output
|
|
15
|
+
- Contract test report
|
|
16
|
+
- Update flags.json
|