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
@@ -37,7 +37,7 @@ Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/e
37
37
  No installation needed — Arcane runs via `npx`:
38
38
 
39
39
  ```bash
40
- npx claude-code-arcane install backend-ts+agile
40
+ npx claude-code-arcane install backend-typescript+agile
41
41
  ```
42
42
 
43
43
  That's it. `npx` downloads and runs the latest version automatically.
@@ -49,7 +49,7 @@ That's it. `npx` downloads and runs the latest version automatically.
49
49
  cd ~/projects/my-app
50
50
 
51
51
  # 2. Install a profile
52
- npx claude-code-arcane install backend-ts+agile
52
+ npx claude-code-arcane install backend-typescript+agile
53
53
 
54
54
  # 3. Open Claude Code
55
55
  claude
@@ -69,10 +69,10 @@ Your project now has skills, agents, hooks, rules, and permissions tailored for
69
69
  npx claude-code-arcane install
70
70
 
71
71
  # Install a specific profile
72
- npx claude-code-arcane install backend-ts
72
+ npx claude-code-arcane install backend-typescript
73
73
 
74
74
  # Combine profiles with +
75
- npx claude-code-arcane install backend-ts+agile+testing
75
+ npx claude-code-arcane install backend-typescript+agile+testing
76
76
 
77
77
  # Install to a specific directory (default: current dir)
78
78
  npx claude-code-arcane install unity-dev --target ~/projects/my-game
@@ -178,7 +178,7 @@ Removes `.claude/` and `.claude.bak/` from the current directory. Requires `--fo
178
178
 
179
179
  ```bash
180
180
  # Create worktree + install Arcane in one step
181
- npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
181
+ npx claude-code-arcane worktree feat/new-api --profile backend-typescript+agile
182
182
 
183
183
  # Inherits profile from current installation
184
184
  npx claude-code-arcane worktree feat/new-api
@@ -219,9 +219,9 @@ All profiles are equal — pick any combination that fits your work. They are gr
219
219
 
220
220
  | Category | Profiles |
221
221
  |----------|----------|
222
- | **Backend** | `backend-ts`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
223
- | **Frontend & Design** | `frontend`, `design` |
224
- | **Mobile** | `mobile`, `flutter`, `android-native`, `ios-native` |
222
+ | **Backend** | `backend-typescript`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
223
+ | **Frontend & Design** | `frontend-react-vite`, `design` |
224
+ | **Mobile** | `mobile-react-native`, `mobile-flutter`, `mobile-android-kotlin`, `mobile-ios-swift` |
225
225
  | **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio`, `meshy`, `blender` |
226
226
  | **Platform & Quality** | `infra`, `database`, `security`, `testing`, `ai` |
227
227
  | **Project Management** | `agile`, `jira`, `clickup`, `integrations` |
@@ -229,6 +229,8 @@ All profiles are equal — pick any combination that fits your work. They are gr
229
229
  | **Personal** | `second-brain`, `job-hunt`, `freelance` |
230
230
  | **Utilities** | `docs`, `self-improving`, `statusline` |
231
231
 
232
+ Older names still install and update: `backend-ts`, `frontend`, `mobile`, `flutter`, `ios-native` and `android-native` resolve to `backend-typescript`, `frontend-react-vite`, `mobile-react-native`, `mobile-flutter`, `mobile-ios-swift` and `mobile-android-kotlin`.
233
+
232
234
  ### Core (always included)
233
235
 
234
236
  Every installation automatically loads `core.yaml` first:
@@ -255,7 +257,7 @@ npx claude-code-arcane install <profile>[+<profile>][+<profile>...]
255
257
 
256
258
  1. **Always explicit** — there is no "full" or "all" profile. You choose what you need.
257
259
  2. **Core is automatic** — the 21 universal skills and all hooks are always included.
258
- 3. **All profiles combine freely** — `unity-dev+unity-design`, `backend-go+frontend`, or `backend-ts+agile+testing`; there is no required "base".
260
+ 3. **All profiles combine freely** — `unity-dev+unity-design`, `backend-go+frontend-react-vite`, or `backend-typescript+agile+testing`; there is no required "base".
259
261
  4. **Deduplication is automatic** — overlapping skills across profiles are installed once.
260
262
  5. **Replace, not merge** — installing a new profile replaces the previous one entirely (with backup).
261
263
 
@@ -269,7 +271,7 @@ After the initial install, you can incrementally add or remove skills and profil
269
271
 
270
272
  ```bash
