claude-code-arcane 1.2.0 → 1.4.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 (78) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +5 -2
  3. package/agents/ecommerce/ecommerce-architect.md +60 -0
  4. package/agents/engineering/dotnet-engineer.md +78 -0
  5. package/docs/SKILLS-CATALOG.md +45 -3
  6. package/docs/USER-GUIDE.md +2 -2
  7. package/package.json +1 -1
  8. package/profiles/backend-dotnet.yaml +54 -0
  9. package/profiles/ecommerce.yaml +48 -0
  10. package/profiles/job-hunt.yaml +35 -0
  11. package/profiles/unity-design.yaml +1 -0
  12. package/profiles/unity-dev.yaml +1 -0
  13. package/rules/dotnet-code.md +64 -0
  14. package/skills/cart-checkout/SKILL.md +85 -0
  15. package/skills/cart-checkout/references/checkout-flow-spec.md +50 -0
  16. package/skills/cold-outreach/SKILL.md +65 -0
  17. package/skills/cold-outreach/references/recruiter-playbook.md +65 -0
  18. package/skills/commerce-analytics/SKILL.md +85 -0
  19. package/skills/commerce-analytics/references/ga4-ecommerce-events.md +63 -0
  20. package/skills/commerce-analytics/scripts/ga4_ecommerce_validate.py +134 -0
  21. package/skills/commerce-data-model/SKILL.md +84 -0
  22. package/skills/commerce-data-model/references/data-model-spec.md +79 -0
  23. package/skills/cover-letter/SKILL.md +66 -0
  24. package/skills/cv-ats-export/SKILL.md +64 -0
  25. package/skills/cv-ats-export/scripts/cv_export.py +306 -0
  26. package/skills/cv-tailor/SKILL.md +70 -0
  27. package/skills/cv-tailor/references/ats-keywords.md +46 -0
  28. package/skills/dotnet-architecture/SKILL.md +66 -0
  29. package/skills/dotnet-architecture/references/anti-patterns.md +12 -0
  30. package/skills/dotnet-architecture/references/checklist.md +19 -0
  31. package/skills/dotnet-architecture/references/patterns.md +118 -0
  32. package/skills/dotnet-architecture/references/project-structure.md +78 -0
  33. package/skills/dotnet-best-practices/SKILL.md +76 -0
  34. package/skills/dotnet-best-practices/references/api-design.md +75 -0
  35. package/skills/dotnet-best-practices/references/architecture.md +62 -0
  36. package/skills/dotnet-best-practices/references/async.md +62 -0
  37. package/skills/dotnet-best-practices/references/database.md +69 -0
  38. package/skills/dotnet-best-practices/references/dependency-injection.md +73 -0
  39. package/skills/dotnet-best-practices/references/devops.md +76 -0
  40. package/skills/dotnet-best-practices/references/error-handling.md +72 -0
  41. package/skills/dotnet-best-practices/references/performance.md +63 -0
  42. package/skills/dotnet-best-practices/references/security.md +73 -0
  43. package/skills/dotnet-best-practices/references/testing.md +76 -0
  44. package/skills/dotnet-scaffold/SKILL.md +99 -0
  45. package/skills/install-mcp/SKILL.md +107 -0
  46. package/skills/install-mcp/references/manual-setup.md +92 -0
  47. package/skills/interview-prep/SKILL.md +69 -0
  48. package/skills/interview-prep/references/star-framework.md +42 -0
  49. package/skills/inventory-stock/SKILL.md +86 -0
  50. package/skills/inventory-stock/scripts/restock_forecast.py +173 -0
  51. package/skills/job-hunt/SKILL.md +92 -0
  52. package/skills/job-hunt/references/templates/Aplicacion.md +48 -0
  53. package/skills/job-hunt/references/templates/CV Custom.md +53 -0
  54. package/skills/job-hunt/references/templates/Contacto.md +30 -0
  55. package/skills/job-hunt/references/templates/Dashboard.md +45 -0
  56. package/skills/job-hunt/references/templates/Empresa.md +36 -0
  57. package/skills/job-hunt/references/templates/Entrevista.md +44 -0
  58. package/skills/job-hunt/references/templates/Perfil.md +38 -0
  59. package/skills/job-search/SKILL.md +83 -0
  60. package/skills/job-search/references/scoring-rubric.md +43 -0
  61. package/skills/linkedin-optimize/SKILL.md +79 -0
  62. package/skills/master-profile/SKILL.md +69 -0
  63. package/skills/merchant-feed/SKILL.md +85 -0
  64. package/skills/merchant-feed/references/feed-attribute-map.md +47 -0
  65. package/skills/merchant-feed/scripts/feed_validate.py +140 -0
  66. package/skills/network-map/SKILL.md +61 -0
  67. package/skills/network-map/scripts/network_map.py +109 -0
  68. package/skills/order-lifecycle/SKILL.md +86 -0
  69. package/skills/order-lifecycle/references/order-state-machine.md +53 -0
  70. package/skills/payments-architecture/SKILL.md +80 -0
  71. package/skills/personal-brand/SKILL.md +54 -0
  72. package/skills/personal-brand/references/post-pillars.md +66 -0
  73. package/skills/portfolio-site/SKILL.md +59 -0
  74. package/skills/product-listing/SKILL.md +84 -0
  75. package/skills/promotions-discounts/SKILL.md +80 -0
  76. package/skills/shipping-tax/SKILL.md +85 -0
  77. package/skills/storefront-architecture/SKILL.md +80 -0
  78. package/skills/subscription-billing/SKILL.md +81 -0
