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.
Files changed (147) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +40 -38
  3. package/agents/business/business-ops-lead.md +1 -14
  4. package/agents/game/gameplay-programmer.md +3 -4
  5. package/agents/game/technical-artist.md +3 -4
  6. package/dist/cli.js +105 -39
  7. package/docs/USER-GUIDE.md +24 -22
  8. package/docs/coordination-rules.md +1 -1
  9. package/docs/directory-structure.md +93 -122
  10. package/package.json +1 -1
  11. package/profiles/ai.yaml +3 -0
  12. package/profiles/android-native.yaml +2 -0
  13. package/profiles/backend-go.yaml +1 -8
  14. package/profiles/backend-ts.yaml +2 -8
  15. package/profiles/backend-typescript.yaml +51 -0
  16. package/profiles/flutter.yaml +2 -0
  17. package/profiles/frontend-react-vite.yaml +39 -0
  18. package/profiles/frontend.yaml +2 -0
  19. package/profiles/integrations.yaml +6 -1
  20. package/profiles/ios-native.yaml +2 -0
  21. package/profiles/mobile-android-kotlin.yaml +36 -0
  22. package/profiles/mobile-flutter.yaml +37 -0
  23. package/profiles/mobile-ios-swift.yaml +37 -0
  24. package/profiles/mobile-react-native.yaml +39 -0
  25. package/profiles/mobile.yaml +2 -0
  26. package/rules/gamedev/engine-code.md +1 -1
  27. package/rules/gamedev/shader-code.md +1 -2
  28. package/rules/gamedev/vn-code.md +3 -2
  29. package/rules/implementation-workflow.md +1 -1
  30. package/rules/{ai-code.md → llm-code.md} +5 -5
  31. package/skills/agent-designer/README.md +2 -1
  32. package/skills/agent-designer/agent_evaluator.py +0 -5
  33. package/skills/ai-sdk-setup/SKILL.md +4 -4
  34. package/skills/arcane-add/SKILL.md +1 -1
  35. package/skills/arcane-list/SKILL.md +3 -3
  36. package/skills/arcane-status/SKILL.md +1 -1
  37. package/skills/architecture-decision/SKILL.md +3 -4
  38. package/skills/architecture-review/SKILL.md +1 -1
  39. package/skills/asset-audit/SKILL.md +0 -1
  40. package/skills/balance-check/SKILL.md +1 -1
  41. package/skills/brainstorm/SKILL.md +3 -3
  42. package/skills/brainstorm/references/next-steps-pipeline.md +8 -9
  43. package/skills/consistency-check/SKILL.md +2 -2
  44. package/skills/design-system/SKILL.md +1 -1
  45. package/skills/design-system/references/post-design-validation.md +2 -3
  46. package/skills/freelance-kickoff/SKILL.md +1 -1
  47. package/skills/frontend-dev/SKILL.md +27 -28
  48. package/skills/frontend-dev/references/asset-prompt-guide.md +1 -1
  49. package/skills/frontend-dev/references/motion-recipes.md +1 -1
  50. package/skills/help/SKILL.md +1 -2
  51. package/skills/hotfix/SKILL.md +2 -2
  52. package/skills/milestone-review/SKILL.md +1 -1
  53. package/skills/patch-notes/SKILL.md +1 -1
  54. package/skills/playtest-report/SKILL.md +2 -3
  55. package/skills/playwright-pro/CLAUDE.md +2 -2
  56. package/skills/playwright-pro/SKILL.md +13 -9
  57. package/skills/playwright-pro/agents/migration-planner.md +2 -2
  58. package/skills/playwright-pro/agents/test-architect.md +1 -2
  59. package/skills/playwright-pro/agents/test-debugger.md +1 -1
  60. package/skills/playwright-pro/hooks/detect-playwright.sh +1 -1
  61. package/skills/playwright-pro/skills/browserstack/SKILL.md +5 -5
  62. package/skills/playwright-pro/skills/migrate/SKILL.md +1 -1
  63. package/skills/playwright-pro/skills/report/SKILL.md +2 -2
  64. package/skills/playwright-pro/skills/testrail/SKILL.md +5 -5
  65. package/skills/playwright-pro/templates/README.md +2 -2
  66. package/skills/prototype/SKILL.md +1 -1
  67. package/skills/quick-design/SKILL.md +1 -1
  68. package/skills/release-checklist/SKILL.md +0 -1
  69. package/skills/security-audit/SKILL.md +1 -1
  70. package/skills/self-improving-agent/CLAUDE.md +12 -12
  71. package/skills/self-improving-agent/SKILL.md +16 -12
  72. package/skills/self-improving-agent/agents/memory-analyst.md +1 -1
  73. package/skills/self-improving-agent/hooks/error-capture.sh +2 -2
  74. package/skills/self-improving-agent/reference/memory-architecture.md +2 -2
  75. package/skills/self-improving-agent/reference/promotion-rules.md +3 -3
  76. package/skills/self-improving-agent/reference/rules-directory-patterns.md +1 -1
  77. package/skills/self-improving-agent/settings.json +5 -5
  78. package/skills/self-improving-agent/skills/extract/SKILL.md +7 -7
  79. package/skills/self-improving-agent/skills/promote/SKILL.md +5 -5
  80. package/skills/self-improving-agent/skills/remember/SKILL.md +9 -9
  81. package/skills/self-improving-agent/skills/review/SKILL.md +7 -7
  82. package/skills/self-improving-agent/skills/status/SKILL.md +8 -8
  83. package/skills/senior-ml-engineer/references/llm_integration_guide.md +14 -31
  84. package/skills/senior-prompt-engineer/SKILL.md +10 -10
  85. package/skills/senior-prompt-engineer/references/prompt_engineering_patterns.md +1 -1
  86. package/skills/senior-prompt-engineer/scripts/agent_orchestrator.py +43 -40
  87. package/skills/senior-prompt-engineer/scripts/prompt_optimizer.py +23 -66
  88. package/skills/shader-dev/reference/fluid-simulation.md +4 -4
  89. package/skills/shader-dev/reference/simulation-physics.md +6 -6
  90. package/skills/shader-dev/reference/voxel-rendering.md +1 -1
  91. package/skills/shader-dev/techniques/ambient-occlusion.md +1 -1
  92. package/skills/shader-dev/techniques/analytic-ray-tracing.md +2 -2
  93. package/skills/shader-dev/techniques/domain-warping.md +2 -2
  94. package/skills/shader-dev/techniques/fluid-simulation.md +45 -45
  95. package/skills/shader-dev/techniques/multipass-buffer.md +24 -24
  96. package/skills/shader-dev/techniques/normal-estimation.md +1 -1
  97. package/skills/shader-dev/techniques/particle-system.md +16 -16
  98. package/skills/shader-dev/techniques/polar-uv-manipulation.md +1 -1
  99. package/skills/shader-dev/techniques/post-processing.md +7 -7
  100. package/skills/shader-dev/techniques/sdf-3d.md +1 -1
  101. package/skills/shader-dev/techniques/simulation-physics.md +24 -24
  102. package/skills/shader-dev/techniques/sound-synthesis.md +2 -2
  103. package/skills/shader-dev/techniques/voronoi-cellular-noise.md +1 -1
  104. package/skills/shader-dev/techniques/voxel-rendering.md +60 -60
  105. package/skills/smoke-check/SKILL.md +1 -1
  106. package/skills/sprint-plan/SKILL.md +1 -2
  107. package/skills/start/SKILL.md +7 -7
  108. package/skills/story-done/SKILL.md +1 -1
  109. package/skills/test-helpers/SKILL.md +7 -2
  110. package/skills/test-setup/SKILL.md +1 -1
  111. package/skills/ue-actor-component-architecture/SKILL.md +0 -1
  112. package/skills/ue-ai-navigation/SKILL.md +0 -1
  113. package/skills/ue-animation-system/SKILL.md +0 -1
  114. package/skills/ue-async-threading/SKILL.md +0 -1
  115. package/skills/ue-audio-system/SKILL.md +0 -1
  116. package/skills/ue-blueprints/SKILL.md +0 -1
  117. package/skills/ue-character-movement/SKILL.md +0 -1
  118. package/skills/ue-cpp-foundations/SKILL.md +0 -1
  119. package/skills/ue-data-assets-tables/SKILL.md +0 -1
  120. package/skills/ue-editor-tools/SKILL.md +0 -1
  121. package/skills/ue-game-features/SKILL.md +0 -1
  122. package/skills/ue-gameplay-abilities/SKILL.md +0 -1
  123. package/skills/ue-gameplay-framework/SKILL.md +0 -1
  124. package/skills/ue-input-system/SKILL.md +0 -1
  125. package/skills/ue-mass-entity/SKILL.md +0 -1
  126. package/skills/ue-materials-rendering/SKILL.md +0 -1
  127. package/skills/ue-module-build-system/SKILL.md +0 -1
  128. package/skills/ue-naming-conventions/SKILL.md +0 -1
  129. package/skills/ue-networking-replication/SKILL.md +0 -1
  130. package/skills/ue-niagara-effects/SKILL.md +0 -1
  131. package/skills/ue-packaging/SKILL.md +0 -1
  132. package/skills/ue-physics-collision/SKILL.md +0 -1
  133. package/skills/ue-procedural-generation/SKILL.md +0 -1
  134. package/skills/ue-project-context/SKILL.md +0 -1
  135. package/skills/ue-sequencer-cinematics/SKILL.md +0 -1
  136. package/skills/ue-serialization-savegames/SKILL.md +0 -1
  137. package/skills/ue-state-trees/SKILL.md +0 -1
  138. package/skills/ue-testing-debugging/SKILL.md +0 -1
  139. package/skills/ue-ui-umg-slate/SKILL.md +0 -1
  140. package/skills/ue-world-level-streaming/SKILL.md +0 -1
  141. package/skills/ux-review/SKILL.md +1 -1
  142. package/docs/RELEASE-SETUP.md +0 -99
  143. package/docs/presentations/arcane-overview-12.pptx +0 -0
  144. package/docs/presentations/arcane-overview.pptx +0 -0
  145. package/docs/presentations/build_arcane_deck.py +0 -310
  146. package/docs/presentations/build_arcane_deck_12.py +0 -399
  147. 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
