@kienha/anti-chaotic 1.0.5 → 1.0.6
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/.agent/skills/rules-workflows/SKILL.md +22 -155
- package/.agent/skills/rules-workflows/assets/workflow-basic.md +1 -1
- package/.agent/skills/rules-workflows/references/orchestration-patterns.md +11 -13
- package/.agent/skills/rules-workflows/references/rules-guide.md +97 -39
- package/.agent/skills/rules-workflows/references/workflows-guide.md +103 -26
- package/.agent/workflows/bootstrap.md +96 -0
- package/.agent/workflows/brainstorm.md +81 -0
- package/.agent/workflows/custom-behavior.md +64 -0
- package/.agent/workflows/documentation.md +123 -0
- package/.agent/workflows/implement-feature.md +2 -4
- package/.agent/workflows/ui-ux-design.md +2 -4
- package/README.md +44 -23
- package/package.json +1 -1
- package/.agent/skills/skill-creator/scripts/__pycache__/encoding_utils.cpython-312.pyc +0 -0
- package/.agent/skills/skill-creator/scripts/__pycache__/quick_validate.cpython-312.pyc +0 -0
- package/.agent/workflows/docs-from-codebase.md +0 -104
- package/.agent/workflows/requirement-analysis.md +0 -200
- package/.agent/workflows/setup-codebase.md +0 -90
- /package/.agent/rules/{documentation.md → documents.md} +0 -0
|
@@ -1,200 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Requirement Analysis Workflow (PM → BA → Architect)
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# Requirement Analysis Workflow
|
|
6
|
-
|
|
7
|
-
Transforms a raw user request into comprehensive, validated implementation plan.
|
|
8
|
-
|
|
9
|
-
> [!IMPORTANT]
|
|
10
|
-
> **MANDATORY**: Read `.agent/rules/documentation.md` before creating any document.
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## MCP Usage Guidelines
|
|
15
|
-
|
|
16
|
-
| MCP Tool | When to Use | Example |
|
|
17
|
-
| -------------------------------------------- | ------------------------------------------------------ | --------------------------------- |
|
|
18
|
-
| `mcp_sequential-thinking_sequentialthinking` | Analyze requirements, feature dependencies, trade-offs | Break down ambiguous requests |
|
|
19
|
-
| `mcp_context7_resolve-library-id` | Find library ID before querying | "mermaid js" |
|
|
20
|
-
| `mcp_context7_query-docs` | Research tech stack options, diagram syntax | "Mermaid sequence diagram syntax" |
|
|
21
|
-
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
## Document Priority Order
|
|
25
|
-
|
|
26
|
-
```
|
|
27
|
-
Priority 0: Roadmap ← Project Planning & Timeline
|
|
28
|
-
Priority 1: PRD ← Strategic Overview
|
|
29
|
-
Priority 2: SDD ← Technical Overview
|
|
30
|
-
Priority 3: Epics ← Feature Breakdown
|
|
31
|
-
Priority 4: Use Cases ← Functional Details
|
|
32
|
-
Priority 5: User Stories ← Implementation Units
|
|
33
|
-
Priority 6: ADRs ← Technical Decisions (if needed)
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## Step 0: Clarification & Understanding
|
|
39
|
-
|
|
40
|
-
**Role: Product Manager**
|
|
41
|
-
|
|
42
|
-
> [!NOTE]
|
|
43
|
-
> This step is **MANDATORY**. Do NOT proceed without user confirmation.
|
|
44
|
-
|
|
45
|
-
> 💡 **MCP**: Use `sequential-thinking` to analyze ambiguous or complex requests
|
|
46
|
-
|
|
47
|
-
1. **Invoke `[product-manager]` skill** to:
|
|
48
|
-
- Summarize understanding
|
|
49
|
-
- Create clarification questions
|
|
50
|
-
2. Create `clarification-questions.md` artifact
|
|
51
|
-
3. **WAIT** for user to review and confirm
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
55
|
-
## Step 1: Create Roadmap
|
|
56
|
-
|
|
57
|
-
// turbo
|
|
58
|
-
|
|
59
|
-
> 💡 **MCP**: Use `sequential-thinking` for phased planning and risk assessment
|
|
60
|
-
|
|
61
|
-
1. **Invoke `[product-manager]` skill** to draft:
|
|
62
|
-
- Project timeline and milestones
|
|
63
|
-
- Phase breakdown (MVP, v1.0, v2.0)
|
|
64
|
-
- Key deliverables per phase
|
|
65
|
-
2. Create `draft-roadmap.md` artifact
|
|
66
|
-
3. After approval → Save to `docs/010-Planning/Roadmap-{ProjectName}.md`
|
|
67
|
-
4. **WAIT** for user response
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## Step 2: Create PRD
|
|
72
|
-
|
|
73
|
-
// turbo
|
|
74
|
-
|
|
75
|
-
1. **Invoke `[product-manager]` skill** to draft:
|
|
76
|
-
- Business objectives and success metrics
|
|
77
|
-
- Target audience/user personas
|
|
78
|
-
- Feature prioritization (MoSCoW)
|
|
79
|
-
2. Create `draft-prd.md` artifact
|
|
80
|
-
3. After approval → Save to `docs/020-Requirements/PRD-{ProjectName}.md`
|
|
81
|
-
4. **WAIT** for user response
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
## Step 3: Create SDD
|
|
86
|
-
|
|
87
|
-
// turbo
|
|
88
|
-
|
|
89
|
-
> 💡 **MCP**:
|
|
90
|
-
>
|
|
91
|
-
> - **MUST** use `sequential-thinking` for architectural decisions
|
|
92
|
-
> - Use `context7` with `/vercel/next.js`, `/supabase/supabase` for tech stack research
|
|
93
|
-
|
|
94
|
-
1. **Invoke `[lead-architect]` skill** to draft:
|
|
95
|
-
- High-level system architecture
|
|
96
|
-
- Technology stack decisions
|
|
97
|
-
- Component diagram
|
|
98
|
-
- Data flow overview
|
|
99
|
-
2. Create `draft-sdd.md` artifact
|
|
100
|
-
3. After approval → Save to `docs/030-Specs/Architecture/SDD-{ProjectName}.md`
|
|
101
|
-
4. **WAIT** for user response
|
|
102
|
-
|
|
103
|
-
---
|
|
104
|
-
|
|
105
|
-
## Step 4: Create Epics
|
|
106
|
-
|
|
107
|
-
// turbo
|
|
108
|
-
|
|
109
|
-
> 💡 **MCP**: Use `sequential-thinking` to analyze feature dependencies
|
|
110
|
-
|
|
111
|
-
1. **Invoke `[business-analysis]` skill** to:
|
|
112
|
-
- Break PRD features into Epics
|
|
113
|
-
- Define high-level acceptance criteria
|
|
114
|
-
2. Create `draft-epics.md` artifact
|
|
115
|
-
3. After approval → Save to `docs/022-User-Stories/Epics/Epic-{FeatureName}.md`
|
|
116
|
-
4. **WAIT** for user response
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
## Step 5: Create Use Cases
|
|
121
|
-
|
|
122
|
-
// turbo
|
|
123
|
-
|
|
124
|
-
> 💡 **MCP**:
|
|
125
|
-
>
|
|
126
|
-
> - Use `sequential-thinking` for complex flow analysis
|
|
127
|
-
> - Use `context7` with `/mermaid-js/mermaid` for diagram syntax
|
|
128
|
-
|
|
129
|
-
1. **Invoke `[business-analysis]` skill** to detail:
|
|
130
|
-
- Happy path flow
|
|
131
|
-
- Alternative flows
|
|
132
|
-
- Edge cases and error handling
|
|
133
|
-
- Mermaid diagrams where helpful
|
|
134
|
-
2. Create `draft-use-cases.md` artifact
|
|
135
|
-
3. After approval → Save to `docs/020-Requirements/Use-Cases/UC-{NN}-{Name}.md`
|
|
136
|
-
4. **WAIT** for user response
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
## Step 6: Create User Stories
|
|
141
|
-
|
|
142
|
-
// turbo
|
|
143
|
-
|
|
144
|
-
> 💡 **MCP**: Use `sequential-thinking` to derive acceptance criteria
|
|
145
|
-
|
|
146
|
-
1. **Invoke `[business-analysis]` skill** to create:
|
|
147
|
-
- Stories in format: "As a [role], I want [action], so that [value]"
|
|
148
|
-
- Clear Acceptance Criteria
|
|
149
|
-
- Complexity estimates (S/M/L)
|
|
150
|
-
2. Create `draft-user-stories.md` artifact
|
|
151
|
-
3. After approval → Save to `docs/022-User-Stories/Backlog/Story-{Name}.md`
|
|
152
|
-
4. **WAIT** for user response - Ask if ADRs needed
|
|
153
|
-
|
|
154
|
-
---
|
|
155
|
-
|
|
156
|
-
## Step 7: Create ADRs (Optional)
|
|
157
|
-
|
|
158
|
-
// turbo
|
|
159
|
-
|
|
160
|
-
**Skip if**: User did not request ADRs in Step 6.
|
|
161
|
-
|
|
162
|
-
> 💡 **MCP**:
|
|
163
|
-
>
|
|
164
|
-
> - Use `sequential-thinking` to evaluate trade-offs
|
|
165
|
-
> - Use `context7` to research technology options
|
|
166
|
-
|
|
167
|
-
1. **Invoke `[lead-architect]` skill** to document:
|
|
168
|
-
- Context
|
|
169
|
-
- Options considered
|
|
170
|
-
- Decision made
|
|
171
|
-
- Consequences
|
|
172
|
-
2. Save to `docs/030-Specs/Architecture/ADR-{NNN}-{Decision}.md`
|
|
173
|
-
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
## Step 8: Finalize & Summary
|
|
177
|
-
|
|
178
|
-
// turbo
|
|
179
|
-
|
|
180
|
-
1. **Invoke `[product-manager]` skill** to:
|
|
181
|
-
- Update MOC files
|
|
182
|
-
- Add project section to `docs/000-Index.md`
|
|
183
|
-
2. Present final summary with all created documents
|
|
184
|
-
3. Suggest next steps: `/ui-ux-design` or `/implement-feature`
|
|
185
|
-
|
|
186
|
-
---
|
|
187
|
-
|
|
188
|
-
## Quick Reference
|
|
189
|
-
|
|
190
|
-
| Step | Skill | Output |
|
|
191
|
-
| ---- | ----------------- | -------------------------- |
|
|
192
|
-
| 0 | product-manager | clarification-questions.md |
|
|
193
|
-
| 1 | product-manager | Roadmap-{Project}.md |
|
|
194
|
-
| 2 | product-manager | PRD-{Project}.md |
|
|
195
|
-
| 3 | lead-architect | SDD-{Project}.md |
|
|
196
|
-
| 4 | business-analysis | Epic-{Feature}.md |
|
|
197
|
-
| 5 | business-analysis | UC-{NN}-{Name}.md |
|
|
198
|
-
| 6 | business-analysis | Story-{Name}.md |
|
|
199
|
-
| 7 | lead-architect | ADR-{NNN}-{Decision}.md |
|
|
200
|
-
| 8 | product-manager | Updated MOCs |
|
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Initialize codebase and dependencies based on SDD/ADR
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# Setup Codebase Workflow
|
|
6
|
-
|
|
7
|
-
Sets up project structure, installs dependencies, and configures environment based on architectural specs.
|
|
8
|
-
|
|
9
|
-
> [!IMPORTANT]
|
|
10
|
-
> **Prerequisite**: Ensure SDD exists in `docs/030-Specs/Architecture/`.
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## MCP Usage Guidelines
|
|
15
|
-
|
|
16
|
-
| MCP Tool | When to Use |
|
|
17
|
-
| --------------------------------- | ---------------------------------- |
|
|
18
|
-
| `mcp_context7_resolve-library-id` | Find correct package names |
|
|
19
|
-
| `mcp_context7_query-docs` | Research installation/config steps |
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Step 1: Initialize Framework
|
|
24
|
-
|
|
25
|
-
// turbo
|
|
26
|
-
|
|
27
|
-
**Verification**: Check if directory is empty or safe to overwrite.
|
|
28
|
-
|
|
29
|
-
1. **Invoke `[devops-engineer]` skill** to:
|
|
30
|
-
- Initialize framework (e.g., Next.js, Vite) using `npx`
|
|
31
|
-
- Configure TypeScript, ESLint, TailwindCSS
|
|
32
|
-
2. **WAIT** for initialization to complete
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
## Step 2: Install Core Dependencies
|
|
37
|
-
|
|
38
|
-
// turbo
|
|
39
|
-
|
|
40
|
-
> 💡 **MCP**: Use `context7` to finding verified package names
|
|
41
|
-
|
|
42
|
-
1. **Invoke `[devops-engineer]` skill** to install:
|
|
43
|
-
- State management (e.g., zustand, redux)
|
|
44
|
-
- Styling/UI (e.g., clsx, tailwind-merge, framer-motion)
|
|
45
|
-
- Data fetching/Backend (e.g., @supabase/supabase-js, react-query)
|
|
46
|
-
- Utilities (e.g., date-fns, zod)
|
|
47
|
-
2. **WAIT** for installation
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## Step 3: Scaffold Architecture
|
|
52
|
-
|
|
53
|
-
// turbo
|
|
54
|
-
|
|
55
|
-
1. **Invoke `[lead-architect]` skill** to:
|
|
56
|
-
- Read SDD for module structure
|
|
57
|
-
- Create core directories (`src/components`, `src/lib`, `src/hooks`)
|
|
58
|
-
- Create feature modules (`src/features/`, `src/modules/`)
|
|
59
|
-
2. **WAIT** for structure creation
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
## Step 4: Configuration
|
|
64
|
-
|
|
65
|
-
// turbo
|
|
66
|
-
|
|
67
|
-
1. **Invoke `[backend-developer]` skill** to:
|
|
68
|
-
- Setup `.env.example`
|
|
69
|
-
- Configure core utilities (`cn`, `API client`)
|
|
70
|
-
- Setup path aliases (`tsconfig.json`)
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## Step 5: Verification
|
|
75
|
-
|
|
76
|
-
// turbo
|
|
77
|
-
|
|
78
|
-
1. Run `npm run build` to verify configuration
|
|
79
|
-
2. Verify directory structure matches SDD
|
|
80
|
-
|
|
81
|
-
---
|
|
82
|
-
|
|
83
|
-
## Quick Reference
|
|
84
|
-
|
|
85
|
-
| Step | Skill | Action |
|
|
86
|
-
| ---- | ----------------- | ---------------- |
|
|
87
|
-
| 1 | devops-engineer | Init framework |
|
|
88
|
-
| 2 | devops-engineer | Install deps |
|
|
89
|
-
| 3 | lead-architect | Create folders |
|
|
90
|
-
| 4 | backend-developer | Config env/utils |
|
|
File without changes
|