271
273
  # Start with a profile
272
- npx claude-code-arcane install backend-ts
274
+ npx claude-code-arcane install backend-typescript
273
275
 
274
276
  # Later, add testing and security
275
277
  npx claude-code-arcane add +testing +security
@@ -292,7 +294,7 @@ npx claude-code-arcane remove docker-setup
292
294
 
293
295
  # Start over completely
294
296
  npx claude-code-arcane clean --force
295
- npx claude-code-arcane install backend-ts+agile
297
+ npx claude-code-arcane install backend-typescript+agile
296
298
  ```
297
299
 
298
300
  ---
@@ -305,7 +307,7 @@ Work on multiple features in parallel using git worktrees, each with its own Arc
305
307
 
306
308
  ```bash
307
309
  # Create worktree + install Arcane in one step
308
- npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
310
+ npx claude-code-arcane worktree feat/new-api --profile backend-typescript+agile
309
311
 
310
312
  # Inherits profile from current installation
311
313
  npx claude-code-arcane worktree feat/new-api
@@ -368,25 +370,25 @@ npx claude-code-arcane install unity-dev+unity-design+agile+clickup
368
370
  npx claude-code-arcane install backend-go+infra+agile+jira
369
371
 
370
372
  # Full-stack monorepo
371
- npx claude-code-arcane install backend-ts+frontend+testing+database
373
+ npx claude-code-arcane install backend-typescript+frontend-react-vite+testing+database
372
374
 
373
375
  # Mobile app with CI/CD
374
- npx claude-code-arcane install mobile+agile+clickup+testing
376
+ npx claude-code-arcane install mobile-react-native+agile+clickup+testing
375
377
 
376
378
  # Secure backend with docs
377
- npx claude-code-arcane install backend-ts+security+docs+database
379
+ npx claude-code-arcane install backend-typescript+security+docs+database
378
380
 
379
381
  # AI/ML project with data pipelines
380
382
  npx claude-code-arcane install backend-go+ai+infra
381
383
 
382
384
  # SaaS with full marketing stack
383
- npx claude-code-arcane install backend-ts+marketing+business+finance
385
+ npx claude-code-arcane install backend-typescript+marketing+business+finance
384
386
 
385
387
  # Regulated medical device
386
- npx claude-code-arcane install backend-ts+regulatory+security+testing
388
+ npx claude-code-arcane install backend-typescript+regulatory+security+testing
387
389
 
388
390
  # With status bar
389
- npx claude-code-arcane install backend-ts+agile+statusline
391
+ npx claude-code-arcane install backend-typescript+agile+statusline
390
392
  ```
391
393
 
392
394
  ---
@@ -414,7 +416,7 @@ La lista `agents:` de un profile acepta dos formas:
414
416
 
415
417
  ```yaml
416
418
  agents:
417
- - game # la división entera: 30 agentes
419
+ - game # la división entera: 32 agentes
418
420
  - quality/security-architect # solo ese agente