- Check for template at `docs/patch-notes-template.md` or `.claude/docs/templates/patch-notes-template.md`. If found → use as structure instead of built-in styles.
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`. See `.claude/docs/director-gates.md`.
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 | `/propagate-design-change [path]` for downstream impacts |
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 `/pw:fix` for trace analysis
71
- - **Code review**: Use `/review` for general code quality, `/pw:review` for Playwright-specific
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. /pw:init -> scaffolds config, CI pipeline, and a first smoke test
22
- 2. /pw:generate -> generates tests from your spec or URL
23
- 3. /pw:review -> validates quality and flags anti-patterns <- always run after generate
24
- 4. /pw:fix <test> -> diagnoses and repairs any failing/flaky tests <- run when CI turns red
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 `/pw:generate` -- always run `/pw:review` before committing
29
- - After `/pw:fix` -- re-run the full suite locally (`npx playwright test`)
30
- - After `/pw:migrate` -- run `/pw:coverage` to confirm parity before decommissioning old tests
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
- - **9 skills** with detailed step-by-step instructions
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 /pw:migrate before conversion starts.
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 `/pw:migrate` for execution.
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 /pw:generate and
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 /pw:fix when a test needs deep analysis including running
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 /pw: commands for testing workflows."
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
- /pw:browserstack setup
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
- /pw:browserstack run
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
- /pw:browserstack results
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
- /pw:browserstack browsers
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
- /pw:browserstack local
144
+ /playwright-pro browserstack local
145
145
  ```
