moicle 2.2.3 → 2.3.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 +10 -2
- package/assets/commands/marketing.md +7 -7
- package/assets/skills/docs/sync/SKILL.md +7 -7
- package/assets/skills/docs/write/SKILL.md +8 -8
- package/assets/skills/feature/api/SKILL.md +9 -9
- package/assets/skills/feature/deprecate/SKILL.md +3 -3
- package/assets/skills/feature/new/SKILL.md +10 -10
- package/assets/skills/feature/refactor/SKILL.md +8 -8
- package/assets/skills/fix/hotfix/SKILL.md +12 -12
- package/assets/skills/fix/incident/SKILL.md +6 -6
- package/assets/skills/fix/pr-comment/SKILL.md +11 -11
- package/assets/skills/fix/root-cause/SKILL.md +6 -6
- package/assets/skills/marketing/content/SKILL.md +5 -5
- package/assets/skills/marketing/logo/SKILL.md +4 -4
- package/assets/skills/marketing/seo-blog/SKILL.md +5 -5
- package/assets/skills/marketing/video/SKILL.md +3 -3
- package/assets/skills/research/onboarding/SKILL.md +7 -7
- package/assets/skills/research/spike/SKILL.md +10 -10
- package/assets/skills/research/web/SKILL.md +8 -8
- package/assets/skills/review/architect/SKILL.md +12 -12
- package/assets/skills/review/branch/SKILL.md +6 -6
- package/assets/skills/review/pr/SKILL.md +8 -8
- package/assets/skills/review/tdd/SKILL.md +5 -5
- package/bin/cli.js +4 -2
- package/dist/commands/disable.d.ts.map +1 -1
- package/dist/commands/disable.js +44 -59
- package/dist/commands/disable.js.map +1 -1
- package/dist/commands/enable.d.ts.map +1 -1
- package/dist/commands/enable.js +45 -61
- package/dist/commands/enable.js.map +1 -1
- package/dist/commands/install/cursor-editor.d.ts +3 -0
- package/dist/commands/install/cursor-editor.d.ts.map +1 -0
- package/dist/commands/install/cursor-editor.js +114 -0
- package/dist/commands/install/cursor-editor.js.map +1 -0
- package/dist/commands/install/cursor-transform.d.ts +3 -0
- package/dist/commands/install/cursor-transform.d.ts.map +1 -0
- package/dist/commands/install/cursor-transform.js +25 -0
- package/dist/commands/install/cursor-transform.js.map +1 -0
- package/dist/commands/install/index.d.ts.map +1 -1
- package/dist/commands/install/index.js +5 -1
- package/dist/commands/install/index.js.map +1 -1
- package/dist/commands/install/prompts.d.ts +1 -1
- package/dist/commands/install/prompts.d.ts.map +1 -1
- package/dist/commands/install/prompts.js +1 -0
- package/dist/commands/install/prompts.js.map +1 -1
- package/dist/commands/install/skill-editor.d.ts.map +1 -1
- package/dist/commands/install/skill-editor.js +1 -12
- package/dist/commands/install/skill-editor.js.map +1 -1
- package/dist/commands/install/transform.d.ts +1 -0
- package/dist/commands/install/transform.d.ts.map +1 -1
- package/dist/commands/install/transform.js +6 -0
- package/dist/commands/install/transform.js.map +1 -1
- package/dist/commands/install/usage.d.ts.map +1 -1
- package/dist/commands/install/usage.js +20 -8
- package/dist/commands/install/usage.js.map +1 -1
- package/dist/commands/install/write-if-changed.d.ts +4 -0
- package/dist/commands/install/write-if-changed.d.ts.map +1 -0
- package/dist/commands/install/write-if-changed.js +14 -0
- package/dist/commands/install/write-if-changed.js.map +1 -0
- package/dist/commands/list.d.ts.map +1 -1
- package/dist/commands/list.js +41 -3
- package/dist/commands/list.js.map +1 -1
- package/dist/commands/postinstall.d.ts.map +1 -1
- package/dist/commands/postinstall.js +2 -1
- package/dist/commands/postinstall.js.map +1 -1
- package/dist/commands/status.d.ts.map +1 -1
- package/dist/commands/status.js +53 -4
- package/dist/commands/status.js.map +1 -1
- package/dist/commands/uninstall.d.ts.map +1 -1
- package/dist/commands/uninstall.js +91 -4
- package/dist/commands/uninstall.js.map +1 -1
- package/dist/utils/editor-constants.d.ts +5 -0
- package/dist/utils/editor-constants.d.ts.map +1 -0
- package/dist/utils/editor-constants.js +5 -0
- package/dist/utils/editor-constants.js.map +1 -0
- package/dist/utils/editor-items.d.ts +11 -0
- package/dist/utils/editor-items.d.ts.map +1 -0
- package/dist/utils/editor-items.js +57 -0
- package/dist/utils/editor-items.js.map +1 -0
- package/dist/utils/symlink.d.ts +1 -0
- package/dist/utils/symlink.d.ts.map +1 -1
- package/dist/utils/symlink.js +7 -5
- package/dist/utils/symlink.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -25,9 +25,11 @@ A toolkit to bootstrap and accelerate project development with Claude Code throu
|
|
|
25
25
|
- [x] Claude
|
|
26
26
|
- [x] Codex CLI
|
|
27
27
|
- [x] Antigravity
|
|
28
|
-
- [
|
|
28
|
+
- [x] Cursor
|
|
29
29
|
- [ ] Windsurf
|
|
30
30
|
|
|
31
|
+
Older MoiCle versions merged agents into `~/.cursor/AGENTS.md`. Re-run `moicle install --target cursor` for native `.cursor/rules/*.mdc` layout; you may delete legacy `AGENTS.md` manually.
|
|
32
|
+
|
|
31
33
|
## Installation
|
|
32
34
|
|
|
33
35
|
```bash
|
|
@@ -46,6 +48,10 @@ moicle install --target codex --global
|
|
|
46
48
|
# Install for Antigravity
|
|
47
49
|
moicle install --target antigravity --global
|
|
48
50
|
|
|
51
|
+
# Install for Cursor (rules, commands, skills, architecture)
|
|
52
|
+
moicle install --target cursor --global
|
|
53
|
+
moicle install --target cursor --project
|
|
54
|
+
|
|
49
55
|
# Choose:
|
|
50
56
|
# 1. Pick Claude Code, Codex CLI, or Antigravity
|
|
51
57
|
# 2. Pick global or project scope
|
|
@@ -60,7 +66,9 @@ moicle install --target antigravity --global
|
|
|
60
66
|
| `moicle install --project` | Install to ./.claude/ (copies) |
|
|
61
67
|
| `moicle install --target codex --global` | Install Codex skills + architecture to ~/.codex/ |
|
|
62
68
|
| `moicle install --target codex --project` | Install Codex skills + architecture to ./.codex/ |
|
|
63
|
-
| `moicle
|
|
69
|
+
| `moicle install --target cursor --global` | Install Cursor rules, commands, skills to ~/.cursor/ |
|
|
70
|
+
| `moicle install --target cursor --project` | Install Cursor assets to ./.cursor/ |
|
|
71
|
+
| `moicle list --target cursor` | List Cursor rules, commands, and skills |
|
|
64
72
|
| `moicle status` | Show enabled/disabled status |
|
|
65
73
|
| `moicle enable <item>` | Enable an agent/command/skill |
|
|
66
74
|
| `moicle disable <item>` | Disable an agent/command/skill |
|
|
@@ -30,13 +30,13 @@ Let the user choose which areas to focus on:
|
|
|
30
30
|
Which marketing areas do you want to plan?
|
|
31
31
|
|
|
32
32
|
1. Logo & Brand Identity — Design logo, colors, typography, brand guidelines
|
|
33
|
-
Triggers skill: /marketing
|
|
33
|
+
Triggers skill: /marketing-logo
|
|
34
34
|
|
|
35
35
|
2. Video Content Strategy — Plan video series, scripts, production, publishing
|
|
36
|
-
Triggers skill: /marketing
|
|
36
|
+
Triggers skill: /marketing-video
|
|
37
37
|
|
|
38
38
|
3. Content Writing Strategy — Blog posts, social media, SEO, newsletter
|
|
39
|
-
Triggers skill: /marketing
|
|
39
|
+
Triggers skill: /marketing-content
|
|
40
40
|
|
|
41
41
|
4. All of the Above — Complete marketing plan (Recommended)
|
|
42
42
|
|
|
@@ -55,19 +55,19 @@ MARKETING PLAN WORKFLOW
|
|
|
55
55
|
|
|
56
56
|
Phase 1: Brand Foundation
|
|
57
57
|
│
|
|
58
|
-
├── Execute: /marketing
|
|
58
|
+
├── Execute: /marketing-logo skill
|
|
59
59
|
│ └── Output: Brand guidelines, color palette, typography
|
|
60
60
|
│
|
|
61
61
|
▼
|
|
62
62
|
Phase 2: Content Strategy
|
|
63
63
|
│
|
|
64
|
-
├── Execute: /marketing
|
|
64
|
+
├── Execute: /marketing-content skill
|
|
65
65
|
│ └── Output: Content pillars, blog plan, social media plan, newsletter
|
|
66
66
|
│
|
|
67
67
|
▼
|
|
68
68
|
Phase 3: Video Content
|
|
69
69
|
│
|
|
70
|
-
├── Execute: /marketing
|
|
70
|
+
├── Execute: /marketing-video skill
|
|
71
71
|
│ └── Output: Video series, scripts, production specs, calendar
|
|
72
72
|
│
|
|
73
73
|
▼
|
|
@@ -85,7 +85,7 @@ Phase 5: Launch Plan
|
|
|
85
85
|
|
|
86
86
|
### Execution Notes:
|
|
87
87
|
- Run skills sequentially — brand identity informs content and video decisions
|
|
88
|
-
- Pass brand guidelines (colors, voice, tone) from /marketing
|
|
88
|
+
- Pass brand guidelines (colors, voice, tone) from /marketing-logo into /marketing-content and /marketing-video
|
|
89
89
|
- Ensure consistency across all outputs
|
|
90
90
|
|
|
91
91
|
## Step 4: Create Unified Calendar
|
|
@@ -12,9 +12,9 @@ Generate a complete `docs/` site (business overview, architecture, use cases wit
|
|
|
12
12
|
- ✅ Re-generate the whole `docs/` site from current code
|
|
13
13
|
- ✅ Existing docs have drifted; want batch sync with review loop
|
|
14
14
|
- ✅ Project has no structured docs at all
|
|
15
|
-
- ❌ Authoring a single doc by hand (README / API.md only) → use `/docs
|
|
16
|
-
- ❌ Understand the codebase, not document it → use `/research
|
|
17
|
-
- ❌ Adding doc for one endpoint → use `/feature
|
|
15
|
+
- ❌ Authoring a single doc by hand (README / API.md only) → use `/docs-write`
|
|
16
|
+
- ❌ Understand the codebase, not document it → use `/research-onboarding`
|
|
17
|
+
- ❌ Adding doc for one endpoint → use `/feature-api` Phase 4
|
|
18
18
|
|
|
19
19
|
## Read Architecture First
|
|
20
20
|
|
|
@@ -229,10 +229,10 @@ For each iteration:
|
|
|
229
229
|
|
|
230
230
|
| When | Use |
|
|
231
231
|
|------|-----|
|
|
232
|
-
| Author single doc by hand | `/docs
|
|
233
|
-
| Onboard self / new dev | `/research
|
|
234
|
-
| Doc only one new endpoint | `/feature
|
|
235
|
-
| Architecture itself needs review | `/review
|
|
232
|
+
| Author single doc by hand | `/docs-write` |
|
|
233
|
+
| Onboard self / new dev | `/research-onboarding` |
|
|
234
|
+
| Doc only one new endpoint | `/feature-api` Phase 4 |
|
|
235
|
+
| Architecture itself needs review | `/review-architect` |
|
|
236
236
|
|
|
237
237
|
## Recommended Agents
|
|
238
238
|
|
|
@@ -5,15 +5,15 @@ description: Documentation workflow for authoring project documentation manually
|
|
|
5
5
|
|
|
6
6
|
# Documentation Workflow
|
|
7
7
|
|
|
8
|
-
Hand-author project docs (README, API.md, ARCHITECTURE.md, CONTRIBUTING.md) with full control over voice and structure. For automated batch generation of a whole `docs/` tree with a review loop, use `/docs
|
|
8
|
+
Hand-author project docs (README, API.md, ARCHITECTURE.md, CONTRIBUTING.md) with full control over voice and structure. For automated batch generation of a whole `docs/` tree with a review loop, use `/docs-sync` instead.
|
|
9
9
|
|
|
10
10
|
## When to use this skill
|
|
11
11
|
|
|
12
12
|
- ✅ Authoring or updating a specific document
|
|
13
13
|
- ✅ Need opinionated prose, not just structure
|
|
14
14
|
- ✅ Doc is small / scoped — a single file or section
|
|
15
|
-
- ❌ Want automated multi-doc generation → use `/docs
|
|
16
|
-
- ❌ Just need API reference from OpenAPI → use `/feature
|
|
15
|
+
- ❌ Want automated multi-doc generation → use `/docs-sync`
|
|
16
|
+
- ❌ Just need API reference from OpenAPI → use `/feature-api` Phase 4
|
|
17
17
|
|
|
18
18
|
## Read Architecture First
|
|
19
19
|
|
|
@@ -108,7 +108,7 @@ For each doc define:
|
|
|
108
108
|
|
|
109
109
|
### Minimal skeletons
|
|
110
110
|
|
|
111
|
-
Use these as starting points. For full templates, see `/docs
|
|
111
|
+
Use these as starting points. For full templates, see `/docs-sync` (which generates the full set).
|
|
112
112
|
|
|
113
113
|
**README.md** (≤80 lines for most projects)
|
|
114
114
|
```markdown
|
|
@@ -258,10 +258,10 @@ If any issue → return to Phase 3 for that doc, fix, re-review.
|
|
|
258
258
|
|
|
259
259
|
| When | Use |
|
|
260
260
|
|------|-----|
|
|
261
|
-
| Generate full doc site from codebase | `/docs
|
|
262
|
-
| Document a newly added API endpoint | `/feature
|
|
263
|
-
| Onboard self / new dev | `/research
|
|
264
|
-
| Write blog / social content | `/marketing
|
|
261
|
+
| Generate full doc site from codebase | `/docs-sync` |
|
|
262
|
+
| Document a newly added API endpoint | `/feature-api` Phase 4 |
|
|
263
|
+
| Onboard self / new dev | `/research-onboarding` |
|
|
264
|
+
| Write blog / social content | `/marketing-content` |
|
|
265
265
|
|
|
266
266
|
## Recommended Agents
|
|
267
267
|
|
|
@@ -13,8 +13,8 @@ End-to-end workflow for designing, implementing, testing, and documenting APIs
|
|
|
13
13
|
- ✅ Integrating a third-party API (Stripe, OpenAI, etc.) into the system
|
|
14
14
|
- ✅ Replacing or upgrading an existing API integration
|
|
15
15
|
- ❌ Just need a one-off HTTP call in a script → use Bash directly
|
|
16
|
-
- ❌ Need to research which API to use → use `/research
|
|
17
|
-
- ❌ Building a whole new domain → use `/feature
|
|
16
|
+
- ❌ Need to research which API to use → use `/research-web` first
|
|
17
|
+
- ❌ Building a whole new domain → use `/feature-new` (which calls this skill internally for the API surface)
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
@@ -160,7 +160,7 @@ GET /resource?cursor=<opaque>&limit=<int 1..100, default 20>
|
|
|
160
160
|
|
|
161
161
|
### What to update
|
|
162
162
|
1. **OpenAPI spec** committed to repo (`openapi.yaml` or per-resource files)
|
|
163
|
-
2. **API.md** — append the new endpoint(s) (or refer to `/docs
|
|
163
|
+
2. **API.md** — append the new endpoint(s) (or refer to `/docs-write` skill for full re-author)
|
|
164
164
|
3. **CHANGELOG.md** — note breaking / additive changes
|
|
165
165
|
4. **README.md** — if this changes quick-start
|
|
166
166
|
|
|
@@ -201,11 +201,11 @@ Create a resource. Idempotent via `Idempotency-Key` header.
|
|
|
201
201
|
|
|
202
202
|
## Phase 5: REVIEW LOOP
|
|
203
203
|
|
|
204
|
-
Run `/review
|
|
204
|
+
Run `/review-architect` for the touched domain. Loop until score ≥ B.
|
|
205
205
|
|
|
206
206
|
```
|
|
207
207
|
LOOP:
|
|
208
|
-
1. Run /review
|
|
208
|
+
1. Run /review-architect {stack} {domain}
|
|
209
209
|
2. Fix violations
|
|
210
210
|
3. Re-run tests + build
|
|
211
211
|
4. GOTO 1 (until score ≥ B)
|
|
@@ -257,10 +257,10 @@ LOOP:
|
|
|
257
257
|
| When | Use |
|
|
258
258
|
|------|-----|
|
|
259
259
|
| Designing the API contract from scratch | `@api-designer` agent |
|
|
260
|
-
| Adding the endpoint as part of a larger feature | `/feature
|
|
261
|
-
| Writing tests for the endpoint | `/review
|
|
262
|
-
| Documenting the full API surface | `/docs
|
|
263
|
-
| Reviewing architecture compliance | `/review
|
|
260
|
+
| Adding the endpoint as part of a larger feature | `/feature-new` (calls this internally) |
|
|
261
|
+
| Writing tests for the endpoint | `/review-tdd` |
|
|
262
|
+
| Documenting the full API surface | `/docs-write` |
|
|
263
|
+
| Reviewing architecture compliance | `/review-architect` |
|
|
264
264
|
|
|
265
265
|
---
|
|
266
266
|
|
|
@@ -255,10 +255,10 @@ class OldWidget { ... }
|
|
|
255
255
|
|
|
256
256
|
| When | Use |
|
|
257
257
|
|------|-----|
|
|
258
|
-
| Adding the replacement first | `/feature
|
|
258
|
+
| Adding the replacement first | `/feature-new` |
|
|
259
259
|
| Restructuring the code that uses the deprecated thing | `refactor` |
|
|
260
|
-
| Documenting the migration guide | `/docs
|
|
261
|
-
| Reviewing the removal PR | `/review
|
|
260
|
+
| Documenting the migration guide | `/docs-write` |
|
|
261
|
+
| Reviewing the removal PR | `/review-pr` |
|
|
262
262
|
|
|
263
263
|
---
|
|
264
264
|
|
|
@@ -15,9 +15,9 @@ Build a new feature following DDD layers with rule checks per phase and a final
|
|
|
15
15
|
- ✅ Feature spans multiple DDD layers (domain + app + infra)
|
|
16
16
|
- ✅ The approach is well-understood (no major research / prototype needed)
|
|
17
17
|
- ✅ You want automated architecture review at the end
|
|
18
|
-
- ❌ Quick bug fix → use `/fix
|
|
19
|
-
- ❌ Don't know the right approach yet → `/research
|
|
20
|
-
- ❌ Restructuring existing code → use `/feature
|
|
18
|
+
- ❌ Quick bug fix → use `/fix-hotfix`
|
|
19
|
+
- ❌ Don't know the right approach yet → `/research-web` or `/research-spike` first
|
|
20
|
+
- ❌ Restructuring existing code → use `/feature-refactor`
|
|
21
21
|
|
|
22
22
|
## Read Architecture First
|
|
23
23
|
|
|
@@ -205,7 +205,7 @@ Build in order: **value objects → entities → events → ports → usecases**
|
|
|
205
205
|
|
|
206
206
|
```
|
|
207
207
|
LOOP:
|
|
208
|
-
1. /review
|
|
208
|
+
1. /review-architect {stack} {domain}
|
|
209
209
|
2. IF violations severity ≥ MEDIUM:
|
|
210
210
|
fix all → build → tests → GOTO 1
|
|
211
211
|
3. IF score ≥ B → BREAK
|
|
@@ -253,12 +253,12 @@ LOOP:
|
|
|
253
253
|
|
|
254
254
|
| When | Use |
|
|
255
255
|
|------|-----|
|
|
256
|
-
| Don't know approach yet | `/research
|
|
257
|
-
| Want to validate by prototyping | `/research
|
|
258
|
-
| Adding only an endpoint | `/feature
|
|
259
|
-
| Restructuring existing module | `/feature
|
|
260
|
-
| Architecture check (called automatically in Phase 7) | `/review
|
|
261
|
-
| Write tests inline (TDD style) | `/review
|
|
256
|
+
| Don't know approach yet | `/research-web` → then this skill |
|
|
257
|
+
| Want to validate by prototyping | `/research-spike` → then this skill |
|
|
258
|
+
| Adding only an endpoint | `/feature-api` |
|
|
259
|
+
| Restructuring existing module | `/feature-refactor` |
|
|
260
|
+
| Architecture check (called automatically in Phase 7) | `/review-architect` |
|
|
261
|
+
| Write tests inline (TDD style) | `/review-tdd` |
|
|
262
262
|
|
|
263
263
|
## Recommended Agents
|
|
264
264
|
|
|
@@ -15,9 +15,9 @@ Restructure existing code into DDD layers, or fix drift in an existing DDD modul
|
|
|
15
15
|
- ✅ Migrating a legacy module into DDD layers
|
|
16
16
|
- ✅ Existing DDD module has drifted (fat controller, anemic entity, mixed concerns)
|
|
17
17
|
- ✅ Splitting one domain into multiple bounded contexts
|
|
18
|
-
- ❌ Building a brand-new feature → use `/feature
|
|
18
|
+
- ❌ Building a brand-new feature → use `/feature-new`
|
|
19
19
|
- ❌ Just renaming files / variables → just do it
|
|
20
|
-
- ❌ Fixing a bug → use `/fix
|
|
20
|
+
- ❌ Fixing a bug → use `/fix-hotfix` or `/fix-root-cause`
|
|
21
21
|
|
|
22
22
|
## Read Architecture First
|
|
23
23
|
|
|
@@ -196,11 +196,11 @@ grep -r "{old_import_path}" --include="*.{ext}" . && echo "FAIL: stale imports"
|
|
|
196
196
|
|
|
197
197
|
## Review Loop
|
|
198
198
|
|
|
199
|
-
After Phase 6, call `/review
|
|
199
|
+
After Phase 6, call `/review-architect {stack} {domain}`. Loop until score ≥ B.
|
|
200
200
|
|
|
201
201
|
```
|
|
202
202
|
LOOP:
|
|
203
|
-
1. /review
|
|
203
|
+
1. /review-architect {stack} {domain}
|
|
204
204
|
2. IF violations severity ≥ MEDIUM:
|
|
205
205
|
fix all → full build → all tests → GOTO 1
|
|
206
206
|
3. IF score ≥ B → BREAK
|
|
@@ -252,10 +252,10 @@ LOOP:
|
|
|
252
252
|
|
|
253
253
|
| When | Use |
|
|
254
254
|
|------|-----|
|
|
255
|
-
| Building from scratch (no existing code) | `/feature
|
|
256
|
-
| Just adding tests to untested code | `/review
|
|
257
|
-
| Reviewing the refactor before merging | `/review
|
|
258
|
-
| Final architecture check (called automatically in review loop) | `/review
|
|
255
|
+
| Building from scratch (no existing code) | `/feature-new` |
|
|
256
|
+
| Just adding tests to untested code | `/review-tdd` |
|
|
257
|
+
| Reviewing the refactor before merging | `/review-branch` |
|
|
258
|
+
| Final architecture check (called automatically in review loop) | `/review-architect` |
|
|
259
259
|
|
|
260
260
|
## Recommended Agents
|
|
261
261
|
|
|
@@ -12,9 +12,9 @@ Fast-track bug fix with a rollback plan. Use when the cause is identifiable in u
|
|
|
12
12
|
- ✅ Bug is reproducible and root cause is clear (or quickly identifiable)
|
|
13
13
|
- ✅ Need a fix shipped fast with a rollback plan
|
|
14
14
|
- ✅ Severity ranges from low (minor UI) to high (feature broken)
|
|
15
|
-
- ❌ Production is down right now → use `/fix
|
|
16
|
-
- ❌ Bug has been "fixed" multiple times and keeps returning → use `/fix
|
|
17
|
-
- ❌ Building a new feature → use `/feature
|
|
15
|
+
- ❌ Production is down right now → use `/fix-incident` first
|
|
16
|
+
- ❌ Bug has been "fixed" multiple times and keeps returning → use `/fix-root-cause`
|
|
17
|
+
- ❌ Building a new feature → use `/feature-new`
|
|
18
18
|
|
|
19
19
|
## Read Architecture First
|
|
20
20
|
|
|
@@ -22,7 +22,7 @@ Read `ddd-architecture.md` + stack-specific doc — the fix must land in the rig
|
|
|
22
22
|
|
|
23
23
|
## Severity
|
|
24
24
|
|
|
25
|
-
Use `~/.claude/architecture/_shared/severity-levels.md` (incident table). Hotfix typically covers P2-P4. P1 → start with `/fix
|
|
25
|
+
Use `~/.claude/architecture/_shared/severity-levels.md` (incident table). Hotfix typically covers P2-P4. P1 → start with `/fix-incident` for triage / comms.
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
@@ -61,7 +61,7 @@ IDENTIFY → REPRODUCE → FIX → VERIFY → DEPLOY
|
|
|
61
61
|
- [ ] Error captured verbatim
|
|
62
62
|
- [ ] Reproduction steps known (or "intermittent" noted)
|
|
63
63
|
- [ ] Severity assigned (P2 / P3 / P4)
|
|
64
|
-
- [ ] Root cause identified (use `/fix
|
|
64
|
+
- [ ] Root cause identified (use `/fix-root-cause` if 5 Whys doesn't converge)
|
|
65
65
|
|
|
66
66
|
---
|
|
67
67
|
|
|
@@ -91,7 +91,7 @@ IDENTIFY → REPRODUCE → FIX → VERIFY → DEPLOY
|
|
|
91
91
|
### Rules
|
|
92
92
|
- Fix at the **root cause**, not the symptom
|
|
93
93
|
- Land the fix in the right layer (boundary validation → handler/DTO; business rule → usecase; data shape → infra mapper)
|
|
94
|
-
- **Add a regression test first** (RED), then make it pass (GREEN). See `/review
|
|
94
|
+
- **Add a regression test first** (RED), then make it pass (GREEN). See `/review-tdd`.
|
|
95
95
|
- Don't refactor on the fix — separate PR
|
|
96
96
|
- If the fix requires schema migration, plan it as 2 deploys (compatible code first, then migration)
|
|
97
97
|
|
|
@@ -131,7 +131,7 @@ For data-shape bugs (null where not expected, type mismatch from external API):
|
|
|
131
131
|
## Phase 5: DEPLOY
|
|
132
132
|
|
|
133
133
|
### Pre-deploy checklist
|
|
134
|
-
- [ ] PR reviewed (`/review
|
|
134
|
+
- [ ] PR reviewed (`/review-branch` self + `/review-pr` from teammate)
|
|
135
135
|
- [ ] Rollback plan documented (see below)
|
|
136
136
|
- [ ] On-call notified
|
|
137
137
|
- [ ] CHANGELOG entry
|
|
@@ -215,11 +215,11 @@ Document **before** deploying:
|
|
|
215
215
|
|
|
216
216
|
| When | Use |
|
|
217
217
|
|------|-----|
|
|
218
|
-
| Production is down right now | `/fix
|
|
219
|
-
| Bug keeps coming back after fixes | `/fix
|
|
220
|
-
| Need to write regression test first | `/review
|
|
221
|
-
| Bug is on an open PR | `/fix
|
|
222
|
-
| Self-review before opening PR | `/review
|
|
218
|
+
| Production is down right now | `/fix-incident` first, then hotfix |
|
|
219
|
+
| Bug keeps coming back after fixes | `/fix-root-cause` |
|
|
220
|
+
| Need to write regression test first | `/review-tdd` |
|
|
221
|
+
| Bug is on an open PR | `/fix-pr-comment` |
|
|
222
|
+
| Self-review before opening PR | `/review-branch` |
|
|
223
223
|
|
|
224
224
|
## Recommended Agents
|
|
225
225
|
|
|
@@ -12,8 +12,8 @@ Structured workflow for handling production incidents from triage to postmortem.
|
|
|
12
12
|
- ✅ Production is down or degraded right now
|
|
13
13
|
- ✅ Users are impacted, on-call has been paged
|
|
14
14
|
- ✅ Need to coordinate response, mitigation, comms, and postmortem
|
|
15
|
-
- ❌ Bug is reported but no users impacted → use `/fix
|
|
16
|
-
- ❌ Already mitigated, need to find root cause → use `/fix
|
|
15
|
+
- ❌ Bug is reported but no users impacted → use `/fix-hotfix`
|
|
16
|
+
- ❌ Already mitigated, need to find root cause → use `/fix-root-cause`
|
|
17
17
|
- ❌ Postmortem only, no active incident → jump to Phase 5
|
|
18
18
|
|
|
19
19
|
---
|
|
@@ -205,7 +205,7 @@ Live walkthrough (5-10 min): outgoing IC walks incoming IC through the timeline
|
|
|
205
205
|
**Goal:** apply the permanent fix and verify.
|
|
206
206
|
|
|
207
207
|
### Actions
|
|
208
|
-
1. Confirm root cause (use `/fix
|
|
208
|
+
1. Confirm root cause (use `/fix-root-cause` workflow if not obvious)
|
|
209
209
|
2. Implement permanent fix following stack architecture
|
|
210
210
|
3. Add test that would have caught this
|
|
211
211
|
4. Deploy fix through normal pipeline (don't skip CI even under pressure — unless explicitly authorized)
|
|
@@ -340,10 +340,10 @@ Postmortem: {date} — link to come
|
|
|
340
340
|
|
|
341
341
|
| When | Use |
|
|
342
342
|
|------|-----|
|
|
343
|
-
| Bug reported but no active incident | `/fix
|
|
344
|
-
| Root cause unclear, need deep investigation | `/fix
|
|
343
|
+
| Bug reported but no active incident | `/fix-hotfix` |
|
|
344
|
+
| Root cause unclear, need deep investigation | `/fix-root-cause` |
|
|
345
345
|
| Need to roll back deployment | (use ops runbook, not a skill) |
|
|
346
|
-
| Documenting postmortem as a doc | `/docs
|
|
346
|
+
| Documenting postmortem as a doc | `/docs-write` |
|
|
347
347
|
|
|
348
348
|
---
|
|
349
349
|
|
|
@@ -15,9 +15,9 @@ Fetch all review comments on an open PR, address each, push, and respond back to
|
|
|
15
15
|
- ✅ Reviewer left comments and you need to address each one
|
|
16
16
|
- ✅ Want to track which comments are resolved vs still open
|
|
17
17
|
- ✅ Need structured responses posted back to GitHub
|
|
18
|
-
- ❌ You are the reviewer → use `/review
|
|
19
|
-
- ❌ No PR yet → use `/review
|
|
20
|
-
- ❌ Fix is a brand-new bug surfaced by reviewer → `/fix
|
|
18
|
+
- ❌ You are the reviewer → use `/review-pr`
|
|
19
|
+
- ❌ No PR yet → use `/review-branch`
|
|
20
|
+
- ❌ Fix is a brand-new bug surfaced by reviewer → `/fix-hotfix` first, then this skill
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -86,15 +86,15 @@ Build a triage table:
|
|
|
86
86
|
- Fix in order: must-fix → should-fix → discussion outcomes
|
|
87
87
|
- One concern per commit (`fix(handler): validate input in DTO per #pr-comment-1`)
|
|
88
88
|
- After each batch: run build + lint + tests locally
|
|
89
|
-
- Re-run `/review
|
|
89
|
+
- Re-run `/review-branch` before pushing
|
|
90
90
|
|
|
91
91
|
### When the fix changes architecture
|
|
92
|
-
If a comment requests something structural (move logic between layers, add a port), use `/feature
|
|
92
|
+
If a comment requests something structural (move logic between layers, add a port), use `/feature-refactor` for that subtree, then come back here to respond.
|
|
93
93
|
|
|
94
94
|
### Gate
|
|
95
95
|
- [ ] All must-fix items addressed
|
|
96
96
|
- [ ] Build + lint + tests green
|
|
97
|
-
- [ ] Self-review with `/review
|
|
97
|
+
- [ ] Self-review with `/review-branch` clean
|
|
98
98
|
|
|
99
99
|
---
|
|
100
100
|
|
|
@@ -162,7 +162,7 @@ gh pr edit $PR --add-reviewer {original_reviewer}
|
|
|
162
162
|
- **Reply to every comment** — silence reads as ignoring
|
|
163
163
|
- **Push back politely** when you have a real reason; never just close threads
|
|
164
164
|
- **One concern per commit** — easier for reviewer to verify
|
|
165
|
-
- **Run `/review
|
|
165
|
+
- **Run `/review-branch` before pushing** — catch easy issues before reviewer round 2
|
|
166
166
|
- **Don't argue style** when the team has a linter — let the tool decide
|
|
167
167
|
|
|
168
168
|
---
|
|
@@ -171,10 +171,10 @@ gh pr edit $PR --add-reviewer {original_reviewer}
|
|
|
171
171
|
|
|
172
172
|
| When | Use |
|
|
173
173
|
|------|-----|
|
|
174
|
-
| You are the reviewer | `/review
|
|
175
|
-
| Self-review before pushing again | `/review
|
|
176
|
-
| Reviewer asked for architectural refactor | `/feature
|
|
177
|
-
| Reviewer surfaced a bug needing investigation | `/fix
|
|
174
|
+
| You are the reviewer | `/review-pr` |
|
|
175
|
+
| Self-review before pushing again | `/review-branch` |
|
|
176
|
+
| Reviewer asked for architectural refactor | `/feature-refactor` |
|
|
177
|
+
| Reviewer surfaced a bug needing investigation | `/fix-root-cause` |
|
|
178
178
|
|
|
179
179
|
## Recommended Agents
|
|
180
180
|
|
|
@@ -14,8 +14,8 @@ For bugs that have been "fixed" multiple times and keep coming back, intermitten
|
|
|
14
14
|
- ✅ Error inside vendor / framework internals
|
|
15
15
|
- ✅ Local vs production behavior differs
|
|
16
16
|
- ✅ Race condition / concurrency suspected
|
|
17
|
-
- ❌ Bug is well understood, just needs a fix → `/fix
|
|
18
|
-
- ❌ Production is down with user impact → `/fix
|
|
17
|
+
- ❌ Bug is well understood, just needs a fix → `/fix-hotfix`
|
|
18
|
+
- ❌ Production is down with user impact → `/fix-incident` first, then this skill
|
|
19
19
|
|
|
20
20
|
---
|
|
21
21
|
|
|
@@ -259,10 +259,10 @@ For data-shape bugs from external sources: validate / coerce at the adapter, not
|
|
|
259
259
|
|
|
260
260
|
| When | Use |
|
|
261
261
|
|------|-----|
|
|
262
|
-
| Bug is understood, just needs a fix | `/fix
|
|
263
|
-
| Production is down | `/fix
|
|
264
|
-
| Write regression test after fix | `/review
|
|
265
|
-
| Research how others solved similar bugs | `/research
|
|
262
|
+
| Bug is understood, just needs a fix | `/fix-hotfix` |
|
|
263
|
+
| Production is down | `/fix-incident` (then this skill after mitigation) |
|
|
264
|
+
| Write regression test after fix | `/review-tdd` |
|
|
265
|
+
| Research how others solved similar bugs | `/research-web` |
|
|
266
266
|
|
|
267
267
|
## Recommended Agents
|
|
268
268
|
|
|
@@ -12,9 +12,9 @@ Workflow for creating content strategy: audience research, content pillars, SEO
|
|
|
12
12
|
- ✅ Building a content strategy from scratch (pillars, calendar, channels)
|
|
13
13
|
- ✅ Writing one specific piece (blog post, newsletter, social thread)
|
|
14
14
|
- ✅ Repurposing one piece into multi-channel content
|
|
15
|
-
- ❌ Writing API / project documentation → use `/docs
|
|
15
|
+
- ❌ Writing API / project documentation → use `/docs-write` or `/docs-sync`
|
|
16
16
|
- ❌ Writing release notes / changelog → use git history + manual
|
|
17
|
-
- ❌ Designing a video → use `/marketing
|
|
17
|
+
- ❌ Designing a video → use `/marketing-video`
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
@@ -251,10 +251,10 @@ SIGNATURE
|
|
|
251
251
|
|
|
252
252
|
| When | Use |
|
|
253
253
|
|------|-----|
|
|
254
|
-
| Building brand identity (logo + colors) | `/marketing
|
|
255
|
-
| Creating video scripts / storyboards | `/marketing
|
|
254
|
+
| Building brand identity (logo + colors) | `/marketing-logo` |
|
|
255
|
+
| Creating video scripts / storyboards | `/marketing-video` |
|
|
256
256
|
| Building a full marketing plan | `/marketing` (combines all three) |
|
|
257
|
-
| Writing project documentation | `/docs
|
|
257
|
+
| Writing project documentation | `/docs-write` |
|
|
258
258
|
|
|
259
259
|
---
|
|
260
260
|
|
|
@@ -14,7 +14,7 @@ Produce a logo + brand identity **specification** that a designer can execute (o
|
|
|
14
14
|
- ✅ Need a deliverable spec for a designer to execute
|
|
15
15
|
- ❌ Just need a quick icon variation → use a design tool directly
|
|
16
16
|
- ❌ Full marketing plan (logo + content + video) → use `/marketing`
|
|
17
|
-
- ❌ Video-specific visuals → use `/marketing
|
|
17
|
+
- ❌ Video-specific visuals → use `/marketing-video`
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
@@ -238,9 +238,9 @@ Pick 1 display + 1 body font (or 1 font in 2 weights). Note:
|
|
|
238
238
|
| When | Use |
|
|
239
239
|
|------|-----|
|
|
240
240
|
| Full marketing plan (logo + content + video) | `/marketing` |
|
|
241
|
-
| Write content with the brand | `/marketing
|
|
242
|
-
| Create video with the brand | `/marketing
|
|
243
|
-
| Document brand guidelines as a doc | `/docs
|
|
241
|
+
| Write content with the brand | `/marketing-content` |
|
|
242
|
+
| Create video with the brand | `/marketing-video` |
|
|
243
|
+
| Document brand guidelines as a doc | `/docs-write` |
|
|
244
244
|
|
|
245
245
|
## Recommended Agents
|
|
246
246
|
|
|
@@ -12,7 +12,7 @@ Write **one** evergreen blog post that ranks on traditional search AND is easy f
|
|
|
12
12
|
- ✅ Writing a single evergreen blog post (entity / trust / compare / glossary / use-case / FAQ)
|
|
13
13
|
- ✅ Updating an existing evergreen post that has drifted
|
|
14
14
|
- ✅ Replacing a thin / outdated post with a stronger version on the same intent
|
|
15
|
-
- ❌ Multi-post content plan / calendar / strategy → use `/marketing
|
|
15
|
+
- ❌ Multi-post content plan / calendar / strategy → use `/marketing-content`
|
|
16
16
|
- ❌ Changelog / feature launch / release announcement → write manually or use a feature-blog template
|
|
17
17
|
- ❌ Time-sensitive news / event post → not evergreen, different rules
|
|
18
18
|
|
|
@@ -350,11 +350,11 @@ head -30 {blog_dir}/{slug}.md
|
|
|
350
350
|
|
|
351
351
|
| When | Use |
|
|
352
352
|
|------|-----|
|
|
353
|
-
| Multi-post content plan / calendar / strategy | `/marketing
|
|
354
|
-
| Brand voice / visual identity setup first | `/marketing
|
|
355
|
-
| Video / shorts version of the post | `/marketing
|
|
353
|
+
| Multi-post content plan / calendar / strategy | `/marketing-content` |
|
|
354
|
+
| Brand voice / visual identity setup first | `/marketing-logo` |
|
|
355
|
+
| Video / shorts version of the post | `/marketing-video` |
|
|
356
356
|
| Full go-to-market plan (logo + content + video) | `/marketing` command |
|
|
357
|
-
| Writing technical project docs (not blog) | `/docs
|
|
357
|
+
| Writing technical project docs (not blog) | `/docs-write` |
|
|
358
358
|
|
|
359
359
|
## Recommended Agents
|
|
360
360
|
|
|
@@ -14,7 +14,7 @@ Plan video content end-to-end: strategy, script, storyboard, production spec, pu
|
|
|
14
14
|
- ✅ Repurposing existing long-form into shorts / clips
|
|
15
15
|
- ❌ Just need ideas, not a plan → use `brainstorm`
|
|
16
16
|
- ❌ Want full marketing plan (logo + content + video) → use `/marketing`
|
|
17
|
-
- ❌ Writing a blog post or thread → use `/marketing
|
|
17
|
+
- ❌ Writing a blog post or thread → use `/marketing-content`
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
@@ -241,8 +241,8 @@ CTA (≤10 sec)
|
|
|
241
241
|
| When | Use |
|
|
242
242
|
|------|-----|
|
|
243
243
|
| Full marketing plan (logo + content + video) | `/marketing` |
|
|
244
|
-
| Need brand visuals first | `/marketing
|
|
245
|
-
| Repurpose video → blog / threads | `/marketing
|
|
244
|
+
| Need brand visuals first | `/marketing-logo` |
|
|
245
|
+
| Repurpose video → blog / threads | `/marketing-content` |
|
|
246
246
|
| Brainstorm video topics | `brainstorm` |
|
|
247
247
|
|
|
248
248
|
---
|
|
@@ -12,8 +12,8 @@ Ramp up on a new codebase quickly: structure, conventions, where things live, ho
|
|
|
12
12
|
- ✅ Just joined a project / repo and need to ramp up
|
|
13
13
|
- ✅ Returning to a codebase you haven't touched in months
|
|
14
14
|
- ✅ Need to give a teammate a structured walkthrough
|
|
15
|
-
- ❌ Want to generate full docs site → use `/docs
|
|
16
|
-
- ❌ Need to fix a specific bug → use `/fix
|
|
15
|
+
- ❌ Want to generate full docs site → use `/docs-sync`
|
|
16
|
+
- ❌ Need to fix a specific bug → use `/fix-hotfix` / `/fix-root-cause`
|
|
17
17
|
- ❌ Only want a quick file lookup → just use `grep` / `find`
|
|
18
18
|
|
|
19
19
|
## Read Architecture First
|
|
@@ -158,7 +158,7 @@ git shortlog -sn --since=3months | head -10
|
|
|
158
158
|
- [ ] Followed naming + error-handling conventions
|
|
159
159
|
- [ ] Commit message matches project style (`git log --oneline`)
|
|
160
160
|
- [ ] PR description follows template (check `.github/PULL_REQUEST_TEMPLATE.md`)
|
|
161
|
-
- [ ] Self-reviewed with `/review
|
|
161
|
+
- [ ] Self-reviewed with `/review-branch` before opening PR
|
|
162
162
|
|
|
163
163
|
### Who to ask
|
|
164
164
|
- Architecture / "why is it like this": {tech lead from git shortlog}
|
|
@@ -208,10 +208,10 @@ git shortlog -sn --since=3months | head -10
|
|
|
208
208
|
|
|
209
209
|
| When | Use |
|
|
210
210
|
|------|-----|
|
|
211
|
-
| Generate full doc site after onboarding | `/docs
|
|
212
|
-
| Build first real feature after onboarding | `/feature
|
|
213
|
-
| First bug fix to learn the codebase | `/fix
|
|
214
|
-
| Author / update the onboarding doc itself | `/docs
|
|
211
|
+
| Generate full doc site after onboarding | `/docs-sync` |
|
|
212
|
+
| Build first real feature after onboarding | `/feature-new` |
|
|
213
|
+
| First bug fix to learn the codebase | `/fix-hotfix` |
|
|
214
|
+
| Author / update the onboarding doc itself | `/docs-write` |
|
|
215
215
|
|
|
216
216
|
## Recommended Agents
|
|
217
217
|
|