419
421
  ```
420
422
 
@@ -450,8 +452,8 @@ Every installation creates `.claude/arcane-manifest.json`:
450
452
  {
451
453
  "arcane_version": "1.0.0",
452
454
  "cli": "npm",
453
- "profile_command": "backend-ts+agile",
454
- "profiles": ["core", "backend-ts", "agile"],
455
+ "profile_command": "backend-typescript+agile",
456
+ "profiles": ["core", "backend-typescript", "agile"],
455
457
  "installed_at": "2026-05-25T15:30:00Z",
456
458
  "total_skills": 56,
457
459
  "total_rules": 6,
@@ -523,7 +525,7 @@ mv ~/projects/my-game/.claude.bak ~/projects/my-game/.claude
523
525
 
524
526
  ### Can I combine multiple stack profiles?
525
527
 
526
- Yes. `backend-go+frontend` gives you both Go backend and React frontend skills. Duplicate skills are automatically deduplicated.
528
+ Yes. `backend-go+frontend-react-vite` gives you both Go backend and React frontend skills. Duplicate skills are automatically deduplicated.
527
529
 
528
530
  ### Does the profile persist between Claude Code sessions?
529
531
 
@@ -49,7 +49,7 @@ Cuando un agente es invocado como "gate" (approval gate), debe empezar la respue
49
49
 
50
50
  Luego el rationale. El token en la primera línea permite que el skill orquestador lo parsee.
51
51
 
52
- **Escalation:** Cuando múltiples gates corren en paralelo, aplica el verdict más estricto — un REJECT override cualquier APPROVE. Ver `director-gates.md` para gates definidos.
52
+ **Escalation:** Cuando múltiples gates corren en paralelo, aplica el verdict más estricto — un REJECT override cualquier APPROVE.
53
53
 
54
54
  ## Regla #6 — Cross-Division Collaboration
55
55
 
@@ -1,31 +1,40 @@
1
1
  # Estructura de Directorios
2
2
 
3
+ Hay dos layouts distintos y conviene no mezclarlos:
4
+
5
+ - **El repo** (`claude-code-arcane/`): la fuente. Acá se edita el contenido y el instalador.
6
+ - **Un proyecto instalado** (`<proyecto>/.claude/`): lo que `npx claude-code-arcane install <profile>` copia. Solo llega lo que algún profile lista.
7
+
8
+ ## El repo
9
+
3
10
  ```
4
- Claude-Code-Arcane/
5
- ├── CLAUDE.md # Configuración maestra
6
- ├── README.md # Documentación del repo
7
- ├── pyproject.toml # Python package config
11
+ claude-code-arcane/
12
+ ├── CLAUDE.md # Guía para trabajar en este repo
13
+ ├── README.md # Documentación pública
14
+ ├── CHANGELOG.md # Generado por semantic-release, no se edita a mano
15
+ ├── ATTRIBUTION.md # Origen del contenido adaptado de terceros
8
16
  ├── LICENSE
9
- ├── .gitignore
17
+ ├── package.json # CLI npm: build (tsup), test (vitest), test:skills (Python)
18
+ ├── tsconfig.json
19
+ ├── vitest.config.ts # Aísla ARCANE_SOURCE y ARCANE_HOME para la suite
20
+ ├── .releaserc.json # semantic-release
21
+ │
22
+ ├── src/ # Instalador TypeScript (único código con build y typecheck)
23
+ │ ├── cli.ts # Entry point: arcane install/add/remove/update/...
24
+ │ ├── commands/ # Un archivo por subcomando
25
+ │ ├── installer.ts # Copia contenido a .claude/ y genera settings.json
26
+ │ ├── profiles.ts # Parser y merge de profiles/*.yaml
27
+ │ ├── agent-entries.ts # Entradas de agentes: división entera o agente suelto
28
+ │ ├── content-source.ts, cache.ts # Fuente del contenido: bundled / github / cache
29
+ │ ├── manifest.ts, content-hash.ts # arcane-manifest.json y hashes para update
30
+ │ ├── registry.ts # ~/.arcane/installations.json
31
+ │ ├── worktree.ts # Instalación en git worktrees
32
+ │ ├── wizard.ts, detect.ts # Wizard interactivo y auto-detección de stack
33
+ │ └── __tests__/ # Suite vitest, incluidos los invariantes de docs
10
34
  │
11
- ├── arcane/ # Python CLI (installer, profiles parser)
12
- │ ├── cli.py # Entry point: arcane install/list/clean
13
- │ ├── installer.py # Profile installer logic
14
- │ └── profiles.py # Profile parser & merger
35
+ ├── profiles/ # Profiles declarativos (.yaml); core.yaml siempre se carga
15
36
  │