146
146
 
147
147
  For testing localhost or staging behind firewall:
@@ -48,7 +48,7 @@ Migration Assessment:
48
48
 
49
49
  ### 3. Set Up Playwright (If Not Present)
50
50
 
51
- Run `/pw:init` first if Playwright isn't configured.
51
+ Run `/playwright-pro init` first if Playwright isn't configured.
52
52
 
53
53
  ### 4. Convert Files
54
54
 
@@ -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 `/pw:testrail push` |
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 `/pw:testrail push` with the JSON results.
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
- /pw:testrail import --project <id> --suite <id>
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
- /pw:testrail push --run <id>
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
- /pw:testrail run --project <id> --name "Sprint 42 Regression"
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
- /pw:testrail status --project <id>
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
- /pw:testrail update --case <id>
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 `/pw:generate` when it detects a matching scenario. You can also reference them directly:
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
- /pw:generate "login flow" → loads templates/auth/login.md
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`. See `.claude/docs/director-gates.md`.
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
- Bypasses `/design-review` 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.
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.
@@ -60,4 +60,3 @@ Present checklist + total items + known blockers. "May I write to `production/re
60
60
  ## Phase 6: Next Steps
61
61
 
62
62
  - `/gate-check` for formal phase gate verdict
63
- - Coordinate sign-offs via `/team-release`
@@ -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
- Read `.claude/docs/technical-preferences.md` for engine, language, platforms, multiplayer scope.
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
- Use the `/si:` namespace for all commands:
7
+ All commands are sub-commands of `/self-improving-agent`:
8
8
 
