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
package/docs/USER-GUIDE.md
CHANGED
|
@@ -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-
|
|
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-
|
|
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-
|
|
72
|
+
npx claude-code-arcane install backend-typescript
|
|
73
73
|
|
|
74
74
|
# Combine profiles with +
|
|
75
|
-
npx claude-code-arcane install backend-
|
|
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-
|
|
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-
|
|
223
|
-
| **Frontend & Design** | `frontend`, `design` |
|
|
224
|
-
| **Mobile** | `mobile`, `flutter`, `android-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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:
|
|
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-
|
|
454
|
-
"profiles": ["core", "backend-
|
|
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.
|
|
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
|
-
|
|
5
|
-
├── CLAUDE.md #
|
|
6
|
-
├── README.md # Documentación
|
|
7
|
-
├──
|
|
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
|
-
├── .
|
|
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
|
-
├──
|
|
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
|
-
├──
|
|
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
|
-
├──
|
|
50
|
-
│
|
|
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
|
-
├──
|
|
121
|
-
|
|
122
|
-
|
|
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
|
-
├──
|
|
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 #
|
|
132
|
-
│ ├── quality-rubric.md
|
|
133
|
-
│ ├── skills
|
|
134
|
-
│ ├── agents
|
|
135
|
-
│
|
|
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
|
-
|
|
139
|
-
|
|
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
|
-
##
|
|
85
|
+
## Un proyecto instalado
|
|
143
86
|
|
|
144
|
-
|
|
145
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
157
|
-
| PostToolUse (Write
|
|
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
package/profiles/ai.yaml
CHANGED
|
@@ -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
|
|
package/profiles/backend-go.yaml
CHANGED
|
@@ -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
|
|
package/profiles/backend-ts.yaml
CHANGED
|
@@ -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
|
+
[]
|
package/profiles/flutter.yaml
CHANGED
|
@@ -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
|
+
[]
|
package/profiles/frontend.yaml
CHANGED
|
@@ -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:
|
package/profiles/ios-native.yaml
CHANGED
|
@@ -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
|
+
[]
|