16
- ├── profiles/ # 27 profile definitions (.profile)
17
- │ ├── core.profile # Always included (21 skills, hooks, rules)
18
- │ ├── backend-go.profile # Base: Go backend
19
- │ ├── backend-ts.profile # Base: TypeScript backend
20
- │ ├── frontend.profile # Base: React frontend
21
- │ ├── unity-dev.profile # Base: Unity programmer
22
- │ ├── ai.profile # Add-on: AI/ML
23
- │ ├── clevel.profile # Add-on: C-suite advisory
24
- │ ├── business.profile # Add-on: Business ops
25
- │ ├── marketing.profile # Add-on: Marketing
26
- │ ├── finance.profile # Add-on: Finance
27
- │ ├── regulatory.profile # Add-on: Regulatory & compliance
28
- │ └── ... # agile, testing, infra, security, etc.
37
+ ├── skills/ # Un directorio por skill: SKILL.md + references/ + scripts/
29
38
  │
30
39
  ├── agents/ # 115 agent definitions (root level)
31
40
  │ ├── ai/ # 4 agents
@@ -46,116 +55,78 @@ Claude-Code-Arcane/
46
55
  │ ├── regulatory/ # 3 agents
47
56
  │ └── visualnovel/ # 6 agents
48
57
  │
49
- ├── .claude/ # Claude Code configuration
50
- │ ├── settings.json # Hooks, permissions, safety
51
- │ ├── settings.local.json # User-specific overrides (gitignored)
52
- │ ├── statusline.sh # Status line bash script
53
- │ ├── setup-skill-junctions.bat # Windows: create skill junctions
54
- │ ├── remove-skill-junctions.bat # Windows: remove skill junctions
55
- │ │
56
- │ ├── skills-agile/ # 35 agile/PM skills
57
- │ ├── skills-ai/ # 7 AI/ML skills
58
- │ ├── skills-arcane/ # 7 Arcane self-management skills
59
- │ ├── skills-backend/ # 45 backend skills
60
- │ ├── skills-business/ # 4 business skills
61
- │ ├── skills-clevel-advisors/ # 10 C-suite advisor skills
62
- │ ├── skills-clevel-operations/ # 18 C-suite operations skills
63
- │ ├── skills-design/ # 9 design skills
64
- │ ├── skills-devops/ # 17 DevOps/infra skills
65
- │ ├── skills-docs/ # 13 documentation skills
66
- │ ├── skills-finance/ # 3 finance skills
67
- │ ├── skills-frontend/ # 9 frontend skills
68
- │ ├── skills-gamedev/ # 19 gamedev skills + _rules/ + _templates/
69
- │ ├── skills-git/ # 21 git workflow skills
70
- │ ├── skills-integrations/ # 3 integration skills
71
- │ ├── skills-marketing-content/ # 8 content marketing skills
72
- │ ├── skills-marketing-growth/ # 10 growth marketing skills
73
- │ ├── skills-marketing-seo/ # 11 SEO/CRO skills
74
- │ ├── skills-marketing-strategy/ # 15 marketing strategy skills
75
- │ ├── skills-mobile/ # 5 mobile skills
76
- │ ├── skills-regulatory/ # 13 regulatory/compliance skills
77
- │ ├── skills-release/ # 5 release skills
78
- │ ├── skills-security/ # 9 security skills
79
- │ ├── skills-testing/ # 13 testing skills
80
- │ │
81
- │ ├── hooks/ # 14 lifecycle hooks
82
- │ │ ├── session-start.sh
83
- │ │ ├── session-stop.sh
84
- │ │ ├── detect-division.sh
85
- │ │ ├── detect-gaps.sh
86
- │ │ ├── validate-commit.sh
87
- │ │ ├── validate-push.sh
88
- │ │ ├── validate-secrets.sh
89
- │ │ ├── validate-assets.sh
90
- │ │ ├── validate-skill-change.sh
91
- │ │ ├── notify.sh
92
- │ │ ├── pre-compact.sh
93
- │ │ ├── post-compact.sh
94
- │ │ ├── log-agent.sh
95
- │ │ └── log-agent-stop.sh
96
- │ │
97
- │ ├── rules/ # 9 path-scoped rules
98
- │ │ ├── backend-code.md
99
- │ │ ├── frontend-code.md
100
- │ │ ├── api-code.md
101
- │ │ ├── migration-code.md
102
- │ │ ├── infra-code.md
103
- │ │ ├── ai-code.md
104
- │ │ ├── data-files.md
105
- │ │ ├── test-standards.md
106
- │ │ └── prototype-code.md
107
- │ │
108
- │ └── docs/ # Internal documentation
109
- │ ├── division-structure.md
110
- │ ├── agent-hierarchy.md
111
- │ ├── directory-structure.md # This file
112
- │ ├── coding-standards.md
113
- │ ├── technical-preferences.md
114
- │ ├── coordination-rules.md
115
- │ ├── context-management.md
116
- │ ├── workflow-catalog.yaml
117
- │ ├── stack-registry.md
118
- │ └── templates/
58
+ ├── rules/ # Rules universales (rules.universal en los profiles)
59
+ │ └── gamedev/ # Rules de gamedev (rules.gamedev en los profiles)
119
60
  │