9
- - `/si:review` — Analyze auto-memory health and find promotion candidates
10
- - `/si:promote <pattern>` — Graduate a learning to CLAUDE.md or `.claude/rules/`
11
- - `/si:extract <pattern>` — Create a reusable skill from a proven pattern
12
- - `/si:status` — Quick memory health dashboard
13
- - `/si:remember <knowledge>` — Explicitly save something to auto-memory
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
- /si:review
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
- /si:promote "Always run migrations before tests in this project"
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
- /si:extract "Docker build fix for ARM64 platform mismatch"
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
- /si:status
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 `/si:review` to analyze patterns across memory files
59
- - **skill-extractor**: Spawned by `/si:extract` to generate complete skill packages
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
- | `/si:review` | Analyze MEMORY.md -- find promotion candidates, stale entries, consolidation opportunities |
19
- | `/si:promote` | Graduate a pattern from MEMORY.md to CLAUDE.md or `.claude/rules/` |
20
- | `/si:extract` | Turn a proven pattern into a standalone skill |
21
- | `/si:status` | Memory health dashboard -- line counts, topic files, recommendations |
22
- | `/si:remember` | Explicitly save important knowledge to auto-memory |
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
- │ /si:promote /si:review │
40
+ │ /self-improving-agent promote /self-improving-agent review │
37
41
  │ Self-Improving Agent (this skill) │
38
- │ /si:extract /si:remember │
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 (+ `/si:promote`) | Project rules | Full file, every session |
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 (+ `/si:promote`) | Scoped rules | When matching files open |
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 -> /si:review flags it as promotion candidate
62
- 3. You approve -> /si:promote graduates it to CLAUDE.md or rules/
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 `/si:review` skill. Be specific — include line numbers, exact text, and concrete suggestions.
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
- /si:remember "explanation of what went wrong and the fix"
107
- Or if this is a known pattern, check: /si:review
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) → /si:review (analyze) → /si:promote (graduate)
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 /si:status** — monitor capacity before it becomes a problem
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. /si:review identifies candidate
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. /si:promote writes to CLAUDE.md or rules/
80
+ 4. /self-improving-agent promote writes to CLAUDE.md or rules/
81
81
  5. Remove from MEMORY.md
82
- 6. Verify with /si:status
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
- | `/si:promote` suggests a file-type-specific pattern | Create or append to a rule file |
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": "/si:review",
14
- "promote": "/si:promote",
15
- "extract": "/si:extract",
16
- "status": "/si:status",
17
- "remember": "/si: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
- # /si:extract — Create Skills from Patterns
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
- /si:extract <pattern description> # Interactive extraction
18
- /si:extract <pattern> --name docker-m1-fixes # Specify skill name
19
- /si:extract <pattern> --output ./skills/ # Custom output directory
20
- /si:extract <pattern> --dry-run # Preview without creating files
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
- /si:extract "Fix for Docker builds failing on Apple Silicon with platform mismatch"
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
- /si:extract "Always regenerate TypeScript API client after modifying OpenAPI spec"
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
- # /si:promote — Graduate Learnings to Rules
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
- /si:promote <pattern description> # Auto-detect best target
18
- /si:promote <pattern> --target claude.md # Promote to CLAUDE.md
19
- /si:promote <pattern> --target rules/testing.md # Promote to scoped rule
20
- /si:promote <pattern> --target rules/api.md --paths "src/api/**/*.ts" # Scoped with paths
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
- # /si:remember — Save Knowledge Explicitly
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
- /si:remember <what to remember>
18
- /si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"
19
- /si:remember "The /api/auth endpoint uses a custom JWT library, not passport"
20
- /si:remember "Reza prefers explicit error handling over try-catch-all patterns"
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 /si:review to free space.
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 /si:promote it instead?
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 /si:remember for
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 `/si:promote` to write directly to CLAUDE.md
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