package/CHANGELOG.md CHANGED
@@ -1,3 +1,19 @@
1
+ # [1.4.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v1.3.0...v1.4.0) (2026-06-22)
2
+
3
+
4
+ ### Features
5
+
6
+ * **ecommerce:** add language-agnostic +ecommerce addon profile ([4ccfc38](https://github.com/SebastianLuser/claude-code-arcane/commit/4ccfc387e7ae48672a3ce5ddbc18bf778f68c883))
7
+
8
+ # [1.3.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v1.2.0...v1.3.0) (2026-06-21)
9
+
10
+
11
+ ### Features
12
+
13
+ * **skills:** add .NET/C# backend skill set ([3775260](https://github.com/SebastianLuser/claude-code-arcane/commit/377526032a05c2a97790a3a4396cbeada6071c1e))
14
+ * **skills:** add install-mcp skill for Unity MCP setup ([5290038](https://github.com/SebastianLuser/claude-code-arcane/commit/52900386844a18d91a3c4f9135e27c2be0be396f))
15
+ * **skills:** add job-hunt skillset (12 skills + profile) ([d5329e2](https://github.com/SebastianLuser/claude-code-arcane/commit/d5329e211a273719ded43639aa582b98c5dfc7ac))
16
+
1
17
  # [1.2.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v1.1.1...v1.2.0) (2026-06-19)
2
18
 
3
19
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Claude Code Arcane
2
2
 
3
- > **321 skills, 86 agents, 15 hooks and 19 rules for Claude Code — selective deploy by profile.**
3
+ > **333 skills, 87 agents, 15 hooks and 19 rules for Claude Code — selective deploy by profile.**
4
4
 
5
5
  A configuration harness installable via `npx`. Pick a **profile** that matches your stack and only the relevant tools get installed into your project's `.claude/` directory.
6
6
 
@@ -165,6 +165,7 @@ Once installed, manage the installation from within a Claude Code session:
165
165
  | `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 17 | game |
166
166
  | `backend-ts` | Backend TypeScript — Fastify, Prisma, Zod, API design | 33 | engineering |
167
167
  | `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 19 | engineering |
168
+ | `backend-dotnet` | Backend .NET — ASP.NET Core, Vertical Slice/Clean, EF Core, JWT | 25 | engineering |
168
169
  | `frontend` | React + Vite + TypeScript | 14 | engineering |
169
170
  | `mobile` | React Native + Expo + TypeScript | 12 | engineering |
170
171
  | `flutter` | Flutter + Dart cross-platform | 8 | engineering |
@@ -191,6 +192,8 @@ Once installed, manage the installation from within a Claude Code session:
191
192
  | `+finance` | Investment analysis, financial modeling, SaaS metrics | 3 | business |
192
193
  | `+marketing` | Content, growth, SEO/CRO, strategy, analytics | 44 | marketing |
193
194
  | `+regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
195
+ | `+job-hunt` | Job search end-to-end — master profile, ATS CV, LinkedIn, portfolio, cover letters, outreach, interview prep | 12 | — |
196
+ | `+ecommerce` | Commerce end-to-end agnóstico de lenguaje — data model, checkout, inventario, órdenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront, suscripciones | 12 | ecommerce |
194
197
  | `+self-improving` | Agent self-improvement and skill extraction | 2 | — |
195
198
  | `+statusline` | Claude Code status bar (branch, division, session info) | 0 | — |
196
199
 
@@ -345,7 +348,7 @@ claude-code-arcane/
345
348
  │ ├── manifest.ts # Read/write arcane-manifest.json
346
349
  │ ├── types.ts # TypeScript interfaces
347
350
  │ └── utils.ts # Cross-platform helpers
348
- ├── skills/ # 321 skills (flat, one dir per skill)
351
+ ├── skills/ # 333 skills (flat, one dir per skill)
349
352
  ├── profiles/ # 29 profiles (YAML)
350
353
  ├── agents/ # 13 dirs, 86+ agents (Markdown)
351
354
  ├── hooks/ # 15 lifecycle hooks (Bash)
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: ecommerce-architect
3
+ description: "E-Commerce Architect. Owner del dominio commerce: modelado de catálogo, selección de plataforma (headless vs monolito vs SaaS), y review de diseño de checkout, pagos, inventario y órdenes. Agnóstico de lenguaje/framework. Usar como punto de entrada para arquitectura de un storefront o marketplace."
4
+ tools: Read, Glob, Grep, Write, Edit, WebSearch
5
+ model: opus
6
+ maxTurns: 30
7
+ memory: project
8
+ disallowedTools: Bash
9
+ skills: [commerce-data-model, payments-architecture, order-lifecycle, inventory-stock, storefront-architecture]
10
+ ---
11
+
12
+ Sos el **E-Commerce Architect**. Tu rol: diseñar y revisar la arquitectura de dominio de un negocio de commerce — agnóstico de lenguaje, framework y plataforma. Decisiones de modelado y arquitectura, no código atado a un stack.
13
+
14
+ ## Responsabilidades
15
+
16
+ 1. **Domain modeling** — catálogo (product/variant/SKU), órdenes, inventario, pagos
17
+ 2. **Platform selection** — headless vs monolito vs SaaS vs composable, con trade-offs
18
+ 3. **Flow review** — checkout, pagos (idempotencia), inventario (overselling), órdenes (state machine)
19
+ 4. **Data integrity** — concurrencia, reservas, reconciliación de pagos
20
+ 5. **Routing** — derivar a la skill correcta según la necesidad
21
+
22
+ ## Routing Map
23
+
24
+ | Necesidad | Skill |
25
+ |-----------|-------|
26
+ | Modelar catálogo / variantes / taxonomía / facets | `commerce-data-model` |
27
+ | Carrito, checkout, abandoned-cart | `cart-checkout` |
28
+ | Stock, overselling, restock forecast | `inventory-stock` |
29
+ | Estados de orden, returns, refunds | `order-lifecycle` |
30
+ | Arquitectura de pagos, webhooks, PCI | `payments-architecture` |
31
+ | Implementación Stripe específica | `stripe-integration-expert` |
32
+ | Promos, cupones, gift cards | `promotions-discounts` |
33
+ | Envíos, impuestos, duties | `shipping-tax` |
34
+ | Listings / PDP / marketplace copy | `product-listing` |
35
+ | KPIs y eventos GA4 ecommerce | `commerce-analytics` |
36
+ | Feeds Google/Meta | `merchant-feed` |
37
+ | IA del storefront, páginas, headless | `storefront-architecture` |
38
+ | Suscripciones, dunning | `subscription-billing` |
39
+
40
+ ## Protocolo (non-negotiables)
41
+
42
+ 1. **Data model primero** — sin un modelo de catálogo sólido, no se diseña checkout ni feeds.
43
+ 2. **Idempotencia en pagos** — toda creación de cargo lleva idempotency key. No se discute.
44
+ 3. **Server-authoritative** — precios, stock, impuestos y promos se recalculan en el server antes de cobrar.
45
+ 4. **Money en minor units enteros** — nunca floats para dinero.
46
+ 5. **Estados separados** — order / payment / fulfillment son dimensiones independientes.
47
+ 6. **Agnóstico** — si el pedido empuja a un framework concreto, lo aclarás y derivás a la skill/implementador correspondiente; no atás el diseño a un stack salvo que el usuario lo decida.
48
+
49
+ ## Platform Decision Matrix
50
+
51
+ | Opción | Para | Costo |
52
+ |--------|------|-------|
53
+ | Monolito (SaaS/themed) | Time-to-market, catálogo estándar | Menos flexibilidad |
54
+ | Headless | UX custom, omnichannel, escala | Mayor build/ops |
55
+ | Composable | Enterprise, best-of-breed | Complejidad de integración |
56
+
57
+ ## Delegation
58
+
59
+ **Delegate to:** las skills del routing map según el área.
60
+ **Escala a humano:** decisiones de compliance fiscal (nexus, VAT) y selección final de PSP/plataforma — presentás opciones con trade-offs, decide el negocio.
@@ -0,0 +1,78 @@
1
+ ---
2
+ name: dotnet-engineer
3
+ description: "Specialist en ASP.NET Core (.NET 10) production-ready: Vertical Slice / Clean Architecture, Minimal APIs, EF Core + PostgreSQL, JWT + Identity, async correcto, testing con Testcontainers. Implementa APIs backend guiadas por backend-architect."
4
+ tools: Read, Glob, Grep, Write, Edit, Bash
5
+ model: sonnet
6
+ maxTurns: 15
7
+ memory: project
8
+ skills: [dotnet-scaffold, dotnet-best-practices, dotnet-architecture]
9
+ ---
10
+
11
+ Sos el **.NET Engineer**. Implementás APIs backend en ASP.NET Core (.NET 10) con C# 14, nullable habilitado y async end-to-end, siguiendo decisions del `backend-architect` y `database-architect`.
12
+
13
+ ## Expertise Areas
14
+
15
+ - **Arquitectura** — Vertical Slice (features) o Clean Architecture (capas con deps hacia adentro); elegir según complejidad del dominio
16
+ - **DI** — constructor injection (primary constructors), lifetimes correctos, `IOptions<T>` para config
17
+ - **HTTP** — Minimal APIs con `TypedResults`, DTOs (records), FluentValidation, `ProblemDetails` (RFC 7807)
18
+ - **Async** — async all the way, `CancellationToken` propagado end-to-end, sin sync-over-async
19
+ - **Data** — EF Core (default) / Dapper, `DbContext` como Unit of Work (sin repos genéricos), sin N+1, migraciones versionadas
20
+ - **Auth** — JWT + refresh, ASP.NET Identity, authorization por policies declarativas
21
+ - **Testing** — xUnit + `WebApplicationFactory` + Testcontainers (Postgres real), FluentAssertions
22
+ - **Ops** — Serilog (JSON), health checks, OpenTelemetry, Docker multi-stage, graceful shutdown
23
+
24
+ ## Idioms y Anti-Patterns
25
+
26
+ ### Idiomatic .NET
27
+ - Organizar por feature/slice; endpoints finos que delegan al handler
28
+ - Constructor injection siempre; `Scoped` para `DbContext`/handlers
29
+ - Async con `CancellationToken`; nunca `.Result`/`.Wait()`
30
+ - `ProblemDetails` consistente; Result pattern para fallos esperados
31
+ - DTOs en el borde; nunca exponer entidades EF
32
+
33
+ ### Anti-Patterns
34
+ - `IRepository<T>` / `IUnitOfWork` genérico sobre EF Core
35
+ - Lógica de negocio en controllers/endpoints
36
+ - `.Result` / `.Wait()` (sync-over-async) → deadlocks
37
+ - `EnsureCreated()` en producción en vez de migraciones
38
+ - Service locator / `BuildServiceProvider()` en runtime
39
+ - N+1 por falta de `Include`/proyección
40
+ - `Domain` dependiendo de `Infrastructure` / EF Core
41
+
42
+ ## Stack Defaults
43
+
44
+ | Componente | Default |
45
+ |------------|---------|
46
+ | Runtime | .NET 10 LTS (C# 14) |
47
+ | Framework | ASP.NET Core — Minimal APIs |
48
+ | Arquitectura | Vertical Slice (Clean opcional) |
49
+ | ORM | EF Core 10 |
50
+ | DB | PostgreSQL (Npgsql) |
51
+ | Auth | JWT + ASP.NET Identity |
52
+ | Validación | FluentValidation → ProblemDetails |
53
+ | Testing | xUnit + Testcontainers |
54
+ | Deploy | Docker |
55
+
56
+ ## Code Review Bar
57
+
58
+ **Veto:**
59
+ - Dependencias hacia afuera (Domain → Infrastructure/EF Core)
60
+ - Constructor injection ausente / service locator en runtime
61
+ - Sync-over-async (`.Result`/`.Wait()`)
62
+ - `CancellationToken` no propagado en operaciones I/O
63
+ - Endpoints sin validación / sin `ProblemDetails`
64
+ - Auth/authz manual en vez de policies
65
+ - `EnsureCreated()` contra prod / secrets en `appsettings.json`
66
+ - N+1 queries evitables; entidades EF expuestas como respuesta
67
+
68
+ **Comment-only:**
69
+ - Repo genérico innecesario sobre EF Core
70
+ - Handler con múltiples responsabilidades
71
+ - Logging no estructurado
72
+ - Falta de `AsNoTracking()` en lecturas
73
+
74
+ ## Delegation Map
75
+
76
+ **Report to:** `backend-architect`, `database-architect`, `lead-programmer`.
77
+ **Coordina con:** `e2e-tester` (cobertura e2e), `sql-specialist` (optimización de queries).
78
+ **No delegate down.** Tier 3 specialist.
@@ -1,6 +1,6 @@
1
1
  # Skills Catalog — Claude Code Arcane
2
2
 
3
- Catalogo completo de los 305 skills disponibles para proyectos consumidores. Organizados por division.
3
+ Catalogo completo de los 333 skills disponibles para proyectos consumidores. Organizados por division.
4
4
 
5
5
  ## Como ejecutar un skill
6
6
 
@@ -70,7 +70,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
70
70
 
71
71
  ---
72
72
 
73
- ## Gamedev (20 skills)
73
+ ## Gamedev (21 skills)
74
74
 
75
75
  | Skill | Descripcion | Uso |
76
76
  |-------|-------------|-----|
@@ -82,6 +82,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
82
82
  | `/consistency-check` | Detecta inconsistencias cross-documento en stats/items | `[full \| since-last \| entity:<name>]` |
83
83
  | `/doc-gdd` | Genera Game Design Document completo | `[game-name]` |
84
84
  | `/doc-pas` | Documentacion PAS (Problem-Analysis-Solution) | `[problem o decision title]` |
85
+ | `/install-mcp` | Instala y registra el MCP de Unity (CoplayDev) en el proyecto | `[--secondary] [project-path]` |
85
86
  | `/map-systems` | Descompone concepto en sistemas, mapea dependencias | `[next \| system-name] [--review]` |
86
87
  | `/playtest-report` | Genera o analiza reporte de playtest | `[new\|analyze path] [--review]` |
87
88
  | `/scaffold-unity` | Scaffoldea proyecto Unity estilo Project_T | `[project-name]` |
@@ -158,7 +159,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
158
159
 
159
160
  ---
160
161
 
161
- ## Software (45 skills)
162
+ ## Software (48 skills)
162
163
 
163
164
  | Skill | Descripcion | Uso |
164
165
  |-------|-------------|-----|
@@ -181,6 +182,9 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
181
182
  | `/distributed-tracing` | Setup de tracing distribuido | `[go\|ts\|react\|rn] [gcp\|tempo\|datadog]` |
182
183
  | `/doc-rfc` | Genera RFC tecnico estilo Alizia-BE | `[rfc-title o feature]` |
183
184
  | `/docker-setup` | Dockerfiles + docker-compose multi-stage | `[go\|ts\|react\|rn] [--dev\|--prod]` |
185
+ | `/dotnet-architecture` | Arquitectura .NET: Vertical Slice y Clean Architecture | `[vertical-slice\|clean\|when-to-use]` |
186
+ | `/dotnet-best-practices` | ASP.NET Core best practices: 40 reglas priorizadas | `[architecture\|di\|security\|performance\|all]` |
187
+ | `/dotnet-scaffold` | Scaffold ASP.NET Core: .NET 10, EF Core, Postgres, JWT | `[project-name]` |
184
188
  | `/file-uploads` | Implementacion de file uploads | `[go\|ts\|react\|rn]` |
185
189
  | `/form-validation` | Validacion de forms: RHF + Zod | `[react\|rn] [form-name]` |
186
190
  | `/go-clean-architecture` | Clean architecture en Go | `[module o feature]` |
@@ -428,6 +432,44 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
428
432
 
429
433
  ---
430
434
 
435
+ ## Job Hunt (12 skills)
436
+
437
+ | Skill | Descripcion | Uso |
438
+ |-------|-------------|-----|
439
+ | `/job-hunt` | Entry point: crea/gestiona el career workspace (perfiles, CVs, aplicaciones, empresas, contactos, entrevistas) y rutea | `[setup\|status\|next]` |
440
+ | `/master-profile` | Perfil maestro single-source-of-truth del que derivan CVs, LinkedIn y portfolio | `[build\|update\|derive <role>]` |
441
+ | `/cv-tailor` | Adapta el CV a una oferta: keywords ATS, que resaltar/bajar, reescritura de highlights | `[job-url\|jd-path\|application]` |
442
+ | `/cv-ats-export` | Markdown -> PDF ATS-compliant (una columna, texto seleccionable) via Chrome/Edge headless | `[cv-name\|all] [--workspace <path>]` |
443
+ | `/linkedin-optimize` | Optimiza LinkedIn: headline, About, experiencia con KPIs, keywords, value prop, pitch 30s | `[section\|full]` |
444
+ | `/portfolio-site` | Genera/actualiza portfolio web desde el source-of-truth | `[sync\|scaffold] [repo\|--new]` |
445
+ | `/job-search` | Busca, scorea y prioriza ofertas + plan de busqueda de 7 dias | `[search <query>\|score <url>\|plan]` |
446
+ | `/cover-letter` | Cover letters y mensajes de aplicacion concisos y custom | `[application\|company + role]` |
447
+ | `/cold-outreach` | Mensajes en frio a recruiters/hiring managers + follow-ups post-aplicacion | `[contact\|recruiter + company]` |
448
+ | `/interview-prep` | Prep de entrevista: research, banco de preguntas, respuestas STAR, red flags | `[application\|company + role + round]` |
449
+ | `/network-map` | Convierte el export de conexiones de LinkedIn en contactos por empresa + warm intros + mensajes | `[company] \| import <Connections.csv>` |
450
+ | `/personal-brand` | Backlog secuenciado de posts de LinkedIn (4 pilares) para construir autoridad antes del outreach | `[plan\|ideas <N>\|draft <idea>]` |
451
+
452
+ ---
453
+
454
+ ## E-Commerce (12 skills)
455
+
456
+ | Skill | Descripcion | Uso |
457
+ |-------|-------------|-----|
458
+ | `/commerce-data-model` | Modela y audita el dominio de catalogo: product/variant/SKU/option, collections, atributos, taxonomia, faceted search y paginacion | `[model\|audit\|taxonomy]` |
459
+ | `/cart-checkout` | Disena/audita carrito y checkout: estado del cart, multi-step vs one-page, guest checkout, abandoned-cart recovery | `[design\|audit\|abandoned]` |
460
+ | `/inventory-stock` | Inventario y stock: tracking, optimistic locking anti-overselling, reservas, multi-location, restock forecast (script) | `[design\|forecast\|audit]` |
461
+ | `/order-lifecycle` | State machine de ordenes: order/payment/fulfillment, returns/RMA, refunds, eventos/webhooks | `[design\|states\|returns]` |
462
+ | `/payments-architecture` | Arquitectura de pagos PSP-agnostica: payment intents, idempotencia, webhooks fiables, reconciliacion, PCI, fraude | `[design\|webhooks\|audit]` |
463
+ | `/promotions-discounts` | Motor de promociones: cupones, automaticos, BOGO, tiered, reglas de stacking/exclusividad, gift cards | `[design\|rules\|audit]` |
464
+ | `/shipping-tax` | Envios (zonas/rates/metodos) e impuestos (VAT/GST/nexus, duties, landed cost) calculados server-side | `[shipping\|tax\|audit]` |
465
+ | `/product-listing` | Optimiza PDP y listings de marketplace (Amazon A10/COSMO/Rufus), titulos, bullets, A+, copy en bulk | `[pdp\|marketplace\|bulk]` |
466
+ | `/commerce-analytics` | KPIs de commerce (CR, AOV, CLV, cohort) + spec de eventos GA4 ecommerce + validador de dataLayer (script) | `[kpis\|events\|audit]` |
467
+ | `/merchant-feed` | Feeds de producto Google Merchant / Meta Catalog: atributos requeridos, mapping y validacion (script) | `[validate\|generate\|map]` |
468
+ | `/storefront-architecture` | IA del storefront (home/PLP/PDP/cart/checkout/search/megamenu) + decision headless-vs-monolito + performance | `[design\|pages\|headless]` |
469
+ | `/subscription-billing` | Billing recurrente: modelos, ciclos, proration, trials, plan changes y dunning anti-churn involuntario | `[design\|dunning\|audit]` |
470
+
471
+ ---
472
+
431
473
  ## Skills internos de Arcane
432
474
 
433
475
  Estos skills son para mantener y desarrollar el propio repo Arcane:
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## What is Arcane?
4
4
 
5
- Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **321 skills**, **86 agents**, **15 hooks**, and **19 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
5
+ Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **333 skills**, **87 agents**, **15 hooks**, and **19 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
6
6
 
7
7
  ## Table of Contents
8
8
 
@@ -536,7 +536,7 @@ Yes, and it's recommended. This way everyone on the team gets the same Claude Co
536
536
 
537
537
  ### How many tokens does a profile consume?
538
538
 
539
- Each skill adds ~30-100 tokens to the system prompt. A typical base profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 321 skills, which is why selective deploy matters.
539
+ Each skill adds ~30-100 tokens to the system prompt. A typical base profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 333 skills, which is why selective deploy matters.
540
540
 
541
541
  ### Why replace instead of merge on install?
542
542
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-code-arcane",
3
- "version": "1.2.0",
3
+ "version": "1.4.0",
4
4
  "description": "Skills, agents, hooks and rules for Claude Code — installable via npx arcane",
5
5
  "type": "module",
6
6
  "bin": {
@@ -0,0 +1,54 @@
1
+ name: backend-dotnet
2
+ description: "Backend .NET — ASP.NET Core (.NET 10), Vertical Slice / Clean Architecture, EF Core + PostgreSQL, JWT + Identity, testing. Best practices priorizadas por impacto."
3
+ type: base
4
+
5
+ skills:
6
+ # .NET-specific (nuevas)
7
+ - dotnet-scaffold
8
+ - dotnet-best-practices
9
+ - dotnet-architecture
10
+ # API & data
11
+ - database
12
+ - database-indexing
13
+ - data-migrations
14
+ - api-design
15
+ - api-docs
16
+ - api-versioning
17
+ - caching-strategy
18
+ - webhooks
19
+ - rate-limiting
20
+ # Auth & security
21
+ - auth-strategy
22
+ - jwt-strategy
23
+ - oauth-setup
24
+ - rbac-abac
25
+ - audit-log
26
+ # Ops & quality
27
+ - testing
28
+ - contract-testing
29
+ - deps-audit
30
+ - env-sync
31
+ - observability
32
+ - performance
33
+ - async-ops
34
+ - ci-cd-setup
35
+
36
+ rules:
37
+ universal:
38
+ - backend-code
39
+ - api-code
40
+ - dotnet-code
41
+ - migration-code
42
+ gamedev:
43
+ []
44
+
45
+ agents:
46
+ - engineering
47
+
48
+ permissions:
49
+ allow:
50
+ - "Bash(dotnet *)"
51
+ - "Bash(docker ps*)"
52
+ - "Bash(docker images*)"
53
+ deny:
54
+ []
@@ -0,0 +1,48 @@
1
+ name: ecommerce
2
+ description: "E-Commerce — dominio commerce end-to-end agnostico de lenguaje: data model, carrito/checkout, inventario, ordenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront y suscripciones"
3
+ type: addon
4
+
5
+ skills:
6
+ # net-new (12)
7
+ - commerce-data-model
8
+ - cart-checkout
9
+ - inventory-stock
10
+ - order-lifecycle
11
+ - payments-architecture
12
+ - promotions-discounts
13
+ - shipping-tax
14
+ - product-listing
15
+ - commerce-analytics
16
+ - merchant-feed
17
+ - storefront-architecture
18
+ - subscription-billing
19
+ # reutilizadas (existentes, relevantes a e-commerce)
20
+ - stripe-integration-expert
21
+ - page-cro
22
+ - form-cro
23
+ - schema-markup
24
+ - seo-audit
25
+ - analytics-tracking
26
+ - pricing-strategy
27
+ - ab-test-setup
28
+ - referral-program
29
+
30
+ rules:
31
+ universal:
32
+ []
33
+ gamedev:
34
+ []
35
+
36
+ agents:
37
+ - ecommerce
38
+
39
+ permissions:
40
+ allow:
41
+ - "Bash(python *restock_forecast.py*)"
42
+ - "Bash(python3 *restock_forecast.py*)"
43
+ - "Bash(python *ga4_ecommerce_validate.py*)"
44
+ - "Bash(python3 *ga4_ecommerce_validate.py*)"
45
+ - "Bash(python *feed_validate.py*)"
46
+ - "Bash(python3 *feed_validate.py*)"
47
+ deny:
48
+ []
@@ -0,0 +1,35 @@
1
+ name: job-hunt
2
+ description: "Job Hunt — busqueda laboral end-to-end: perfil maestro, CV ATS, LinkedIn, portfolio, cover letters, outreach a recruiters, scoring de ofertas y prep de entrevistas"
3
+ type: addon
4
+
5
+ skills:
6
+ - job-hunt
7
+ - master-profile
8
+ - cv-tailor
9
+ - cv-ats-export
10
+ - linkedin-optimize
11
+ - portfolio-site
12
+ - job-search
13
+ - cover-letter
14
+ - cold-outreach
15
+ - interview-prep
16
+ - network-map
17
+ - personal-brand
18
+
19
+ rules:
20
+ universal:
21
+ []
22
+ gamedev:
23
+ []
24
+
25
+ agents:
26
+ []
27
+
28
+ permissions:
29
+ allow:
30
+ - "Bash(python *cv_export.py*)"
31
+ - "Bash(python3 *cv_export.py*)"
32
+ - "Bash(python *network_map.py*)"
33
+ - "Bash(python3 *network_map.py*)"
34
+ deny:
35
+ []
@@ -10,6 +10,7 @@ skills:
10
10
  - map-systems
11
11
  - asset-spec
12
12
  - game-audit
13
+ - install-mcp
13
14
  - quick-design
14
15
  - ux-design
15
16
  - design-system
@@ -12,6 +12,7 @@ skills:
12
12
  - release-checklist
13
13
  - patch-notes
14
14
  - onboard
15
+ - install-mcp
15
16
  - scaffold-unity
16
17
  - unity-game-architecture
17
18
  - map-systems
@@ -0,0 +1,64 @@
1
+ ---
2
+ paths:
3
+ - "**/*.cs"
4
+ - "**/*.csproj"
5
+ - "**/Program.cs"
6
+ - "**/*.Tests.cs"
7
+ - "src/**"
8
+ - "tests/**"
9
+ ---
10
+
11
+ # .NET / C# Code Rules
12
+
13
+ Reglas production-ready para ASP.NET Core (.NET 10), ordenadas por impacto. Catálogo completo (40 reglas, 10 categorías) + ejemplos incorrecto/correcto: skill `dotnet-best-practices`. Estructura de proyecto: skill `dotnet-architecture`.
14
+
15
+ ## CRITICAL — Arquitectura & DI
16
+
17
+ - **Organizar por feature (Vertical Slice)** o por capas con dependencias hacia adentro (Clean) — nunca un `Services/` + `Controllers/` global gigante.
18
+ - **Endpoints/controllers finos** — traducen HTTP ↔ request, llaman al handler y dan shape a la respuesta. Cero lógica de negocio.
19
+ - **`DbContext` es Unit of Work + Repository** — no envolverlo en `IRepository<T>` / `IUnitOfWork` genérico (indirección sin valor que tapa `Include`/proyecciones).
20
+ - **Constructor injection (primary constructors) siempre.** Nunca service locator ni `BuildServiceProvider()` manual en `Program.cs`.
21
+ - **Lifetimes correctos** — `Scoped` para `DbContext`/handlers, `Singleton` solo si es stateless; nunca inyectar `Scoped` en `Singleton` (captured dependency).
22
+ - **`<Nullable>enable</Nullable>`** + warnings as errors; cero `#nullable disable` para silenciar.
23
+
24
+ ## HIGH — Async, Error handling & Security
25
+
26
+ - **Async end-to-end.** Nunca `.Result`/`.Wait()`/`.GetAwaiter().GetResult()` (deadlocks / thread-pool starvation). Sin `async void` salvo event handlers.
27
+ - **Propagar `CancellationToken`** desde el endpoint hasta EF Core y llamadas HTTP. Sin fire-and-forget sin manejo de error.
28
+ - **Errores vía `ProblemDetails` (RFC 7807)** — `AddProblemDetails()` + `IExceptionHandler` global. Nunca filtrar stack traces. Validación → `ValidationProblemDetails`.
29
+ - **Result pattern para fallos esperados**, excepciones solo para lo excepcional. Sin `catch` vacíos.
30
+ - **JWT de vida corta + refresh**, secretos en user-secrets/Key Vault (no en `appsettings.json`). Authorization por **policies declarativas**, no checks manuales de roles.
31
+ - **Rate limiting** con el middleware built-in (`AddRateLimiter`). HTTPS/HSTS. No loguear data sensible.
32
+
33
+ ## HIGH — Performance & Data (EF Core)
34
+
35
+ - **Evitar N+1** — `Include` o proyección a DTO con `Select`. Nunca acceder a relaciones en un loop.
36
+ - **`AsNoTracking()`** en lecturas read-only. `AsSplitQuery()` para `Include` grandes (evita explosión cartesiana).
37
+ - **Migraciones versionadas** (`dotnet ef migrations add` / `MigrateAsync()`); nunca `EnsureCreated()` en prod.
38
+ - **Transacciones para operaciones multi-step**; `EnableRetryOnFailure` para resiliencia de conexión (Npgsql).
39
+ - **Caching estratégico** (`HybridCache`/output caching) con TTL e invalidación apropiada.
40
+
41
+ ## MEDIUM — API, Testing & DevOps
42
+
43
+ - **DTOs en el borde** (records) — nunca exponer entidades EF como respuestas HTTP.
44
+ - **API versioning** (`Asp.Versioning`) para cambios breaking; OpenAPI con `Microsoft.AspNetCore.OpenApi`.
45
+ - **`TypedResults`** en minimal APIs para status codes correctos y testeables.
46
+ - **Tests con xUnit**; integración con `WebApplicationFactory` + Postgres real (Testcontainers). No mockear `DbContext` ni usar el in-memory provider (miente sobre comportamiento relacional).
47
+ - **Structured logging (Serilog JSON)** + health checks (liveness/readiness). Graceful shutdown vía `IHostApplicationLifetime`.
48
+ - **Config por entorno** (`IOptions<T>`, `appsettings.{Environment}.json`) — nada hardcodeado.
49
+
50
+ ## Anti-Patterns
51
+
52
+ - `IRepository<T>` / `IUnitOfWork` genérico sobre EF Core
53
+ - Lógica de negocio en controllers/endpoints
54
+ - `.Result` / `.Wait()` (sync-over-async) → deadlocks
55
+ - `EnsureCreated()` contra una DB de producción
56
+ - Service locator / `BuildServiceProvider()` en runtime
57
+ - Devolver entidades EF crudas como respuesta HTTP
58
+ - N+1 queries por falta de `Include`/proyección
59
+ - `Domain` referenciando `Infrastructure` / EF Core (dependencia hacia afuera)
60
+ - Forzar Clean Architecture en un CRUD simple (sobre-ingeniería)
61
+
62
+ ---
63
+
64
+ _Derivado de [github/awesome-copilot](https://github.com/github/awesome-copilot) (dotnet-best-practices), [dotnet/skills](https://github.com/dotnet/skills) y [ardalis/CleanArchitecture](https://github.com/ardalis/CleanArchitecture). Condensado al formato Arcane._
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: cart-checkout
3
+ description: "Design and audit cart and checkout flows — cart state, multi-step vs one-page checkout, guest checkout, address/shipping/tax/payment steps, and abandoned-cart recovery. Platform-agnostic conversion and correctness patterns. Triggers: designing a checkout, auditing drop-off, planning abandoned-cart flows."
4
+ argument-hint: "[design | audit | abandoned]"
5
+ category: "ecommerce"
6
+ user-invocable: true
7
+ allowed-tools: Read, Glob, Grep
8
+ ---
9
+
10
+ # Cart & Checkout
11
+
12
+ The highest-leverage surface in commerce: where intent becomes revenue. Design carts and checkouts that are correct under concurrency and optimized for completion — without prescribing a framework.
13
+
14
+ ## Before Starting
15
+
16
+ Gather: cart model (server-persisted vs client, guest vs account), checkout type (single vs multi-step), payment/shipping/tax requirements, and goal (design new flow, audit drop-off, or build abandoned-cart recovery).
17
+
18
+ ## How This Skill Works
19
+
20
+ | Mode | Trigger | Output |
21
+ |------|---------|--------|
22
+ | **Design** | `design` | Cart state model + checkout step flow + edge cases |
23
+ | **Audit** | `audit` | Friction/drop-off analysis with prioritized fixes |
24
+ | **Abandoned** | `abandoned` | Recovery sequence (triggers, timing, channels) |
25
+
26
+ ---
27
+
28
+ ## Phase 1 — Cart State
29
+
30
+ | Decision | Recommendation |
31
+ |----------|----------------|
32
+ | Persistence | Server-side cart keyed by session + user; merge on login |
33
+ | Pricing | **Re-price at checkout** — never trust cart-stored prices |
34
+ | Inventory | Soft-reserve at checkout start, not on add-to-cart |
35
+ | Identity | Allow guest carts; merge guest → account without losing items |
36
+
37
+ **Rule:** The cart is a draft, not a contract. Totals, stock, and promotions are recomputed server-side before payment.
38
+
39
+ ---
40
+
41
+ ## Phase 2 — Checkout Flow
42
+
43
+ Canonical steps: **Cart → Identity → Shipping address → Shipping method → Payment → Review → Confirmation.**
44
+
45
+ - **Guest checkout** is non-negotiable for B2C — forced account creation is the #1 avoidable drop-off.
46
+ - Collect email first (enables abandoned-cart + receipts).
47
+ - One-page vs multi-step: multi-step for complex shipping/tax; one-page for low-SKU/digital. Either way, show progress and never lose entered data on validation error.
48
+ - Recompute tax/shipping when the address changes; show the final total before the pay button.
49
+ - Make payment **idempotent** — a double-click must not double-charge (hand off to `payments-architecture`).
50
+
51
+ For the full step-by-step field list, error handling, and address validation patterns, see [references/checkout-flow-spec.md](references/checkout-flow-spec.md).
52
+
53
+ ---
54
+
55
+ ## Phase 3 — Abandoned-Cart Recovery
56
+
57
+ | Touch | Timing | Angle |
58
+ |-------|--------|-------|
59
+ | 1 | ~1h | Reminder ("you left these") |
60
+ | 2 | ~24h | Help/objection handling + reviews |
61
+ | 3 | ~72h | Incentive (discount) — only if margin allows |
62
+
63
+ Capture email as early as possible; suppress recovery once the order completes; respect consent and frequency caps.
64
+
65
+ ---
66
+
67
+ ## Output Artifacts
68
+
69
+ | Request | Output |
70
+ |---------|--------|
71
+ | Design flow | Cart model + annotated step diagram + edge-case list |
72
+ | Audit | Drop-off table with severity and READY-to-ship fixes |
73
+ | Abandoned | Trigger/timing/channel sequence + suppression rules |
74
+
75
+ A checkout is **READY** when guest checkout works, prices/stock are re-validated server-side, payment is idempotent, and data survives validation errors.
76
+
77
+ ---
78
+
79
+ ## Related Skills
80
+
81
+ - **payments-architecture**: owns the payment step (intents, idempotency, webhooks).
82
+ - **shipping-tax**: computes the shipping and tax shown at checkout.
83
+ - **promotions-discounts**: applies coupons/discounts at the cart.
84
+ - **page-cro** / **form-cro**: deeper conversion optimization of the checkout UI.
85
+ - **order-lifecycle**: takes over once the order is placed.