120
- ├── docs/ # Public documentation
121
- │ ├── SKILLS-CATALOG.md # Complete skill catalog
122
- │ └── USER-GUIDE.md # User guide
61
+ ├── hooks/ # Scripts bash de lifecycle; statusline.sh incluido
62
+ ├── output-styles/ # Output styles (arcane.md)
63
+ ├── templates/
64
+ │ └── gamedev/ # Plantillas de GDD y docs de juego
65
+ ├── docs/ # Documentación; se copia entera a .claude/docs/
66
+ │ ├── templates/ # Plantillas de ADR, PRD, RFC, test plan, etc.
67
+ │ ├── gates/ # Gates de fase (software y gamedev)
68
+ │ └── gamedev/, software/ # coding-standards por dominio
123
69
  │
124
- ├── tools/ # Migration & wrapper scripts
125
- │ ├── arcane.sh # Legacy bash installer
126
- │ ├── arcane.bat # Windows wrapper
127
- │ └── migrate-*.sh # Migration tools
128
- │
129
- ├── skills-selftest/ # QA framework for skills/agents
70
+ ├── skills-selftest/ # QA de skills y agentes (no se instala)
130
71
  │ ├── CLAUDE.md
131
- │ ├── catalog.yaml # Registry: 305 skills + 94 agents
132
- │ ├── quality-rubric.md
133
- │ ├── skills/[category]/ # Behavioral specs per skill
134
- │ ├── agents/[tier]/ # Behavioral specs per agent
135
- │ ├── templates/
136
- │ └── results/ # Test outputs (gitignored)
72
+ │ ├── catalog.yaml # Registro de skills y agentes con su spec
73
+ │ ├── quality-rubric.md # Métricas por categoría
74
+ │ ├── skills/<categoria>/ # Specs de comportamiento por skill
75
+ │ ├── agents/<tier>/ # Specs de comportamiento por agente
76
+ │ └── templates/ # Plantillas para specs nuevos
137
77
  │
