claude-code-arcane 2.4.0 → 2.5.0

package/docs/USER-GUIDE.md

@@ -11,8 +11,7 @@ Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/e
 - [Quick Start](#quick-start)
 - [Commands Reference](#commands-reference)
 - [Profiles](#profiles)
-  - [Base Profiles](#base-profiles)
-  - [Add-on Profiles](#add-on-profiles)
+  - [Profile Catalog](#profile-catalog)
   - [Core (always included)](#core-always-included)
 - [Profile Composition](#profile-composition)
 - [Adding and Removing Skills](#adding-and-removing-skills)
@@ -65,7 +64,8 @@ Your project now has skills, agents, hooks, rules, and permissions tailored for
 ### `npx claude-code-arcane install` — Install profiles
 
 ```bash
-# Show available profiles (interactive)
+# Interactive picker: detects your stack, pre-selects matching profiles,
+# and lets you add more from a menu grouped by category
 npx claude-code-arcane install
 
 # Install a specific profile
@@ -95,7 +95,7 @@ npx claude-code-arcane add api-design
 # Add multiple skills
 npx claude-code-arcane add security-audit owasp
 
-# Add an entire profile as addon
+# Add an entire profile
 npx claude-code-arcane add +security
 
 # Add multiple profiles
@@ -131,7 +131,7 @@ What gets deleted is read from that profile's definition, so `remove` uses the c
 npx claude-code-arcane list
 ```
 
-Shows all base profiles and add-ons with descriptions, and marks which are currently installed.
+Shows all profiles grouped by category, with descriptions, and marks which are currently installed.
 
 ### `npx claude-code-arcane status` — Check current installation
 
@@ -197,46 +197,21 @@ npx claude-code-arcane global --remove
 
 ## Profiles
 
-### Base Profiles
-
-Base profiles define the primary stack for a project. Pick one or combine multiple.
-
-| Profile | Stack | Skills | Agents |
-|---------|-------|--------|--------|
-| `unity-dev` | Unity programmer — C#, architecture, performance, builds | 25 | game |
-| `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 17 | game |
-| `backend-ts` | Backend TypeScript — Fastify, Prisma, Zod, API design | 33 | engineering |
-| `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 19 | engineering |
-| `frontend` | React + Vite + TypeScript | 14 | engineering |
-| `mobile` | React Native + Expo + TypeScript | 12 | engineering |
-| `flutter` | Flutter + Dart cross-platform | 8 | engineering |
-| `android-native` | Kotlin + Jetpack Compose + Material Design 3 | 8 | engineering |
-| `ios-native` | Swift + UIKit/SwiftUI + Apple HIG | 8 | engineering |
-
-### Add-on Profiles
-
-Add-ons extend a base profile with extra capabilities. Combine them with `+`.
-
-| Add-on | Adds | Skills | Agents |
-|--------|------|--------|--------|
-| `+agile` | Sprints, standups, retros, estimates | 10 | management, product |
-| `+docs` | PDF, PPTX, XLSX, DOCX, architecture decisions | 8 | — |
-| `+testing` | Contract, performance, regression, flakiness | 11 | quality |
-| `+infra` | Terraform, observability, secrets, rollback, K8s | 17 | devops |
-| `+database` | Indexing, migrations, seeding, replicas, optimization | 8 | — |
-| `+security` | Audits, OWASP, secrets, backups | 5 | — |
-| `+design` | Figma, UX review, design system, handoff | 6 | product |
-| `+integrations` | GitHub Projects, Slack, Postman | 3 | integrations |
-| `+clickup` | ClickUp via MCP — tasks, docs, time tracking | 3 | — |
-| `+jira` | Jira via REST API — issues, sprints, boards | 3 | — |
-| `+ai` | LLM cost optimization, RAG, ML, data engineering | 7 | ai |
-| `+business` | Contracts, customer success, revenue ops, sales | 4 | business |
-| `+clevel` | C-suite advisors, board prep, strategic ops | 28 | clevel |
-| `+finance` | Investment analysis, financial modeling, SaaS metrics | 3 | business |
-| `+marketing` | Content, growth, SEO/CRO, strategy, analytics | 44 | marketing |
-| `+regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
-| `+self-improving` | Agent self-improvement and skill extraction | 2 | — |
-| `+statusline` | Claude Code status bar (branch, division, session info) | 0 | — |
+### Profile Catalog
+
+All profiles are equal — pick any combination that fits your work. They are grouped by category for discovery (same grouping the interactive picker and `list` use). The full per-profile detail lives in the [README](../README.md#available-profiles); summary by category:
+
+| Category | Profiles |
+|----------|----------|
+| **Backend** | `backend-ts`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
+| **Frontend & Design** | `frontend`, `design` |
+| **Mobile** | `mobile`, `flutter`, `android-native`, `ios-native` |
+| **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio` |
+| **Platform & Quality** | `infra`, `database`, `security`, `testing`, `ai` |
+| **Project Management** | `agile`, `jira`, `clickup`, `integrations` |
+| **Business** | `business`, `clevel`, `finance`, `marketing`, `ecommerce`, `regulatory` |
+| **Personal** | `second-brain`, `job-hunt`, `freelance` |
+| **Utilities** | `docs`, `self-improving`, `statusline` |
 
 ### Core (always included)
 
@@ -257,17 +232,16 @@ Every installation automatically loads `core.yaml` first:
 Profiles are combined using the `+` separator. The system deduplicates skills automatically.
 
 ```bash
-npx claude-code-arcane install <base>[+<base>][+<addon>][+<addon>]
+npx claude-code-arcane install <profile>[+<profile>][+<profile>...]
 ```
 
 ### Rules
 
 1. **Always explicit** — there is no "full" or "all" profile. You choose what you need.
 2. **Core is automatic** — the 21 universal skills and all hooks are always included.
-3. **Multiple bases are OK** — combine `unity-dev+unity-design` or `backend-go+frontend`.
-4. **Add-ons extend** — `+agile`, `+clickup`, etc. add capabilities to any base.
-5. **Deduplication is automatic** — overlapping skills across profiles are installed once.
-6. **Replace, not merge** — installing a new profile replaces the previous one entirely (with backup).
+3. **All profiles combine freely** — `unity-dev+unity-design`, `backend-go+frontend`, or `backend-ts+agile+testing`; there is no required "base".
+4. **Deduplication is automatic** — overlapping skills across profiles are installed once.
+5. **Replace, not merge** — installing a new profile replaces the previous one entirely (with backup).
 
 ---
 
@@ -278,7 +252,7 @@ After the initial install, you can incrementally add or remove skills and profil
 ### Add workflow
 
 ```bash
-# Start with a base profile
+# Start with a profile
 npx claude-code-arcane install backend-ts
 
 # Later, add testing and security
@@ -506,7 +480,7 @@ mv ~/projects/my-game/.claude.bak ~/projects/my-game/.claude
 
 ## FAQ
 
-### Can I use multiple base profiles together?
+### Can I combine multiple stack profiles?
 
 Yes. `backend-go+frontend` gives you both Go backend and React frontend skills. Duplicate skills are automatically deduplicated.
 
@@ -541,7 +515,7 @@ Yes, and it's recommended. This way everyone on the team gets the same Claude Co
 
 ### How many tokens does a profile consume?
 
-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 427 skills, which is why selective deploy matters.
+Each skill adds ~30-100 tokens to the system prompt. A typical stack profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 427 skills, which is why selective deploy matters.
 
 ### Why replace instead of merge on install?
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx claude-code-arcane",
   "type": "module",
   "bin": {
@@ -42,6 +42,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "^1.7.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "js-yaml": "^4.1.0",

package/profiles/agile.yaml

@@ -1,6 +1,6 @@
 name: agile
 description: "Gestión de proyecto — sprints, standups, retros, estimates"
-type: addon
+category: management
 
 skills:
   - gh-projects

package/profiles/ai.yaml

@@ -1,6 +1,6 @@
 name: ai
 description: "AI & ML — LLM optimization, RAG, computer vision, data engineering, prompt engineering"
-type: addon
+category: platform
 
 skills:
   - llm-cost-optimizer

package/profiles/android-native.yaml

@@ -1,6 +1,6 @@
 name: android-native
 description: "Android native — Kotlin + Jetpack Compose + Material Design 3"
-type: base
+category: mobile
 
 skills:
   - testing

package/profiles/audio.yaml

@@ -1,6 +1,6 @@
 name: audio
 description: "Game Audio — direccion sonora, composicion, sound design, middleware, VO y QA"
-type: base
+category: gamedev
 
 skills:
   - audio-bible

package/profiles/backend-dotnet.yaml

@@ -1,6 +1,6 @@
 name: backend-dotnet
 description: "Backend .NET — ASP.NET Core (.NET 10), Vertical Slice / Clean Architecture, EF Core + PostgreSQL, JWT + Identity, testing. Best practices priorizadas por impacto."
-type: base
+category: backend
 
 skills:
   # .NET-specific (nuevas)

package/profiles/backend-go.yaml

@@ -1,6 +1,6 @@
 name: backend-go
 description: "Backend Go — scaffold, DB, auth, API design, CI"
-type: base
+category: backend
 
 skills:
   - test-setup

package/profiles/backend-nestjs.yaml

@@ -1,6 +1,6 @@
 name: backend-nestjs
 description: "Backend NestJS — feature modules, DI, guards/pipes, Prisma, JWT, testing, microservicios. Best practices priorizadas por impacto."
-type: base
+category: backend
 
 skills:
   # NestJS-specific (nuevas)

package/profiles/backend-nextjs.yaml

@@ -1,6 +1,6 @@
 name: backend-nextjs
 description: "Next.js full-stack — App Router, RSC, Server Actions, SEO, AI SDK, performance (64 reglas de Vercel). Front + back en un solo runtime."
-type: base
+category: backend
 
 skills:
   # Next.js-specific (nuevas)

package/profiles/backend-ts.yaml

@@ -1,6 +1,6 @@
 name: backend-ts
 description: "Backend TypeScript — Fastify, Prisma, Zod, API design, CI"
-type: base
+category: backend
 
 skills:
   - testing

package/profiles/business.yaml

@@ -1,6 +1,6 @@
 name: business
 description: "Business — contracts, customer success, revenue ops, sales engineering"
-type: addon
+category: business
 
 skills:
   - contract-and-proposal-writer

package/profiles/clevel.yaml

@@ -1,6 +1,6 @@
 name: clevel
 description: "C-Level — executive advisors, board prep, strategic operations, org health"
-type: addon
+category: business
 
 skills:
   - ceo-advisor

package/profiles/clickup.yaml

@@ -1,6 +1,6 @@
 name: clickup
 description: "ClickUp via MCP — tasks, docs, time tracking"
-type: addon
+category: management
 
 skills:
   - clickup

package/profiles/core.yaml

@@ -1,6 +1,6 @@
 name: core
 description: "Skills universales, hooks y rules base"
-type: base
+category: core
 
 skills:
   - commit

package/profiles/database.yaml

@@ -1,6 +1,6 @@
 name: database
 description: "Database avanzado — indexing, migrations, seeding, replicas"
-type: addon
+category: platform
 
 skills:
   - database-indexing

package/profiles/design.yaml

@@ -1,6 +1,6 @@
 name: design
 description: "Figma workflow, UX review, handoff a dev"
-type: addon
+category: frontend
 
 skills:
   - user-persona

package/profiles/docs.yaml

@@ -1,6 +1,6 @@
 name: docs
 description: "Document generation — PDF, PPTX, XLSX, DOCX, architecture"
-type: addon
+category: utilities
 
 skills:
   - pdf-generator

package/profiles/ecommerce.yaml

@@ -1,6 +1,6 @@
 name: ecommerce
 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"
-type: addon
+category: business
 
 skills:
   # net-new (12)

package/profiles/finance.yaml

@@ -1,6 +1,6 @@
 name: finance
 description: "Finance — investment analysis, financial modeling, SaaS metrics"
-type: addon
+category: business
 
 skills:
   - business-investment-advisor

package/profiles/flutter.yaml

@@ -1,6 +1,6 @@
 name: flutter
 description: "Flutter + Dart cross-platform development"
-type: base
+category: mobile
 
 skills:
   - testing

package/profiles/freelance.yaml

@@ -1,6 +1,6 @@
 name: freelance
 description: "Freelance — conseguir proyectos como freelancer y ejecutarlos: scan de fuentes publicas sin API key con dedup y scoring, busqueda en los marketplaces (Upwork, Workana) via WebSearch, inteligencia de tarifas de mercado, screening de riesgo del cliente, perfil de plataforma, propuestas con cotizacion sobre piso de tarifa neto, contratos y SOWs, kickoff con validacion de horas contra lo cotizado, registro de horas y change orders, pipeline con costo de adquisicion y utilizacion, y 4 agentes de contexto fresco (review de propuesta, screener adversarial, discovery call, estratega de pipeline)"
-type: addon
+category: personal
 
 skills:
   # Nucleo del perfil

package/profiles/frontend.yaml

@@ -1,6 +1,6 @@
 name: frontend
 description: "Frontend React + Vite + TypeScript"
-type: base
+category: frontend
 
 skills:
   - testing

package/profiles/infra.yaml

@@ -1,6 +1,6 @@
 name: infra
 description: "DevOps/Platform/Ops — deploy, observability, secrets, rollback"
-type: addon
+category: platform
 
 skills:
   - observability

package/profiles/integrations.yaml

@@ -1,6 +1,6 @@
 name: integrations
 description: "Integraciones externas — GitHub Projects, Slack, Postman"
-type: addon
+category: management
 
 skills:
   - gh-projects

package/profiles/ios-native.yaml

@@ -1,6 +1,6 @@
 name: ios-native
 description: "iOS native — Swift + UIKit/SwiftUI + Apple HIG"
-type: base
+category: mobile
 
 skills:
   - testing

package/profiles/jira.yaml

@@ -1,6 +1,6 @@
 name: jira
 description: "Jira via curl/REST API — issues, sprints, boards"
-type: addon
+category: management
 
 skills:
   - jira-tickets

package/profiles/job-hunt.yaml

@@ -1,6 +1,6 @@
 name: job-hunt
 description: "Job Hunt — busqueda laboral end-to-end: perfil maestro, CV ATS con verificacion, scraping de ofertas con dedup, pipeline de postulacion, LinkedIn, portfolio, cover letters, outreach a recruiters, scoring de ofertas, gaps/upskill, prep de entrevistas y 4 agentes de contexto fresco (review de CV, hiring manager, mock interview, diagnostico del embudo)"
-type: addon
+category: personal
 
 skills:
   - job-hunt

package/profiles/marketing.yaml

@@ -1,6 +1,6 @@
 name: marketing
 description: "Marketing — content, growth, SEO/CRO, strategy, analytics, social media"
-type: addon
+category: business
 
 skills:
   - content-creator

package/profiles/mobile.yaml

@@ -1,6 +1,6 @@
 name: mobile
 description: "Mobile React Native + Expo + TypeScript"
-type: base
+category: mobile
 
 skills:
   - testing

package/profiles/regulatory.yaml

@@ -1,6 +1,6 @@
 name: regulatory
 description: "Regulatory & Compliance — ISO 13485, GDPR, FDA, SOC2, ISMS, QMS, MDR"
-type: addon
+category: business
 
 skills:
   - capa-officer

package/profiles/second-brain.yaml

@@ -1,6 +1,6 @@
 name: second-brain
 description: "Second Brain — vault de Obsidian gestionado con Claude Code: captura sin friccion, reviews diario/semanal/mensual, notas atomicas y hub files (PARA + Zettelkasten), busqueda con ranking, captura web, auditoria de salud del vault y sintaxis nativa de Obsidian (markdown, Bases, Canvas)"
-type: addon
+category: personal
 
 skills:
   - second-brain

package/profiles/security.yaml

@@ -1,6 +1,6 @@
 name: security
 description: "Security — audits, OWASP, secrets, backups"
-type: addon
+category: platform
 
 skills:
   - security-audit

package/profiles/self-improving.yaml

@@ -1,6 +1,6 @@
 name: self-improving
 description: "Self-improving — auto-memory curation, skill auditing and optimization"
-type: addon
+category: utilities
 
 skills:
   - self-improving-agent

package/profiles/statusline.yaml

@@ -1,6 +1,6 @@
 name: statusline
 description: "Status bar showing branch, division, and session info in Claude Code"
-type: addon
+category: utilities
 
 skills:
   []

package/profiles/testing.yaml

@@ -1,6 +1,6 @@
 name: testing
 description: "Testing avanzado — contract, performance, regression, flakiness"
-type: addon
+category: platform
 
 skills:
   - contract-testing

package/profiles/unity-design.yaml

@@ -1,6 +1,6 @@
 name: unity-design
 description: "Game Designer — GDDs, balance, art bible, playtesting, UX de juego"
-type: base
+category: gamedev
 
 skills:
   - user-persona

package/profiles/unity-dev.yaml

@@ -1,6 +1,6 @@
 name: unity-dev
 description: "Programador Unity — C#, arquitectura, performance, builds"
-type: base
+category: gamedev
 
 skills:
   - test-setup

package/profiles/unreal-dev.yaml

@@ -1,6 +1,6 @@
 name: unreal-dev
 description: "Programador Unreal Engine 5 — C++, Blueprints, GAS, replication, rendering, naming conventions, build y editor MCP"
-type: base
+category: gamedev
 
 skills:
   # Foundation — read this first, every other ue-* skill depends on it

package/profiles/visual-novel.yaml

@@ -1,6 +1,6 @@
 name: visual-novel
 description: "Visual Novel Developer — Ren"
-type: base
+category: gamedev
 
 skills:
   - vn-renpy-setup

package/skills/arcane-list/SKILL.md

@@ -15,24 +15,23 @@ List all profiles and skills available in the Arcane source repo, so you can see
 1. Read `.claude/arcane-manifest.json` to find the `source` path (Arcane repo location)
 2. If no manifest, ask the user for the Arcane repo path
 3. From the source repo, list:
-   - **Base profiles** from `profiles/*.yaml` where type = base
-   - **Addon profiles** from `profiles/*.yaml` where type = addon
+   - **Profiles** from `profiles/*.yaml`, grouped by their `category` field (backend, frontend, mobile, gamedev, platform, management, business, personal, utilities)
    - **All skills** in `skills/` directory, grouped by category from SKILL.md frontmatter
 4. Mark skills that are already installed in the current project with `[installed]`
+5. Close with a one-line summary (`COMPLETE — N profiles, M skills, K installed`)
 
 ## Output format
 
 ```
 === Available Profiles ===
-Base:
+Backend:
   backend-ts     Backend TypeScript — Fastify, Prisma, Zod
   backend-go     Backend Go — scaffold, DB, auth, API design
-  frontend       Frontend React + Vite + TypeScript
   ...
 
-Addons:
-  +agile         Gestión de proyecto — sprints, standups
-  +testing       Testing avanzado — contract, performance
+Project Management:
+  agile          Gestión de proyecto — sprints, standups
+  jira           Jira via curl/REST API — issues, sprints, boards
   ...
 
 === Skills by Category ===
@@ -43,4 +42,10 @@ workflow (12):
 testing (4):
   skill-test [installed], check [installed], ...
 ...
+
+COMPLETE — 37 profiles, 427 skills, 52 installed
 ```
+
+## Next steps
+
+If the user wants something from the list, suggest `/arcane-add <skill>` or `/arcane-add +<profile>` to install it.