claude-agent-personas 1.0.0

package/README.md

@@ -0,0 +1,302 @@
+# claude-agent-personas
+
+> Claude Code that automatically thinks like the expert you need — no commands, no switching, no token waste.
+
+[![npm version](https://img.shields.io/npm/v/claude-agent-personas.svg)](https://www.npmjs.com/package/claude-agent-personas)
+[![npm downloads](https://img.shields.io/npm/dw/claude-agent-personas.svg)](https://www.npmjs.com/package/claude-agent-personas)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## The Problem
+
+Most Claude Code power users put expert personas in their `CLAUDE.md`. Smart idea — except Claude Code **re-injects your entire CLAUDE.md on every single message turn**. Define 20 personas and you're burning ~5,000 tokens before you type a word.
+
+| Setup | Tokens/turn | Monthly cost (est.) |
+|-------|-------------|---------------------|
+| Default Claude Code | ~200 | ~$2 |
+| 20 personas in CLAUDE.md (naive) | ~5,000 | ~$60–120 |
+| **claude-agent-personas (lazy)** | ~350 | ~$4 |
+
+Existing tools also make you manually type `@security-auditor` or `/use-persona lawyer` before every message. People forget. It breaks flow.
+
+**claude-agent-personas** fixes both — lazy-loading + automatic detection. Zero commands to remember.
+
+---
+
+## How It Works
+
+Instead of loading all personas upfront, claude-agent-personas:
+
+1. Puts a tiny **routing engine** (~50 lines) in your `CLAUDE.md`
+2. Stores **72 expert personas** as individual files in `~/.claude/personas/`
+3. On every message, the router **detects domain signals** and loads only the matching file
+
+You type naturally. It routes silently.
+
+```
+"why is my postgres query slow?"           →  loads principal-postgresql-dba.md
+"review this NDA clause"                   →  loads contract-lawyer.md
+"optimize my React component renders"      →  loads principal-react-developer.md
+"design a Kubernetes deployment strategy"  →  loads principal-kubernetes-engineer.md
+```
+
+---
+
+## Install
+
+```bash
+npx claude-agent-personas init
+```
+
+That's it. Takes under 5 seconds. Your existing `CLAUDE.md` is never overwritten — the router block is appended to the end.
+
+---
+
+## Quick Start
+
+```bash
+# Install
+npx claude-agent-personas init
+
+# Open Claude Code in any project
+claude
+
+# Just type naturally — routing is automatic
+"why is my postgres query slow?"           # → PostgreSQL DBA
+"review this indemnification clause"       # → Contract Lawyer
+"design a system for 10k concurrent users" # → Staff Engineer
+"set up a CI/CD pipeline with GitHub Actions" # → DevOps Engineer
+
+# Force a specific persona with @ prefix
+"@security-auditor review this auth flow"
+```
+
+---
+
+## Debug Mode
+
+Not sure which persona would load? Check before you send:
+
+```bash
+npx claude-agent-personas debug "why is my postgres query slow"
+```
+
+Output:
+```
+claude-agent-personas debug
+
+  Message: "why is my postgres query slow"
+
+  Persona                        Signals Matched               Score   Load?
+  ──────────────────────────────────────────────────────────────────────────────
+  principal-postgresql-dba       postgres, query, slow         3       YES
+  principal-mysql-dba            query                         1       no
+  dba-expert                     postgres, query, slow         3       no (dup)
+
+  Would load: principal-postgresql-dba.md (3 signal matches)
+```
+
+---
+
+## All Commands
+
+```bash
+npx claude-agent-personas init                        # Install everything
+npx claude-agent-personas init --dry-run              # Preview without writing
+npx claude-agent-personas init --profile engineering  # Install only engineering personas
+npx claude-agent-personas init --profile business     # Install only business personas
+npx claude-agent-personas update                      # Refresh personas from latest package
+npx claude-agent-personas list                        # Show all personas + token counts
+npx claude-agent-personas debug "<message>"           # Show routing decision
+npx claude-agent-personas remove                      # Clean uninstall
+npx claude-agent-personas add ./my-persona.md         # Add a custom persona
+npx claude-agent-personas lint ./my-persona.md        # Validate + token count
+```
+
+Short alias `persona` also works:
+
+```bash
+persona init
+persona debug "my message"
+persona list
+```
+
+---
+
+## Bundled Personas (72)
+
+### Engineering (55)
+
+#### General (3)
+| Persona | Triggers on |
+|---------|-------------|
+| Staff Engineer | architecture, scale, system design, tradeoff, distributed |
+| API Designer | api, rest, graphql, endpoint, swagger, openapi, schema |
+| Code Reviewer | review, pr, pull request, refactor, clean code, solid |
+
+#### Frontend (8)
+| Persona | Triggers on |
+|---------|-------------|
+| React Developer | react, jsx, hooks, useState, useEffect, zustand, react query |
+| Next.js Engineer | next.js, app router, server component, server actions, vercel |
+| Vue Developer | vue, vuex, pinia, nuxt, composition api, vueuse |
+| Angular Developer | angular, rxjs, ngrx, angular material, ngmodule |
+| CSS Specialist | css, scss, tailwind, styled components, flexbox, css grid |
+| Web Performance Engineer | core web vitals, lighthouse, lcp, cls, bundle size |
+| Accessibility Engineer | a11y, wcag, aria, screen reader, keyboard navigation |
+| Design System Engineer | design system, storybook, design tokens, component library |
+
+#### Backend (9)
+| Persona | Triggers on |
+|---------|-------------|
+| Python Developer | python, django, flask, fastapi, sqlalchemy, celery, pydantic |
+| Node.js Developer | node.js, express, nestjs, fastify, prisma, typeorm |
+| Java Developer | java, spring boot, maven, gradle, hibernate, jpa |
+| Go Developer | golang, goroutine, gin, echo, gorm, go module |
+| Rust Developer | rust, cargo, tokio, actix, axum, borrow checker |
+| .NET Developer | dotnet, c#, asp.net, entity framework, blazor, linq |
+| Ruby Developer | ruby, rails, activerecord, rspec, sidekiq |
+| PHP Developer | php, laravel, symfony, composer, eloquent |
+| GraphQL Developer | graphql, apollo, resolver, mutation, hasura, federation |
+
+#### Database (5)
+| Persona | Triggers on |
+|---------|-------------|
+| PostgreSQL DBA | postgresql, postgres, plpgsql, vacuum, explain analyze |
+| MySQL DBA | mysql, mariadb, innodb, binlog, proxysql |
+| MongoDB Developer | mongodb, mongoose, aggregation pipeline, atlas |
+| Redis Engineer | redis, pub sub, redis stream, redis cluster, cache invalidation |
+| Database Architect | data modeling, schema design, normalization, polyglot persistence |
+
+#### Data & ML (8)
+| Persona | Triggers on |
+|---------|-------------|
+| Data Scientist | data science, scikit-learn, pandas, numpy, jupyter |
+| ML Engineer | mlops, pytorch, tensorflow, mlflow, model serving |
+| LLM Engineer | llm, rag, prompt engineering, langchain, llamaindex, embeddings |
+| Data Engineer | data pipeline, etl, airflow, kafka, data lake |
+| dbt Analyst | dbt, analytics engineering, dbt model, dimensional modeling |
+| SQL Analyst | sql query, window function, cte, snowflake, redshift |
+| Spark Engineer | apache spark, pyspark, spark sql, databricks |
+| Data Architect | data mesh, data fabric, data governance, data catalog |
+
+#### DevOps & Infrastructure (8)
+| Persona | Triggers on |
+|---------|-------------|
+| DevOps Engineer | devops, ci/cd, pipeline, github actions, docker |
+| Kubernetes Engineer | kubernetes, k8s, kubectl, helm, argocd, istio |
+| Terraform Engineer | terraform, infrastructure as code, hcl, terragrunt |
+| AWS Architect | aws, ec2, s3, lambda, ecs, cloudformation, cdk |
+| GCP Engineer | gcp, google cloud, gke, cloud run, bigquery |
+| Azure Engineer | azure, aks, azure functions, cosmos db, bicep |
+| Platform Engineer | platform engineering, backstage, developer portal, golden path |
+| SRE Engineer | sre, slo, sla, error budget, incident management, chaos engineering |
+
+#### QA & Testing (7)
+| Persona | Triggers on |
+|---------|-------------|
+| Python QA Engineer | pytest, selenium python, playwright python, robot framework |
+| JavaScript QA Engineer | jest, cypress, playwright, vitest, testing library |
+| Java QA Engineer | junit, mockito, testng, testcontainers, cucumber |
+| Performance Tester | load test, jmeter, gatling, k6, locust, stress test |
+| Security Tester | penetration test, owasp zap, burp suite, vulnerability scan |
+| Mobile QA Engineer | appium, xcuitest, espresso, detox, device farm |
+| QA Architect | test strategy, test pyramid, quality gates, shift left |
+
+#### Mobile (4)
+| Persona | Triggers on |
+|---------|-------------|
+| iOS Developer | ios, swift, swiftui, uikit, xcode, cocoapods |
+| Android Developer | android, kotlin, jetpack compose, room, hilt |
+| React Native Developer | react native, expo, react navigation, hermes |
+| Flutter Developer | flutter, dart, bloc, riverpod, flutter pub |
+
+#### Security (3)
+| Persona | Triggers on |
+|---------|-------------|
+| AppSec Engineer | sql injection, xss, csrf, owasp, security code review |
+| Cloud Security Engineer | cloud security, iam security, cspm, zero trust |
+| Security Architect | threat model, security design, nist csf, defense in depth |
+
+### Business & Strategy (11)
+| Persona | Triggers on |
+|---------|-------------|
+| Contract Lawyer | contract, agreement, clause, nda, terms, liability, indemnify |
+| CFO Advisor | runway, burn, cap table, valuation, fundraise, arr, mrr |
+| Growth Marketer | launch, gtm, funnel, conversion, retention, cac, ltv |
+| Product Manager | roadmap, prd, user story, sprint, okr, backlog, prioritize |
+| Copywriter | copy, email, headline, landing page, cta, hook, aida |
+| Startup Advisor | pitch, yc, investor, idea, market size, tam, mvp |
+| Engineering Manager | 1:1, hiring, performance review, team building, sprint planning |
+| Agile Coach | scrum, kanban, retrospective, velocity, story points, ceremonies |
+| Solutions Architect | pre-sales, rfp, integration, vendor evaluation, poc, technical proposal |
+| Business Analyst | brd, requirements, process mapping, gap analysis, stakeholder, use case |
+| Developer Advocate | devrel, developer experience, api docs, tutorial, code sample, changelog |
+
+### Creative & Data (6)
+| Persona | Triggers on |
+|---------|-------------|
+| Data Scientist | pandas, dataframe, ml, model, sklearn, feature, accuracy |
+| Technical Writer | docs, readme, documentation, guide, tutorial, write |
+| UX Researcher | user research, persona, interview, usability, ux, journey |
+| SEO Specialist | seo, keyword, ranking, backlink, meta, crawl, serp |
+| Financial Analyst | dcf, npv, irr, model, forecast, revenue, p&l, ebitda |
+| Career Coach | resume, interview, linkedin, job, career, salary negotiation |
+
+---
+
+## Manual Override
+
+Always available — just prefix your message with `@persona-name`:
+
+```
+@principal-react-developer should I use useMemo or useCallback here?
+@contract-lawyer what does this liability cap actually mean?
+@principal-kubernetes-engineer review my deployment manifest
+```
+
+---
+
+## Add Your Own Persona
+
+Takes under 10 minutes. Copy `personas/_template.md`, fill in the 5 sections, add signals to `router-config.yml`:
+
+```bash
+# Copy template
+cp ~/.claude/personas/_template.md ~/.claude/personas/my-expert.md
+
+# Edit it, then validate
+npx claude-agent-personas lint ~/.claude/personas/my-expert.md
+
+# Add to routing config
+# Edit ~/.claude/personas/router-config.yml and add your signals
+```
+
+Token budget: keep personas under **500 tokens**. The linter will warn you if you go over.
+
+---
+
+## Contributing a Persona
+
+Want to add your persona to the official library? See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+PRs welcome — the more domain experts in the library, the better it gets for everyone.
+
+---
+
+## Uninstall
+
+```bash
+# Remove router block from CLAUDE.md (keeps persona files)
+npx claude-agent-personas remove
+
+# Remove everything including persona files
+npx claude-agent-personas remove --personas
+```
+
+---
+
+## License
+
+MIT © [D-Ankita](https://github.com/D-Ankita)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_js_1 = require("./commands/init.js");
+const update_js_1 = require("./commands/update.js");
+const list_js_1 = require("./commands/list.js");
+const debug_js_1 = require("./commands/debug.js");
+const remove_js_1 = require("./commands/remove.js");
+const lint_js_1 = require("./commands/lint.js");
+const add_js_1 = require("./commands/add.js");
+const program = new commander_1.Command();
+program
+    .name("persona")
+    .description("Intelligent persona routing OS for Claude Code")
+    .version("1.0.0");
+program.addCommand(init_js_1.initCommand);
+program.addCommand(update_js_1.updateCommand);
+program.addCommand(list_js_1.listCommand);
+program.addCommand(debug_js_1.debugCommand);
+program.addCommand(remove_js_1.removeCommand);
+program.addCommand(lint_js_1.lintCommand);
+program.addCommand(add_js_1.addCommand);
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,gDAAiD;AACjD,oDAAqD;AACrD,gDAAiD;AACjD,kDAAmD;AACnD,oDAAqD;AACrD,gDAAiD;AACjD,8CAA+C;AAE/C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,qBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,yBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,qBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,uBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,yBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,qBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,mBAAU,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/add.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const addCommand: Command;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,UAAU,SAyEnB,CAAC"}

package/dist/commands/add.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommand = void 0;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const persona_manager_js_1 = require("../persona-manager.js");
+const utils_js_1 = require("../utils.js");
+exports.addCommand = new commander_1.Command("add")
+    .description("Install a custom persona file")
+    .argument("<source>", "Path to a local persona .md file or URL")
+    .action(async (source) => {
+    console.log(chalk_1.default.bold.blue("\nclaude-agent-personas") + " add\n");
+    let filePath;
+    let tempFile = null;
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+        // Fetch from URL
+        console.log(chalk_1.default.dim(`  Fetching ${source}...`));
+        try {
+            const response = await fetch(source);
+            if (!response.ok) {
+                console.log(chalk_1.default.red(`  ✗ Failed to fetch: ${response.status} ${response.statusText}\n`));
+                process.exit(1);
+            }
+            const content = await response.text();
+            tempFile = path.join((0, utils_js_1.personasDir)(), "_temp_add.md");
+            (0, utils_js_1.ensureDir)((0, utils_js_1.personasDir)());
+            fs.writeFileSync(tempFile, content, "utf-8");
+            filePath = tempFile;
+        }
+        catch (err) {
+            console.log(chalk_1.default.red(`  ✗ Failed to fetch URL: ${err}\n`));
+            process.exit(1);
+            return;
+        }
+    }
+    else {
+        filePath = path.resolve(source);
+        if (!fs.existsSync(filePath)) {
+            console.log(chalk_1.default.red(`  ✗ File not found: ${filePath}\n`));
+            process.exit(1);
+        }
+    }
+    // Lint the file
+    const result = await (0, persona_manager_js_1.lintPersona)(filePath);
+    if (result.errors.length > 0) {
+        console.log(chalk_1.default.red("  Lint errors found:\n"));
+        for (const err of result.errors) {
+            console.log(chalk_1.default.red(`    ✗ ${err}`));
+        }
+        if (tempFile)
+            fs.unlinkSync(tempFile);
+        console.log(chalk_1.default.red("\n  Persona not installed. Fix errors and try again.\n"));
+        process.exit(1);
+    }
+    // Copy to personas directory
+    const destName = tempFile
+        ? path.basename(source).replace(/[^a-zA-Z0-9.-]/g, "-")
+        : path.basename(filePath);
+    const dest = path.join((0, utils_js_1.personasDir)(), destName);
+    (0, utils_js_1.ensureDir)((0, utils_js_1.personasDir)());
+    if (tempFile) {
+        fs.renameSync(tempFile, dest);
+    }
+    else {
+        fs.copyFileSync(filePath, dest);
+    }
+    console.log(chalk_1.default.green("  ✓") + ` Installed ${destName} to ~/.claude/personas/`);
+    if (result.warnings.length > 0) {
+        for (const warn of result.warnings) {
+            console.log(chalk_1.default.yellow(`    ⚠ ${warn}`));
+        }
+    }
+    console.log(chalk_1.default.dim(`\n  To activate: add signals to ~/.claude/personas/router-config.yml\n`));
+});
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}

package/dist/commands/debug.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const debugCommand: Command;
+//# sourceMappingURL=debug.d.ts.map

package/dist/commands/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,YAAY,SAkDrB,CAAC"}

package/dist/commands/debug.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debugCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const router_js_1 = require("../router.js");
+const persona_manager_js_1 = require("../persona-manager.js");
+exports.debugCommand = new commander_1.Command("debug")
+    .description("Show routing decision for a message")
+    .argument("<message>", "The message to test routing against")
+    .action((message) => {
+    const configs = (0, persona_manager_js_1.loadRouterConfig)();
+    if (configs.length === 0) {
+        console.log(chalk_1.default.yellow("\n  No router config found. Run: persona init\n"));
+        return;
+    }
+    console.log(chalk_1.default.bold.blue("\nclaude-agent-personas") + " debug\n");
+    console.log(chalk_1.default.dim(`  Message: "${message}"\n`));
+    const results = (0, router_js_1.routeAll)(message, configs);
+    const winner = (0, router_js_1.route)(message, configs);
+    if (results.length > 0) {
+        console.log("  " +
+            chalk_1.default.bold("Persona".padEnd(24)) +
+            chalk_1.default.bold("Signals Matched".padEnd(30)) +
+            chalk_1.default.bold("Score".padEnd(8)) +
+            chalk_1.default.bold("Load?"));
+        console.log("  " + "─".repeat(68));
+        for (const r of results) {
+            const loadMarker = r.wouldLoad ? chalk_1.default.green("✓ YES") : chalk_1.default.dim("no");
+            console.log("  " +
+                r.persona.padEnd(24) +
+                r.signals.join(", ").padEnd(30) +
+                String(r.score).padEnd(8) +
+                loadMarker);
+        }
+    }
+    console.log();
+    if (winner.persona) {
+        console.log(chalk_1.default.bold.green(`  Would load: ${winner.persona}.md (${winner.score} signal match${winner.score > 1 ? "es" : ""})`));
+    }
+    else {
+        console.log(chalk_1.default.dim("  No persona matched. Claude Code will use default behaviour."));
+    }
+    console.log();
+});
+//# sourceMappingURL=debug.js.map

package/dist/commands/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAoC;AACpC,kDAA0B;AAC1B,4CAA+C;AAC/C,8DAAyD;AAE5C,QAAA,YAAY,GAAG,IAAI,mBAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,qCAAqC,CAAC;KAClD,QAAQ,CAAC,WAAW,EAAE,qCAAqC,CAAC;KAC5D,MAAM,CAAC,CAAC,OAAe,EAAE,EAAE;IAC1B,MAAM,OAAO,GAAG,IAAA,qCAAgB,GAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,iDAAiD,CAAC,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,UAAU,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,eAAe,OAAO,KAAK,CAAC,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,IAAA,oBAAQ,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAA,iBAAK,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CACT,IAAI;YACF,eAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChC,eAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CACtB,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CACT,IAAI;gBACF,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBACzB,UAAU,CACb,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,KAAK,CACd,iBAAiB,MAAM,CAAC,OAAO,QAAQ,MAAM,CAAC,KAAK,gBAAgB,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CACnG,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,WAAW,SA8EpB,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = void 0;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const utils_js_1 = require("../utils.js");
+const persona_manager_js_1 = require("../persona-manager.js");
+const installer_js_1 = require("../installer.js");
+exports.initCommand = new commander_1.Command("init")
+    .description("Install persona routing system into Claude Code")
+    .option("--dry-run", "Show what would happen, write nothing")
+    .option("--profile <profile>", "Persona profile to install (engineering, business, creative-data, all)", "all")
+    .option("--force", "Overwrite existing files")
+    .action(async (options) => {
+    const dryRun = options.dryRun || false;
+    const profile = options.profile;
+    const force = options.force || false;
+    // Banner
+    console.log(chalk_1.default.bold.blue("\nclaude-agent-personas") + " v1.0.0\n");
+    if (dryRun) {
+        console.log(chalk_1.default.yellow("  [DRY RUN] No files will be written.\n"));
+    }
+    // Step 1-2: Ensure directories
+    if (!dryRun) {
+        (0, utils_js_1.ensureDir)((0, utils_js_1.claudeDir)());
+        (0, utils_js_1.ensureDir)((0, utils_js_1.personasDir)());
+    }
+    console.log(chalk_1.default.green("  ✓") + " Ensured ~/.claude/personas/ exists");
+    // Step 3: Copy router-config.yml
+    if (!dryRun) {
+        const installed = (0, persona_manager_js_1.installRouterConfig)(force);
+        if (installed) {
+            console.log(chalk_1.default.green("  ✓") + " Installed router-config.yml");
+        }
+        else {
+            console.log(chalk_1.default.dim("  ○ router-config.yml already exists (skipped)"));
+        }
+    }
+    else {
+        console.log(chalk_1.default.dim("  ○ Would install router-config.yml"));
+    }
+    // Step 4: Copy persona files
+    if (!dryRun) {
+        const { copied, skipped } = (0, persona_manager_js_1.installPersonas)(profile, force);
+        console.log(chalk_1.default.green("  ✓") + ` Installed ${copied} personas (${skipped} skipped)`);
+    }
+    else {
+        console.log(chalk_1.default.dim(`  ○ Would install personas (profile: ${profile})`));
+    }
+    // Step 5-10: Handle CLAUDE.md
+    const routerBlock = fs.readFileSync(path.join((0, utils_js_1.bundledSnippetsDir)(), "claude-md-block.md"), "utf-8");
+    const claudeMdPath = (0, installer_js_1.findClaudeMd)();
+    if (claudeMdPath) {
+        const content = fs.readFileSync(claudeMdPath, "utf-8");
+        if ((0, installer_js_1.hasRouterBlock)(content)) {
+            console.log(chalk_1.default.dim("  ○ Already installed. Run persona update to refresh."));
+        }
+        else if (!dryRun) {
+            (0, installer_js_1.appendRouterBlock)(claudeMdPath, routerBlock);
+            console.log(chalk_1.default.green("  ✓") + ` Appended router block to ${claudeMdPath}`);
+        }
+        else {
+            console.log(chalk_1.default.dim(`  ○ Would append router block to ${claudeMdPath}`));
+        }
+    }
+    else {
+        if (!dryRun) {
+            const created = (0, installer_js_1.createClaudeMd)((0, utils_js_1.claudeDir)(), routerBlock);
+            console.log(chalk_1.default.green("  ✓") + ` Created ${created} with router block`);
+        }
+        else {
+            console.log(chalk_1.default.dim("  ○ Would create ~/.claude/CLAUDE.md"));
+        }
+    }
+    // Success summary
+    console.log(chalk_1.default.bold.green("\n  ✓ Setup complete!\n"));
+    console.log(chalk_1.default.dim("  Quick start:"));
+    console.log(`  Try: ${chalk_1.default.cyan('"why is my postgres query slow?"')}  → loads dba-expert`);
+    console.log(`  Try: ${chalk_1.default.cyan('"review this NDA clause"')}          → loads contract-lawyer`);
+    console.log(`  Try: ${chalk_1.default.cyan('"@staff-engineer design this API"')} → forces staff-engineer`);
+    console.log();
+});
+//# sourceMappingURL=init.js.map