138
- └── production/ # Runtime state
139
- └── session-state/
78
+ ├── tests/ # Specs Python de los scripts de skills (npm run test:skills)
79
+ ├── maintainers/ # Cómo publicar Arcane (release, npm). No se instala ni se publica
80
+ ├── scripts/ # Utilidades de mantenimiento del repo
81
+ ├── .github/workflows/ # ci.yml (vitest, typecheck, specs Python) y release.yml (semantic-release)
82
+ └── .claude/ # La instalación de Arcane que usa este mismo repo
140
83
  ```
141
84
 
142
- ## Rules Split Policy
85
+ ## Un proyecto instalado
143
86
 
144
- - **`.claude/rules/`** — reglas universales que aplican a cualquier stack software (backend APIs, frontends web/mobile, DBs, infra, LLM apps). Usan paths genéricos (`src/api/**`, `src/components/**`, `migrations/**`).
145
- - **`.claude/skills-gamedev/_rules/`** — reglas exclusivas de gamedev (frame budgets, shaders, NPC AI, GDDs, lore). Usan paths gamedev (`src/gameplay/**`, `assets/shaders/**`, `design/gdd/**`, `design/narrative/**`).
87
+ ```
88
+ <proyecto>/
89
+ ├── .claude/
90
+ │ ├── settings.json # Generado: permisos, hooks y statusline
91
+ │ ├── arcane-manifest.json # Profiles instalados y content_hashes de cada archivo
92
+ │ ├── skills/<skill>/ # Los skills de los profiles elegidos, con sus references/ y scripts/
93
+ │ │ └── _templates/ # templates/gamedev/, solo si algún profile trae rules de gamedev
94
+ │ ├── agents/<division>/ # Divisiones enteras o agentes sueltos, según el profile
95
+ │ ├── rules/ # Universales y de gamedev juntas, en un solo nivel
96
+ │ ├── hooks/ # Todos los hooks de hooks/ salvo statusline.sh
97
+ │ ├── statusline.sh # Solo con el profile statusline
98
+ │ ├── output-styles/ # Solo si algún profile declara output_styles
99
+ │ ├── docs/ # Copia de docs/; arcane update la mantiene al día
100
+ │ └── .arcane-trash/ # Lo que arcane update saca; nunca se borra con rm
101
+ ├── .claude.bak/ # Backup de .claude/ antes de instalar
102
+ └── production/session-state/ # Estado de sesión que escriben los hooks
103
+ ```
146
104
 
147
- Cuando un proyecto es dual (ej. web + game), ambos sets de rules aplican por sus paths scoped.
105
+ Fuera del proyecto, `~/.arcane/` guarda el registro de instalaciones (`installations.json`) y el contenido descargado de GitHub (`cache/<version>/`). `ARCANE_HOME` lo desvía.
148
106
 
149
- ## Hook Events Wiring
107
+ En un git worktree, `hooks/` y `docs/` son symlinks al worktree principal; `skills/`, `agents/` y `rules/` se copian para que puedan divergir por rama.
150
108
 
151
- Ver `settings.json`. Los eventos wireados:
109
+ ## Rules: dos carpetas en el repo, una en el proyecto
110
+
111
+ - **`rules/`**: reglas para cualquier stack de software (backend, frontend, APIs, DBs, infra, apps LLM). Paths genéricos como `src/api/**` o `src/components/**`.
112
+ - **`rules/gamedev/`**: reglas exclusivas de gamedev (frame budgets, shaders, IA de NPCs, GDDs, lore). Paths como `src/gameplay/**`, `assets/shaders/**` o `design/gdd/**`.
113
+
114
+ El installer copia las dos al mismo `.claude/rules/`, sin subcarpeta. Por eso un nombre no puede repetirse entre las dos carpetas: el segundo archivo pisaría al primero. La rule de apps LLM se llama `llm-code.md` justamente para no chocar con `gamedev/ai-code.md`, que es la de IA de NPCs.
115
+
116
+ Cuando un proyecto es dual (por ejemplo web + juego), las dos familias aplican cada una por sus paths.
117
+
118
+ ## Hooks: cómo se cablean
119
+
120
+ Los eventos los define `src/installer.ts` al generar `settings.json`, no los profiles. Todo proyecto instalado recibe estos:
152
121
 
153
122
  | Evento | Hooks |
154
123
  |--------|-------|
155
- | SessionStart | session-start.sh → detect-division.sh → detect-gaps.sh |
156
- | PreToolUse (Bash) | validate-commit.sh, validate-push.sh, validate-secrets.sh |
157
- | PostToolUse (Write/Edit) | validate-assets.sh, validate-skill-change.sh |
158
- | Notification | notify.sh |
159
- | PreCompact / PostCompact | pre-compact.sh / post-compact.sh |
160
- | Stop | session-stop.sh |
161
- | SubagentStart / SubagentStop | log-agent.sh / log-agent-stop.sh |
124
+ | SessionStart | `session-start.sh` → `detect-division.sh` → `detect-unreal.sh` → `detect-gaps.sh` → `check-update.sh` |
125
+ | PreToolUse (`Bash`) | `validate-commit.sh`, `validate-push.sh`, `validate-secrets.sh` |
126
+ | PostToolUse (`Write\|Edit`) | `validate-assets.sh`, `validate-skill-change.sh` |
127
+ | Notification | `notify.sh` |
128
+ | PreCompact / PostCompact | `pre-compact.sh` / `post-compact.sh` |
129
+ | Stop | `session-stop.sh` |
130
+ | SubagentStart / SubagentStop | `log-agent.sh` / `log-agent-stop.sh` |
131
+
132
+ La statusline (`statusline.sh`) se configura aparte, solo con el profile `statusline`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-code-arcane",
3
- "version": "2.9.8",
3
+ "version": "2.10.0",
4
4
  "description": "Skills, agents, hooks and rules for Claude Code — installable via npx claude-code-arcane",
5
5
  "type": "module",
6
6
  "bin": {
package/profiles/ai.yaml CHANGED
@@ -10,6 +10,9 @@ skills:
10
10
  - senior-data-scientist
11
11
  - senior-ml-engineer
12
12
  - senior-prompt-engineer
13
+ - agent-designer
14
+ - agent-workflow-designer
15
+ - mcp-server-builder
13
16
 
14
17
  rules:
15
18
  universal:
@@ -1,4 +1,6 @@
1
+ # Bridge for CLIs released before this profile was renamed: they look it up as 'android-native'. Keep identical to mobile-android-kotlin.yaml.
1
2
  name: android-native
3
+ renamed_to: mobile-android-kotlin
2
4
  description: "Android native — Kotlin + Jetpack Compose + Material Design 3"
3
5
  category: mobile
4
6
 
@@ -27,20 +27,13 @@ skills:
27
27
  - audit-log
28
28
  - slo-sli
29
29
  - ci-cd-setup
30
- - agent-designer
31
- - agent-workflow-designer
32
- - email-template-builder
33
- - mcp-server-builder
34
- - ms365-tenant-manager
35
- - snowflake-development
36
- - stripe-integration-expert
37
- - tech-stack-evaluator
38
30
 
39
31
  rules:
40
32
  universal:
41
33
  - backend-code
42
34
  - api-code
43
35
  - migration-code
36
+ - llm-code
44
37
  gamedev:
45
38
  []
46
39
 
@@ -1,4 +1,6 @@
1
+ # Bridge for CLIs released before this profile was renamed: they look it up as 'backend-ts'. Keep identical to backend-typescript.yaml.
1
2
  name: backend-ts
3
+ renamed_to: backend-typescript
2
4
  description: "Backend TypeScript — Fastify, Prisma, Zod, API design, CI"
3
5
  category: backend
4
6
 
@@ -28,14 +30,6 @@ skills:
28
30
  - websocket-realtime-rooms
29
31
  - search-setup
30
32
  - ci-cd-setup
31
- - agent-designer
32
- - agent-workflow-designer
33
- - email-template-builder
34
- - mcp-server-builder
35
- - ms365-tenant-manager
36
- - snowflake-development
37
- - stripe-integration-expert
38
- - tech-stack-evaluator
39
33
 
40
34
  rules:
41
35
  universal:
@@ -0,0 +1,51 @@
1
+ name: backend-typescript
2
+ description: "Backend TypeScript — Fastify, Prisma, Zod, API design, CI"
3
+ category: backend
4
+
5
+ skills:
6
+ - testing
7
+ - deps-audit
8
+ - env-sync
9
+ - observability
10
+ - scaffold-fastify-ts
11
+ - database
12
+ - api-design
13
+ - api-docs
14
+ - api-versioning
15
+ - auth-strategy
16
+ - jwt-strategy
17
+ - mfa-setup
18
+ - oauth-setup
19
+ - rbac-abac
20
+ - performance
21
+ - async-ops
22
+ - audit-log
23
+ - monorepo-setup
24
+ - data-migrations
25
+ - caching-strategy
26
+ - webhooks
27
+ - rate-limiting
28
+ - websocket-realtime-rooms
29
+ - search-setup
30
+ - ci-cd-setup
31
+
32
+ rules:
33
+ universal:
34
+ - backend-code
35
+ - api-code
36
+ - migration-code
37
+ gamedev:
38
+ []
39
+
40
+ agents:
41
+ - engineering
42
+
43
+ permissions:
44
+ allow:
45
+ - "Bash(npm *)"
46
+ - "Bash(yarn *)"
47
+ - "Bash(pnpm *)"
48
+ - "Bash(docker ps*)"
49
+ - "Bash(docker images*)"
50
+ deny:
51
+ []
@@ -1,4 +1,6 @@
1
+ # Bridge for CLIs released before this profile was renamed: they look it up as 'flutter'. Keep identical to mobile-flutter.yaml.
1
2
  name: flutter
3
+ renamed_to: mobile-flutter
2
4
  description: "Flutter + Dart cross-platform development"
3
5
  category: mobile
4
6
 
@@ -0,0 +1,39 @@
1
+ name: frontend-react-vite
2
+ description: "Frontend React + Vite + TypeScript"
3
+ category: frontend
4
+
5
+ skills:
6
+ - testing
7
+ - i18n-setup
8
+ - deps-audit
9
+ - env-sync
10
+ - observability
11
+ - release
12
+ - onboard
13
+ - scaffold-react-vite
14
+ - state-management
15
+ - form-validation
16
+ - accessibility
17
+ - web-security
18
+ - ci-cd-setup
19
+ - cdn-setup
20
+ - file-uploads
21
+ - frontend-dev
22
+ - csp-headers
23
+
24
+ rules:
25
+ universal:
26
+ - frontend-code
27
+ gamedev:
28
+ []
29
+
30
+ agents:
31
+ - engineering
32
+
33
+ permissions:
34
+ allow:
35
+ - "Bash(npm *)"
36
+ - "Bash(yarn *)"
37
+ - "Bash(pnpm *)"
38
+ deny:
39
+ []
@@ -1,4 +1,6 @@
1
+ # Bridge for CLIs released before this profile was renamed: they look it up as 'frontend'. Keep identical to frontend-react-vite.yaml.
1
2
  name: frontend
3
+ renamed_to: frontend-react-vite
2
4
  description: "Frontend React + Vite + TypeScript"
3
5
  category: frontend
4
6
 
@@ -1,11 +1,16 @@
1
1
  name: integrations
2
- description: "Integraciones externas — GitHub Projects, Slack, Postman"
2
+ description: "Integraciones externas — GitHub Projects, Slack, Postman, Stripe, email templates, Microsoft 365, Snowflake, evaluación de stack"
3
3
  category: management
4
4
 
5
5
  skills:
6
6
  - gh-projects
7
7
  - slack
8
8
  - postman
9
+ - stripe-integration-expert
10
+ - email-template-builder
11
+ - ms365-tenant-manager
12
+ - snowflake-development
13
+ - tech-stack-evaluator
9
14
 
10
15
  rules:
11
16
  universal:
@@ -1,4 +1,6 @@
1
+ # Bridge for CLIs released before this profile was renamed: they look it up as 'ios-native'. Keep identical to mobile-ios-swift.yaml.
1
2
  name: ios-native
3
+ renamed_to: mobile-ios-swift
2
4
  description: "iOS native — Swift + UIKit/SwiftUI + Apple HIG"
3
5
  category: mobile
4
6
 
@@ -0,0 +1,36 @@
1
+ name: mobile-android-kotlin
2
+ description: "Android native — Kotlin + Jetpack Compose + Material Design 3"
3
+ category: mobile
4
+
5
+ skills:
6
+ - testing
7
+ - deps-audit
8
+ - env-sync
9
+ - observability
10
+ - release
11
+ - onboard
12
+ - perf-profile
13
+ - android-native-dev
14
+ - state-management
15
+ - form-validation
16
+ - accessibility
17
+ - auth-strategy
18
+ - ci-cd-setup
19
+ - deploy-check
20
+
21
+ rules:
22
+ universal:
23
+ []
24
+ gamedev:
25
+ []
26
+
27
+ agents:
28
+ - engineering
29
+
30
+ permissions:
31
+ allow:
32
+ - "Bash(./gradlew *)"
33
+ - "Bash(gradle *)"
34
+ - "Bash(adb *)"
35
+ deny:
36
+ []