claude-code-arcane 2.9.8 → 2.10.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/CHANGELOG.md +26 -0
- package/README.md +40 -38
- package/agents/business/business-ops-lead.md +1 -14
- package/agents/game/gameplay-programmer.md +3 -4
- package/agents/game/technical-artist.md +3 -4
- package/dist/cli.js +105 -39
- package/docs/USER-GUIDE.md +24 -22
- package/docs/coordination-rules.md +1 -1
- package/docs/directory-structure.md +93 -122
- package/package.json +1 -1
- package/profiles/ai.yaml +3 -0
- package/profiles/android-native.yaml +2 -0
- package/profiles/backend-go.yaml +1 -8
- package/profiles/backend-ts.yaml +2 -8
- package/profiles/backend-typescript.yaml +51 -0
- package/profiles/flutter.yaml +2 -0
- package/profiles/frontend-react-vite.yaml +39 -0
- package/profiles/frontend.yaml +2 -0
- package/profiles/integrations.yaml +6 -1
- package/profiles/ios-native.yaml +2 -0
- package/profiles/mobile-android-kotlin.yaml +36 -0
- package/profiles/mobile-flutter.yaml +37 -0
- package/profiles/mobile-ios-swift.yaml +37 -0
- package/profiles/mobile-react-native.yaml +39 -0
- package/profiles/mobile.yaml +2 -0
- package/rules/gamedev/engine-code.md +1 -1
- package/rules/gamedev/shader-code.md +1 -2
- package/rules/gamedev/vn-code.md +3 -2
- package/rules/implementation-workflow.md +1 -1
- package/rules/{ai-code.md → llm-code.md} +5 -5
- package/skills/agent-designer/README.md +2 -1
- package/skills/agent-designer/agent_evaluator.py +0 -5
- package/skills/ai-sdk-setup/SKILL.md +4 -4
- package/skills/arcane-add/SKILL.md +1 -1
- package/skills/arcane-list/SKILL.md +3 -3
- package/skills/arcane-status/SKILL.md +1 -1
- package/skills/architecture-decision/SKILL.md +3 -4
- package/skills/architecture-review/SKILL.md +1 -1
- package/skills/asset-audit/SKILL.md +0 -1
- package/skills/balance-check/SKILL.md +1 -1
- package/skills/brainstorm/SKILL.md +3 -3
- package/skills/brainstorm/references/next-steps-pipeline.md +8 -9
- package/skills/consistency-check/SKILL.md +2 -2
- package/skills/design-system/SKILL.md +1 -1
- package/skills/design-system/references/post-design-validation.md +2 -3
- package/skills/freelance-kickoff/SKILL.md +1 -1
- package/skills/frontend-dev/SKILL.md +27 -28
- package/skills/frontend-dev/references/asset-prompt-guide.md +1 -1
- package/skills/frontend-dev/references/motion-recipes.md +1 -1
- package/skills/help/SKILL.md +1 -2
- package/skills/hotfix/SKILL.md +2 -2
- package/skills/milestone-review/SKILL.md +1 -1
- package/skills/patch-notes/SKILL.md +1 -1
- package/skills/playtest-report/SKILL.md +2 -3
- package/skills/playwright-pro/CLAUDE.md +2 -2
- package/skills/playwright-pro/SKILL.md +13 -9
- package/skills/playwright-pro/agents/migration-planner.md +2 -2
- package/skills/playwright-pro/agents/test-architect.md +1 -2
- package/skills/playwright-pro/agents/test-debugger.md +1 -1
- package/skills/playwright-pro/hooks/detect-playwright.sh +1 -1
- package/skills/playwright-pro/skills/browserstack/SKILL.md +5 -5
- package/skills/playwright-pro/skills/migrate/SKILL.md +1 -1
- package/skills/playwright-pro/skills/report/SKILL.md +2 -2
- package/skills/playwright-pro/skills/testrail/SKILL.md +5 -5
- package/skills/playwright-pro/templates/README.md +2 -2
- package/skills/prototype/SKILL.md +1 -1
- package/skills/quick-design/SKILL.md +1 -1
- package/skills/release-checklist/SKILL.md +0 -1
- package/skills/security-audit/SKILL.md +1 -1
- package/skills/self-improving-agent/CLAUDE.md +12 -12
- package/skills/self-improving-agent/SKILL.md +16 -12
- package/skills/self-improving-agent/agents/memory-analyst.md +1 -1
- package/skills/self-improving-agent/hooks/error-capture.sh +2 -2
- package/skills/self-improving-agent/reference/memory-architecture.md +2 -2
- package/skills/self-improving-agent/reference/promotion-rules.md +3 -3
- package/skills/self-improving-agent/reference/rules-directory-patterns.md +1 -1
- package/skills/self-improving-agent/settings.json +5 -5
- package/skills/self-improving-agent/skills/extract/SKILL.md +7 -7
- package/skills/self-improving-agent/skills/promote/SKILL.md +5 -5
- package/skills/self-improving-agent/skills/remember/SKILL.md +9 -9
- package/skills/self-improving-agent/skills/review/SKILL.md +7 -7
- package/skills/self-improving-agent/skills/status/SKILL.md +8 -8
- package/skills/senior-ml-engineer/references/llm_integration_guide.md +14 -31
- package/skills/senior-prompt-engineer/SKILL.md +10 -10
- package/skills/senior-prompt-engineer/references/prompt_engineering_patterns.md +1 -1
- package/skills/senior-prompt-engineer/scripts/agent_orchestrator.py +43 -40
- package/skills/senior-prompt-engineer/scripts/prompt_optimizer.py +23 -66
- package/skills/shader-dev/reference/fluid-simulation.md +4 -4
- package/skills/shader-dev/reference/simulation-physics.md +6 -6
- package/skills/shader-dev/reference/voxel-rendering.md +1 -1
- package/skills/shader-dev/techniques/ambient-occlusion.md +1 -1
- package/skills/shader-dev/techniques/analytic-ray-tracing.md +2 -2
- package/skills/shader-dev/techniques/domain-warping.md +2 -2
- package/skills/shader-dev/techniques/fluid-simulation.md +45 -45
- package/skills/shader-dev/techniques/multipass-buffer.md +24 -24
- package/skills/shader-dev/techniques/normal-estimation.md +1 -1
- package/skills/shader-dev/techniques/particle-system.md +16 -16
- package/skills/shader-dev/techniques/polar-uv-manipulation.md +1 -1
- package/skills/shader-dev/techniques/post-processing.md +7 -7
- package/skills/shader-dev/techniques/sdf-3d.md +1 -1
- package/skills/shader-dev/techniques/simulation-physics.md +24 -24
- package/skills/shader-dev/techniques/sound-synthesis.md +2 -2
- package/skills/shader-dev/techniques/voronoi-cellular-noise.md +1 -1
- package/skills/shader-dev/techniques/voxel-rendering.md +60 -60
- package/skills/smoke-check/SKILL.md +1 -1
- package/skills/sprint-plan/SKILL.md +1 -2
- package/skills/start/SKILL.md +7 -7
- package/skills/story-done/SKILL.md +1 -1
- package/skills/test-helpers/SKILL.md +7 -2
- package/skills/test-setup/SKILL.md +1 -1
- package/skills/ue-actor-component-architecture/SKILL.md +0 -1
- package/skills/ue-ai-navigation/SKILL.md +0 -1
- package/skills/ue-animation-system/SKILL.md +0 -1
- package/skills/ue-async-threading/SKILL.md +0 -1
- package/skills/ue-audio-system/SKILL.md +0 -1
- package/skills/ue-blueprints/SKILL.md +0 -1
- package/skills/ue-character-movement/SKILL.md +0 -1
- package/skills/ue-cpp-foundations/SKILL.md +0 -1
- package/skills/ue-data-assets-tables/SKILL.md +0 -1
- package/skills/ue-editor-tools/SKILL.md +0 -1
- package/skills/ue-game-features/SKILL.md +0 -1
- package/skills/ue-gameplay-abilities/SKILL.md +0 -1
- package/skills/ue-gameplay-framework/SKILL.md +0 -1
- package/skills/ue-input-system/SKILL.md +0 -1
- package/skills/ue-mass-entity/SKILL.md +0 -1
- package/skills/ue-materials-rendering/SKILL.md +0 -1
- package/skills/ue-module-build-system/SKILL.md +0 -1
- package/skills/ue-naming-conventions/SKILL.md +0 -1
- package/skills/ue-networking-replication/SKILL.md +0 -1
- package/skills/ue-niagara-effects/SKILL.md +0 -1
- package/skills/ue-packaging/SKILL.md +0 -1
- package/skills/ue-physics-collision/SKILL.md +0 -1
- package/skills/ue-procedural-generation/SKILL.md +0 -1
- package/skills/ue-project-context/SKILL.md +0 -1
- package/skills/ue-sequencer-cinematics/SKILL.md +0 -1
- package/skills/ue-serialization-savegames/SKILL.md +0 -1
- package/skills/ue-state-trees/SKILL.md +0 -1
- package/skills/ue-testing-debugging/SKILL.md +0 -1
- package/skills/ue-ui-umg-slate/SKILL.md +0 -1
- package/skills/ue-world-level-streaming/SKILL.md +0 -1
- package/skills/ux-review/SKILL.md +1 -1
- package/docs/RELEASE-SETUP.md +0 -99
- package/docs/presentations/arcane-overview-12.pptx +0 -0
- package/docs/presentations/arcane-overview.pptx +0 -0
- package/docs/presentations/build_arcane_deck.py +0 -310
- package/docs/presentations/build_arcane_deck_12.py +0 -399
- package/docs/trusted-publishing-setup.md +0 -163
|
@@ -25,7 +25,7 @@ Read: `production/releases/[version]/changelog.md`, `docs/CHANGELOG.md` entry, `
|
|
|
25
25
|
|
|
26
26
|
Check for tone/voice guidance in: `.claude/docs/technical-preferences.md`, `docs/PATCH-NOTES-STYLE.md`, `design/community/tone-guide.md`. Default: player-friendly, non-technical, enthusiastic not hyperbolic, focus on player experience.
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
Use the project's own template at `docs/patch-notes-template.md` if it exists; otherwise `.claude/docs/templates/release-notes.md` (player-facing: headline, what's new, gameplay changes, fixes). Either one replaces the built-in styles.
|
|
29
29
|
|
|
30
30
|
## Phase 3: Categorize and Translate
|
|
31
31
|
|
|
@@ -9,7 +9,7 @@ allowed-tools: Read, Glob, Grep, Write, Task, AskUserQuestion
|
|
|
9
9
|
|
|
10
10
|
## Phase 1: Parse Arguments
|
|
11
11
|
|
|
12
|
-
Resolve review mode: `--review` arg > `production/review-mode.txt` > default `lean`.
|
|
12
|
+
Resolve review mode: `--review` arg > `production/review-mode.txt` > default `lean`.
|
|
13
13
|
|
|
14
14
|
Modes: `new` → blank template, `analyze [path]` → structured findings from raw notes.
|
|
15
15
|
|
|
@@ -25,7 +25,7 @@ Read raw notes. Cross-reference with design documents. Fill template with struct
|
|
|
25
25
|
|
|
26
26
|
| Bucket | Route |
|
|
27
27
|
|--------|-------|
|
|
28
|
-
| Design changes | `/
|
|
28
|
+
| Design changes | Update the GDD, then `/consistency-check` for downstream impacts |
|
|
29
29
|
| Balance adjustments | `/balance-check [system]` before tuning |
|
|
30
30
|
| Bugs | `/bug-report` to formally track |
|
|
31
31
|
| Polish items | Add to `production/` polish backlog |
|
|
@@ -41,5 +41,4 @@ Ask to write to `production/qa/playtests/playtest-[date]-[tester].md`.
|
|
|
41
41
|
## Phase 5: Next Steps
|
|
42
42
|
|
|
43
43
|
- Act on highest-priority finding category first
|
|
44
|
-
- Design changes → `/design-review` on updated GDD
|
|
45
44
|
- Bugs → `/bug-triage` to update priorities
|
|
@@ -67,8 +67,8 @@ Leverage Claude Code's built-in capabilities:
|
|
|
67
67
|
|
|
68
68
|
- **Large migrations**: Use `/batch` for parallel file-by-file conversion
|
|
69
69
|
- **Post-generation cleanup**: Use `/simplify` after generating a test suite
|
|
70
|
-
- **Debugging sessions**: Use `/debug` alongside `/
|
|
71
|
-
- **Code review**: Use `/review` for general code quality, `/
|
|
70
|
+
- **Debugging sessions**: Use `/debug` alongside `/playwright-pro fix` for trace analysis
|
|
71
|
+
- **Code review**: Use `/review` for general code quality, `/playwright-pro review` for Playwright-specific
|
|
72
72
|
|
|
73
73
|
### Integrations
|
|
74
74
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: playwright-pro
|
|
3
3
|
description: "Production-grade Playwright testing toolkit. Generate tests, fix flaky failures, migrate from Cypress/Selenium, sync with TestRail, run on BrowserStack. 55 templates, 3 agents, smart reporting."
|
|
4
|
-
argument-hint: ""
|
|
4
|
+
argument-hint: "[browserstack|fix|generate|init|migrate|report|review|testrail] [args]"
|
|
5
5
|
category: "testing"
|
|
6
6
|
user-invocable: true
|
|
7
7
|
allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
@@ -13,21 +13,25 @@ Production-grade Playwright testing toolkit for AI coding agents.
|
|
|
13
13
|
|
|
14
14
|
> **Note:** This skill may create or modify files in your project. It will ask before writing.
|
|
15
15
|
|
|
16
|
+
## Sub-commands
|
|
17
|
+
|
|
18
|
+
`/playwright-pro` with no argument shows this overview. With a sub-command as its first argument, read `skills/<sub-command>/SKILL.md` from this skill's directory and follow it, passing the remaining arguments. Sub-commands: `browserstack`, `fix`, `generate`, `init`, `migrate`, `report`, `review`, `testrail`.
|
|
19
|
+
|
|
16
20
|
## Quick Start Workflow
|
|
17
21
|
|
|
18
22
|
The recommended sequence for most projects:
|
|
19
23
|
|
|
20
24
|
```
|
|
21
|
-
1. /
|
|
22
|
-
2. /
|
|
23
|
-
3. /
|
|
24
|
-
4. /
|
|
25
|
+
1. /playwright-pro init -> scaffolds config, CI pipeline, and a first smoke test
|
|
26
|
+
2. /playwright-pro generate -> generates tests from your spec or URL
|
|
27
|
+
3. /playwright-pro review -> validates quality and flags anti-patterns <- always run after generate
|
|
28
|
+
4. /playwright-pro fix <test> -> diagnoses and repairs any failing/flaky tests <- run when CI turns red
|
|
25
29
|
```
|
|
26
30
|
|
|
27
31
|
**Validation checkpoints:**
|
|
28
|
-
- After `/
|
|
29
|
-
- After `/
|
|
30
|
-
- After `/
|
|
32
|
+
- After `/playwright-pro generate` -- always run `/playwright-pro review` before committing
|
|
33
|
+
- After `/playwright-pro fix` -- re-run the full suite locally (`npx playwright test`)
|
|
34
|
+
- After `/playwright-pro migrate` -- run both suites and compare test counts and results before decommissioning old tests
|
|
31
35
|
|
|
32
36
|
## Golden Rules
|
|
33
37
|
|
|
@@ -55,7 +59,7 @@ The recommended sequence for most projects:
|
|
|
55
59
|
|
|
56
60
|
## What's Included
|
|
57
61
|
|
|
58
|
-
- **
|
|
62
|
+
- **8 skills** with detailed step-by-step instructions
|
|
59
63
|
- **3 specialized agents**: test-architect, test-debugger, migration-planner
|
|
60
64
|
- **55 test templates**: auth, CRUD, checkout, search, forms, dashboard, settings, onboarding, notifications, API, accessibility
|
|
61
65
|
- **2 MCP servers** (TypeScript): TestRail and BrowserStack integrations
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: migration-planner
|
|
3
3
|
description: >-
|
|
4
4
|
Analyzes Cypress or Selenium test suites and creates a file-by-file
|
|
5
|
-
migration plan. Invoked by /
|
|
5
|
+
migration plan. Invoked by /playwright-pro migrate before conversion starts.
|
|
6
6
|
allowed-tools:
|
|
7
7
|
- Read
|
|
8
8
|
- Grep
|
|
@@ -118,4 +118,4 @@ Flag tests that may need manual intervention:
|
|
|
118
118
|
|
|
119
119
|
### Step 7: Return Plan
|
|
120
120
|
|
|
121
|
-
Return the complete migration plan to `/
|
|
121
|
+
Return the complete migration plan to `/playwright-pro migrate` for execution.
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: test-architect
|
|
3
3
|
description: >-
|
|
4
|
-
Plans test strategy for complex applications. Invoked by /
|
|
5
|
-
/pw:coverage when the app has multiple routes, complex state, or requires
|
|
4
|
+
Plans test strategy for complex applications. Invoked by /playwright-pro generate when the app has multiple routes, complex state, or requires
|
|
6
5
|
a structured test plan before writing tests.
|
|
7
6
|
allowed-tools:
|
|
8
7
|
- Read
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: test-debugger
|
|
3
3
|
description: >-
|
|
4
4
|
Diagnoses flaky or failing Playwright tests using systematic taxonomy.
|
|
5
|
-
Invoked by /
|
|
5
|
+
Invoked by /playwright-pro fix when a test needs deep analysis including running
|
|
6
6
|
tests, reading traces, and identifying root causes.
|
|
7
7
|
allowed-tools:
|
|
8
8
|
- Read
|
|
@@ -20,4 +20,4 @@ fi
|
|
|
20
20
|
# Count existing test files
|
|
21
21
|
TEST_COUNT=$(find . -name "*.spec.ts" -o -name "*.spec.js" -o -name "*.test.ts" -o -name "*.test.js" 2>/dev/null | grep -v node_modules | wc -l | tr -d ' ')
|
|
22
22
|
|
|
23
|
-
echo "🎭 Playwright detected ($PW_CONFIG) — $TEST_COUNT test files found. Use /
|
|
23
|
+
echo "🎭 Playwright detected ($PW_CONFIG) — $TEST_COUNT test files found. Use /playwright-pro for testing workflows."
|
|
@@ -24,7 +24,7 @@ If not set, inform the user how to get them from [browserstack.com/accounts/sett
|
|
|
24
24
|
### 1. Configure for BrowserStack
|
|
25
25
|
|
|
26
26
|
```
|
|
27
|
-
/
|
|
27
|
+
/playwright-pro browserstack setup
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Steps:
|
|
@@ -96,7 +96,7 @@ export default defineConfig({
|
|
|
96
96
|
### 2. Run Tests on BrowserStack
|
|
97
97
|
|
|
98
98
|
```
|
|
99
|
-
/
|
|
99
|
+
/playwright-pro browserstack run
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
Steps:
|
|
@@ -113,7 +113,7 @@ Steps:
|
|
|
113
113
|
### 3. Get Build Results
|
|
114
114
|
|
|
115
115
|
```
|
|
116
|
-
/
|
|
116
|
+
/playwright-pro browserstack results
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
Steps:
|
|
@@ -130,7 +130,7 @@ Steps:
|
|
|
130
130
|
### 4. Check Available Browsers
|
|
131
131
|
|
|
132
132
|
```
|
|
133
|
-
/
|
|
133
|
+
/playwright-pro browserstack browsers
|
|
134
134
|
```
|
|
135
135
|
|
|
136
136
|
Steps:
|
|
@@ -141,7 +141,7 @@ Steps:
|
|
|
141
141
|
### 5. Local Testing
|
|
142
142
|
|
|
143
143
|
```
|
|
144
|
-
/
|
|
144
|
+
/playwright-pro browserstack local
|
|
145
145
|
```
|
|
146
146
|
|
|
147
147
|
For testing localhost or staging behind firewall:
|
|
@@ -46,7 +46,7 @@ Check what's configured and route automatically:
|
|
|
46
46
|
|
|
47
47
|
| Check | If found | Action |
|
|
48
48
|
|---|---|---|
|
|
49
|
-
| `TESTRAIL_URL` env var | TestRail configured | Push results via `/
|
|
49
|
+
| `TESTRAIL_URL` env var | TestRail configured | Push results via `/playwright-pro testrail push` |
|
|
50
50
|
| `SLACK_WEBHOOK_URL` env var | Slack configured | Post summary to Slack |
|
|
51
51
|
| `.github/workflows/` | GitHub Actions | Results go to PR comment via artifacts |
|
|
52
52
|
| `playwright-report/` | HTML reporter | Open or serve the report |
|
|
@@ -98,7 +98,7 @@ curl -X POST "$SLACK_WEBHOOK_URL" \
|
|
|
98
98
|
|
|
99
99
|
#### TestRail Push (If Configured)
|
|
100
100
|
|
|
101
|
-
Invoke `/
|
|
101
|
+
Invoke `/playwright-pro testrail push` with the JSON results.
|
|
102
102
|
|
|
103
103
|
#### HTML Report
|
|
104
104
|
|
|
@@ -25,7 +25,7 @@ If not set, inform the user how to configure them and stop.
|
|
|
25
25
|
### 1. Import Test Cases → Generate Playwright Tests
|
|
26
26
|
|
|
27
27
|
```
|
|
28
|
-
/
|
|
28
|
+
/playwright-pro testrail import --project <id> --suite <id>
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
Steps:
|
|
@@ -40,7 +40,7 @@ Steps:
|
|
|
40
40
|
### 2. Push Test Results → TestRail
|
|
41
41
|
|
|
42
42
|
```
|
|
43
|
-
/
|
|
43
|
+
/playwright-pro testrail push --run <id>
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
Steps:
|
|
@@ -58,7 +58,7 @@ Steps:
|
|
|
58
58
|
### 3. Create Test Run
|
|
59
59
|
|
|
60
60
|
```
|
|
61
|
-
/
|
|
61
|
+
/playwright-pro testrail run --project <id> --name "Sprint 42 Regression"
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
Steps:
|
|
@@ -69,7 +69,7 @@ Steps:
|
|
|
69
69
|
### 4. Sync Status
|
|
70
70
|
|
|
71
71
|
```
|
|
72
|
-
/
|
|
72
|
+
/playwright-pro testrail status --project <id>
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
Steps:
|
|
@@ -86,7 +86,7 @@ Steps:
|
|
|
86
86
|
### 5. Update Test Cases in TestRail
|
|
87
87
|
|
|
88
88
|
```
|
|
89
|
-
/
|
|
89
|
+
/playwright-pro testrail update --case <id>
|
|
90
90
|
```
|
|
91
91
|
|
|
92
92
|
Steps:
|
|
@@ -4,10 +4,10 @@
|
|
|
4
4
|
|
|
5
5
|
## Usage
|
|
6
6
|
|
|
7
|
-
Templates are loaded by `/
|
|
7
|
+
Templates are loaded by `/playwright-pro generate` when it detects a matching scenario. You can also reference them directly:
|
|
8
8
|
|
|
9
9
|
```
|
|
10
|
-
/
|
|
10
|
+
/playwright-pro generate "login flow" → loads templates/auth/login.md
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
## Template Index
|
|
@@ -9,7 +9,7 @@ allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Task
|
|
|
9
9
|
|
|
10
10
|
## Phase 1: Define the Question
|
|
11
11
|
|
|
12
|
-
Resolve review mode: `--review` arg > `production/review-mode.txt` > default `lean`.
|
|
12
|
+
Resolve review mode: `--review` arg > `production/review-mode.txt` > default `lean`.
|
|
13
13
|
|
|
14
14
|
Read concept description. Identify core question the prototype must answer. If vague, state question explicitly before proceeding.
|
|
15
15
|
|
|
@@ -44,4 +44,4 @@ Present draft → ask write approval → `design/quick-specs/[kebab-case]-[YYYY-
|
|
|
44
44
|
|
|
45
45
|
Report: file written, type, system, GDD update status. Next: `/story-readiness` (reference spec in story's GDD Reference field).
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
Skips the full GDD pipeline (`/design-system`) by design. Redirect to full pipeline if: new system belongs in index, significantly alters cross-system behavior, introduces new player-facing mechanics affecting MDA balance, or >1 week implementation.
|
|
@@ -28,7 +28,7 @@ Output: `production/security/security-audit-[date].md`
|
|
|
28
28
|
| `quick` | High-severity checks only (fastest) |
|
|
29
29
|
| No arg | `full` |
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
Detect language, platforms and, for a game, the engine (`ProjectSettings/ProjectVersion.txt` (Unity) or the `.uproject` (Unreal)) from the project files. Take multiplayer scope from the GDD, or ask.
|
|
32
32
|
|
|
33
33
|
## Phase 2: Spawn Security Engineer
|
|
34
34
|
|
|
@@ -4,13 +4,13 @@ This plugin helps you curate Claude Code's auto-memory into durable project know
|
|
|
4
4
|
|
|
5
5
|
## Commands
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
All commands are sub-commands of `/self-improving-agent`:
|
|
8
8
|
|
|
9
|
-
- `/
|
|
10
|
-
- `/
|
|
11
|
-
- `/
|
|
12
|
-
- `/
|
|
13
|
-
- `/
|
|
9
|
+
- `/self-improving-agent review` — Analyze auto-memory health and find promotion candidates
|
|
10
|
+
- `/self-improving-agent promote <pattern>` — Graduate a learning to CLAUDE.md or `.claude/rules/`
|
|
11
|
+
- `/self-improving-agent extract <pattern>` — Create a reusable skill from a proven pattern
|
|
12
|
+
- `/self-improving-agent status` — Quick memory health dashboard
|
|
13
|
+
- `/self-improving-agent remember <knowledge>` — Explicitly save something to auto-memory
|
|
14
14
|
|
|
15
15
|
## How auto-memory works
|
|
16
16
|
|
|
@@ -22,25 +22,25 @@ This plugin reads that directory — it never creates its own storage.
|
|
|
22
22
|
|
|
23
23
|
### After completing a feature or debugging session
|
|
24
24
|
```
|
|
25
|
-
/
|
|
25
|
+
/self-improving-agent review
|
|
26
26
|
```
|
|
27
27
|
Check if anything Claude learned should become a permanent rule.
|
|
28
28
|
|
|
29
29
|
### When a pattern keeps coming up
|
|
30
30
|
```
|
|
31
|
-
/
|
|
31
|
+
/self-improving-agent promote "Always run migrations before tests in this project"
|
|
32
32
|
```
|
|
33
33
|
Moves it from MEMORY.md (background note) to CLAUDE.md (enforced rule).
|
|
34
34
|
|
|
35
35
|
### When you solved something non-obvious that could help other projects
|
|
36
36
|
```
|
|
37
|
-
/
|
|
37
|
+
/self-improving-agent extract "Docker build fix for ARM64 platform mismatch"
|
|
38
38
|
```
|
|
39
39
|
Creates a standalone skill with SKILL.md, ready to install elsewhere.
|
|
40
40
|
|
|
41
41
|
### To check memory capacity
|
|
42
42
|
```
|
|
43
|
-
/
|
|
43
|
+
/self-improving-agent status
|
|
44
44
|
```
|
|
45
45
|
Shows line counts, topic files, stale entries, and recommendations.
|
|
46
46
|
|
|
@@ -55,8 +55,8 @@ Shows line counts, topic files, stale entries, and recommendations.
|
|
|
55
55
|
|
|
56
56
|
## Agents
|
|
57
57
|
|
|
58
|
-
- **memory-analyst**: Spawned by `/
|
|
59
|
-
- **skill-extractor**: Spawned by `/
|
|
58
|
+
- **memory-analyst**: Spawned by `/self-improving-agent review` to analyze patterns across memory files
|
|
59
|
+
- **skill-extractor**: Spawned by `/self-improving-agent extract` to generate complete skill packages
|
|
60
60
|
|
|
61
61
|
## Hooks
|
|
62
62
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: self-improving-agent
|
|
3
3
|
description: "Curate Claude Code's auto-memory into durable project knowledge. Analyze MEMORY.md for patterns, promote proven learnings to CLAUDE.md and .claude/rules/, extract recurring solutions into reusable skills."
|
|
4
|
-
argument-hint: ""
|
|
4
|
+
argument-hint: "[extract|promote|remember|review|status] [args]"
|
|
5
5
|
category: "arcane"
|
|
6
6
|
user-invocable: true
|
|
7
7
|
allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
@@ -11,15 +11,19 @@ allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
|
11
11
|
|
|
12
12
|
Claude Code's auto-memory (v2.1.32+) automatically records project patterns, debugging insights, and your preferences in `MEMORY.md`. This skill adds the intelligence layer: it analyzes what Claude has learned, promotes proven patterns into project rules, and extracts recurring solutions into reusable skills. May write or edit CLAUDE.md, .claude/rules/ files, and new skill files during promotion and extraction.
|
|
13
13
|
|
|
14
|
+
## Sub-commands
|
|
15
|
+
|
|
16
|
+
`/self-improving-agent` with no argument shows this overview. With a sub-command as its first argument, read `skills/<sub-command>/SKILL.md` from this skill's directory and follow it, passing the remaining arguments. Sub-commands: `extract`, `promote`, `remember`, `review`, `status`.
|
|
17
|
+
|
|
14
18
|
## Quick Reference
|
|
15
19
|
|
|
16
20
|
| Command | What it does |
|
|
17
21
|
|---------|-------------|
|
|
18
|
-
| `/
|
|
19
|
-
| `/
|
|
20
|
-
| `/
|
|
21
|
-
| `/
|
|
22
|
-
| `/
|
|
22
|
+
| `/self-improving-agent review` | Analyze MEMORY.md -- find promotion candidates, stale entries, consolidation opportunities |
|
|
23
|
+
| `/self-improving-agent promote` | Graduate a pattern from MEMORY.md to CLAUDE.md or `.claude/rules/` |
|
|
24
|
+
| `/self-improving-agent extract` | Turn a proven pattern into a standalone skill |
|
|
25
|
+
| `/self-improving-agent status` | Memory health dashboard -- line counts, topic files, recommendations |
|
|
26
|
+
| `/self-improving-agent remember` | Explicitly save important knowledge to auto-memory |
|
|
23
27
|
|
|
24
28
|
## How It Fits Together
|
|
25
29
|
|
|
@@ -33,9 +37,9 @@ Claude Code's auto-memory (v2.1.32+) automatically records project patterns, deb
|
|
|
33
37
|
│ standards │ + topic files │ + continuity │
|
|
34
38
|
│ Full load │ First 200 lines│ Contextual load │
|
|
35
39
|
├─────────────┴──────────────────┴────────────────────────┤
|
|
36
|
-
│ /
|
|
40
|
+
│ /self-improving-agent promote /self-improving-agent review │
|
|
37
41
|
│ Self-Improving Agent (this skill) │
|
|
38
|
-
│ /
|
|
42
|
+
│ /self-improving-agent extract /self-improving-agent remember │
|
|
39
43
|
├─────────────────────────────────────────────────────────┤
|
|
40
44
|
│ .claude/rules/ │ New Skills │ Error Logs │
|
|
41
45
|
│ (scoped rules) │ (extracted) │ (auto-captured)│
|
|
@@ -48,18 +52,18 @@ Claude Code's auto-memory (v2.1.32+) automatically records project patterns, deb
|
|
|
48
52
|
|
|
49
53
|
| File | Who writes | Scope | Loaded |
|
|
50
54
|
|------|-----------|-------|--------|
|
|
51
|
-
| `./CLAUDE.md` | You (+ `/
|
|
55
|
+
| `./CLAUDE.md` | You (+ `/self-improving-agent promote`) | Project rules | Full file, every session |
|
|
52
56
|
| `~/.claude/CLAUDE.md` | You | Global preferences | Full file, every session |
|
|
53
57
|
| `~/.claude/projects/<path>/memory/MEMORY.md` | Claude (auto) | Project learnings | First 200 lines |
|
|
54
58
|
| `~/.claude/projects/<path>/memory/*.md` | Claude (overflow) | Topic-specific notes | On demand |
|
|
55
|
-
| `.claude/rules/*.md` | You (+ `/
|
|
59
|
+
| `.claude/rules/*.md` | You (+ `/self-improving-agent promote`) | Scoped rules | When matching files open |
|
|
56
60
|
|
|
57
61
|
### The promotion lifecycle
|
|
58
62
|
|
|
59
63
|
```
|
|
60
64
|
1. Claude discovers pattern -> auto-memory (MEMORY.md)
|
|
61
|
-
2. Pattern recurs 2-3x -> /
|
|
62
|
-
3. You approve -> /
|
|
65
|
+
2. Pattern recurs 2-3x -> /self-improving-agent review flags it as promotion candidate
|
|
66
|
+
3. You approve -> /self-improving-agent promote graduates it to CLAUDE.md or rules/
|
|
63
67
|
4. Pattern becomes an enforced rule, not just a note
|
|
64
68
|
5. MEMORY.md entry removed -> frees space for new learnings
|
|
65
69
|
```
|
|
@@ -64,7 +64,7 @@ Organize findings into:
|
|
|
64
64
|
|
|
65
65
|
## Output Format
|
|
66
66
|
|
|
67
|
-
Use the format defined in the `/
|
|
67
|
+
Use the format defined in the `/self-improving-agent review` skill. Be specific — include line numbers, exact text, and concrete suggestions.
|
|
68
68
|
|
|
69
69
|
## Constraints
|
|
70
70
|
|
|
@@ -103,8 +103,8 @@ cat << EOF
|
|
|
103
103
|
<error-detected>
|
|
104
104
|
Command error detected (pattern: "$matched_pattern").
|
|
105
105
|
If this was unexpected or required investigation to fix, save the solution:
|
|
106
|
-
/
|
|
107
|
-
Or if this is a known pattern, check: /
|
|
106
|
+
/self-improving-agent remember "explanation of what went wrong and the fix"
|
|
107
|
+
Or if this is a known pattern, check: /self-improving-agent review
|
|
108
108
|
Context: $(echo "$error_context" | head -2 | tr '\n' ' ' | cut -c1-200)
|
|
109
109
|
</error-detected>
|
|
110
110
|
EOF
|
|
@@ -103,7 +103,7 @@ When entries conflict:
|
|
|
103
103
|
```
|
|
104
104
|
Auto-memory captures → This plugin curates → CLAUDE.md enforces
|
|
105
105
|
|
|
106
|
-
MEMORY.md (raw notes) → /
|
|
106
|
+
MEMORY.md (raw notes) → /self-improving-agent review (analyze) → /self-improving-agent promote (graduate)
|
|
107
107
|
↓
|
|
108
108
|
CLAUDE.md or
|
|
109
109
|
.claude/rules/
|
|
@@ -128,4 +128,4 @@ MEMORY.md (raw notes) → /si:review (analyze) → /si:promote (graduate)
|
|
|
128
128
|
3. **Don't duplicate** — if it's in CLAUDE.md, remove it from MEMORY.md
|
|
129
129
|
4. **Scope rules** — use `.claude/rules/` with paths for file-type-specific patterns
|
|
130
130
|
5. **Review quarterly** — memory files go stale after refactors
|
|
131
|
-
6. **Use /
|
|
131
|
+
6. **Use /self-improving-agent status** — monitor capacity before it becomes a problem
|
|
@@ -74,10 +74,10 @@ When promoting, transform the learning:
|
|
|
74
74
|
## Promotion Workflow
|
|
75
75
|
|
|
76
76
|
```
|
|
77
|
-
1. /
|
|
77
|
+
1. /self-improving-agent review identifies candidate
|
|
78
78
|
2. Confirm the pattern is still valid
|
|
79
79
|
3. Distill into one-line instruction
|
|
80
|
-
4. /
|
|
80
|
+
4. /self-improving-agent promote writes to CLAUDE.md or rules/
|
|
81
81
|
5. Remove from MEMORY.md
|
|
82
|
-
6. Verify with /
|
|
82
|
+
6. Verify with /self-improving-agent status
|
|
83
83
|
```
|
|
@@ -125,7 +125,7 @@ paths:
|
|
|
125
125
|
|--------|--------|
|
|
126
126
|
| CLAUDE.md over 150 lines | Move scoped patterns to rules/ |
|
|
127
127
|
| Same instruction repeated for different file types | Create a scoped rule |
|
|
128
|
-
| `/
|
|
128
|
+
| `/self-improving-agent promote` suggests a file-type-specific pattern | Create or append to a rule file |
|
|
129
129
|
| Team adds a new convention for a specific area | New rule file |
|
|
130
130
|
|
|
131
131
|
## Organization Tips
|
|
@@ -10,11 +10,11 @@
|
|
|
10
10
|
"tags": ["memory", "auto-memory", "self-improvement", "learning", "rules", "skills"],
|
|
11
11
|
"repository": "https://github.com/alirezarezvani/claude-skills",
|
|
12
12
|
"commands": {
|
|
13
|
-
"review": "/
|
|
14
|
-
"promote": "/
|
|
15
|
-
"extract": "/
|
|
16
|
-
"status": "/
|
|
17
|
-
"remember": "/
|
|
13
|
+
"review": "/self-improving-agent review",
|
|
14
|
+
"promote": "/self-improving-agent promote",
|
|
15
|
+
"extract": "/self-improving-agent extract",
|
|
16
|
+
"status": "/self-improving-agent status",
|
|
17
|
+
"remember": "/self-improving-agent remember"
|
|
18
18
|
},
|
|
19
19
|
"hooks": {
|
|
20
20
|
"PostToolUse": {
|
|
@@ -7,17 +7,17 @@ user-invocable: false
|
|
|
7
7
|
allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
# /
|
|
10
|
+
# /self-improving-agent extract — Create Skills from Patterns
|
|
11
11
|
|
|
12
12
|
Transforms a recurring pattern or debugging solution into a standalone, portable skill that can be installed in any project.
|
|
13
13
|
|
|
14
14
|
## Usage
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
/
|
|
18
|
-
/
|
|
19
|
-
/
|
|
20
|
-
/
|
|
17
|
+
/self-improving-agent extract <pattern description> # Interactive extraction
|
|
18
|
+
/self-improving-agent extract <pattern> --name docker-m1-fixes # Specify skill name
|
|
19
|
+
/self-improving-agent extract <pattern> --output ./skills/ # Custom output directory
|
|
20
|
+
/self-improving-agent extract <pattern> --dry-run # Preview without creating files
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## When to Extract
|
|
@@ -153,7 +153,7 @@ Source: MEMORY.md entries at lines {{n, m, ...}} (retained — the skill is port
|
|
|
153
153
|
### Extracting a debugging pattern
|
|
154
154
|
|
|
155
155
|
```
|
|
156
|
-
/
|
|
156
|
+
/self-improving-agent extract "Fix for Docker builds failing on Apple Silicon with platform mismatch"
|
|
157
157
|
```
|
|
158
158
|
|
|
159
159
|
Creates `docker-m1-fixes/SKILL.md` with:
|
|
@@ -165,7 +165,7 @@ Creates `docker-m1-fixes/SKILL.md` with:
|
|
|
165
165
|
### Extracting a workflow pattern
|
|
166
166
|
|
|
167
167
|
```
|
|
168
|
-
/
|
|
168
|
+
/self-improving-agent extract "Always regenerate TypeScript API client after modifying OpenAPI spec"
|
|
169
169
|
```
|
|
170
170
|
|
|
171
171
|
Creates `api-client-regen/SKILL.md` with:
|
|
@@ -7,17 +7,17 @@ user-invocable: false
|
|
|
7
7
|
allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
# /
|
|
10
|
+
# /self-improving-agent promote — Graduate Learnings to Rules
|
|
11
11
|
|
|
12
12
|
Moves a proven pattern from Claude's auto-memory into the project's rule system, where it becomes an enforced instruction rather than a background note.
|
|
13
13
|
|
|
14
14
|
## Usage
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
/
|
|
18
|
-
/
|
|
19
|
-
/
|
|
20
|
-
/
|
|
17
|
+
/self-improving-agent promote <pattern description> # Auto-detect best target
|
|
18
|
+
/self-improving-agent promote <pattern> --target claude.md # Promote to CLAUDE.md
|
|
19
|
+
/self-improving-agent promote <pattern> --target rules/testing.md # Promote to scoped rule
|
|
20
|
+
/self-improving-agent promote <pattern> --target rules/api.md --paths "src/api/**/*.ts" # Scoped with paths
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## Workflow
|
|
@@ -7,17 +7,17 @@ user-invocable: false
|
|
|
7
7
|
allowed-tools: Read, Glob, Grep, Bash, Write, Edit
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
# /
|
|
10
|
+
# /self-improving-agent remember — Save Knowledge Explicitly
|
|
11
11
|
|
|
12
12
|
Writes an explicit entry to auto-memory when something is important enough that you don't want to rely on Claude noticing it automatically.
|
|
13
13
|
|
|
14
14
|
## Usage
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
/
|
|
18
|
-
/
|
|
19
|
-
/
|
|
20
|
-
/
|
|
17
|
+
/self-improving-agent remember <what to remember>
|
|
18
|
+
/self-improving-agent remember "This project's CI requires Node 20 LTS — v22 breaks the build"
|
|
19
|
+
/self-improving-agent remember "The /api/auth endpoint uses a custom JWT library, not passport"
|
|
20
|
+
/self-improving-agent remember "Reza prefers explicit error handling over try-catch-all patterns"
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## When to Use
|
|
@@ -63,7 +63,7 @@ Keep entries concise — one line when possible. Auto-memory entries don't need
|
|
|
63
63
|
If MEMORY.md is over 180 lines, warn the user:
|
|
64
64
|
|
|
65
65
|
```
|
|
66
|
-
⚠️ MEMORY.md is at {{n}}/200 lines. Consider running /
|
|
66
|
+
⚠️ MEMORY.md is at {{n}}/200 lines. Consider running /self-improving-agent review to free space.
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
### Step 4: Suggest promotion
|
|
@@ -72,7 +72,7 @@ If the knowledge sounds like a rule (imperative, always/never, convention):
|
|
|
72
72
|
|
|
73
73
|
```
|
|
74
74
|
💡 This sounds like it could be a CLAUDE.md rule rather than a memory entry.
|
|
75
|
-
Rules are enforced with higher priority. Want to /
|
|
75
|
+
Rules are enforced with higher priority. Want to /self-improving-agent promote it instead?
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
### Step 5: Confirm
|
|
@@ -86,10 +86,10 @@ If the knowledge sounds like a rule (imperative, always/never, convention):
|
|
|
86
86
|
Claude will see this at the start of every session in this project.
|
|
87
87
|
```
|
|
88
88
|
|
|
89
|
-
## What NOT to use /
|
|
89
|
+
## What NOT to use /self-improving-agent remember for
|
|
90
90
|
|
|
91
91
|
- **Temporary context**: Use session memory or just tell Claude in conversation
|
|
92
|
-
- **Enforced rules**: Use `/
|
|
92
|
+
- **Enforced rules**: Use `/self-improving-agent promote` to write directly to CLAUDE.md
|
|
93
93
|
- **Cross-project knowledge**: Use `~/.claude/CLAUDE.md` for global rules
|
|
94
94
|
- **Sensitive data**: Never store credentials, tokens, or secrets in memory files
|
|
95
95
|
|