@hivehub/rulebook 4.2.2 → 4.3.0

package/dist/core/claude-mcp.d.ts

@@ -9,6 +9,7 @@ export interface ClaudeCodeSetupResult {
     detected: boolean;
     mcpConfigured: boolean;
     skillsInstalled: string[];
+    devSkillsInstalled: string[];
     agentTeamsEnabled: boolean;
     agentDefinitionsInstalled: string[];
 }
@@ -26,10 +27,16 @@ export declare function isClaudeCodeInstalled(homeDir?: string): Promise<boolean
  */
 export declare function configureMcpJson(projectRoot: string): Promise<boolean>;
 /**
- * Install rulebook skill templates as Claude Code commands.
+ * Install rulebook skill templates as Claude Code commands (legacy format).
  * Copies templates/commands/*.md to .claude/commands/ in the project.
  */
 export declare function installClaudeCodeSkills(projectRoot: string, templatesPath: string): Promise<string[]>;
+/**
+ * Install dev skills to .claude/skills/ (modern Claude Code format).
+ * Each skill is a directory with a SKILL.md file.
+ * Copies templates/dev-skills/<name>/SKILL.md to .claude/skills/<name>/SKILL.md.
+ */
+export declare function installDevSkills(projectRoot: string, templatesPath: string): Promise<string[]>;
 /**
  * Configure .claude/settings.json to enable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS.
  * Creates the file if it does not exist. Preserves existing settings.

package/dist/core/claude-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-mcp.d.ts","sourceRoot":"","sources":["../../src/core/claude-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9E;AAYD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC5E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBnF;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAWD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CA8BhC"}
+{"version":3,"file":"claude-mcp.d.ts","sourceRoot":"","sources":["../../src/core/claude-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9E;AAYD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC5E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBnF;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAWD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAiChC"}

package/dist/core/claude-mcp.js

@@ -67,7 +67,7 @@ export async function configureMcpJson(projectRoot) {
     return true;
 }
 /**
- * Install rulebook skill templates as Claude Code commands.
+ * Install rulebook skill templates as Claude Code commands (legacy format).
  * Copies templates/commands/*.md to .claude/commands/ in the project.
  */
 export async function installClaudeCodeSkills(projectRoot, templatesPath) {
@@ -90,6 +90,34 @@ export async function installClaudeCodeSkills(projectRoot, templatesPath) {
     }
     return installed;
 }
+/**
+ * Install dev skills to .claude/skills/ (modern Claude Code format).
+ * Each skill is a directory with a SKILL.md file.
+ * Copies templates/dev-skills/<name>/SKILL.md to .claude/skills/<name>/SKILL.md.
+ */
+export async function installDevSkills(projectRoot, templatesPath) {
+    const skillsSourceDir = join(templatesPath, 'skills', 'dev');
+    const skillsTargetDir = join(projectRoot, '.claude', 'skills');
+    if (!(await fileExists(skillsSourceDir))) {
+        return [];
+    }
+    await ensureDir(skillsTargetDir);
+    const entries = await readdir(skillsSourceDir, { withFileTypes: true });
+    const installed = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillFile = join(skillsSourceDir, entry.name, 'SKILL.md');
+        if (!(await fileExists(skillFile)))
+            continue;
+        const targetSkillDir = join(skillsTargetDir, entry.name);
+        await ensureDir(targetSkillDir);
+        const content = await readFile(skillFile);
+        await writeFile(join(targetSkillDir, 'SKILL.md'), content);
+        installed.push(entry.name);
+    }
+    return installed;
+}
 /**
  * Configure .claude/settings.json to enable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS.
  * Creates the file if it does not exist. Preserves existing settings.
@@ -161,6 +189,7 @@ export async function setupClaudeCodeIntegration(projectRoot, templatesPath, hom
             detected: false,
             mcpConfigured: false,
             skillsInstalled: [],
+            devSkillsInstalled: [],
             agentTeamsEnabled: false,
             agentDefinitionsInstalled: [],
         };
@@ -168,12 +197,14 @@ export async function setupClaudeCodeIntegration(projectRoot, templatesPath, hom
     const resolvedTemplatesPath = templatesPath ?? getTemplatesPath();
     const mcpConfigured = await configureMcpJson(projectRoot);
     const skillsInstalled = await installClaudeCodeSkills(projectRoot, resolvedTemplatesPath);
+    const devSkillsInstalled = await installDevSkills(projectRoot, resolvedTemplatesPath);
     const agentTeamsEnabled = await configureClaudeSettings(projectRoot);
     const agentDefinitionsInstalled = await installAgentDefinitions(projectRoot, resolvedTemplatesPath);
     return {
         detected: true,
         mcpConfigured,
         skillsInstalled,
+        devSkillsInstalled,
         agentTeamsEnabled,
         agentDefinitionsInstalled,
     };

package/dist/core/claude-mcp.js.map

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

package/dist/core/generator.d.ts

@@ -5,6 +5,19 @@ export declare function generateFrameworkRules(framework: string): Promise<strin
 export declare function generateModuleRules(module: string): Promise<string>;
 export declare function generateServiceRules(service: string): Promise<string>;
 export declare function generateGitRules(pushMode: string): Promise<string>;
+/**
+ * Generate the agent delegation section for AGENTS.md.
+ * Adapts table based on detected languages and frameworks.
+ */
+export declare function generateDelegationSection(config: ProjectConfig): string;
+/**
+ * Resolve placeholder values from project config.
+ */
+export declare function resolveAgentPlaceholders(config: ProjectConfig): Record<string, string>;
+/**
+ * Substitute placeholders in agent template content.
+ */
+export declare function substituteAgentPlaceholders(content: string, placeholders: Record<string, string>): string;
 /**
  * Generate modular AGENTS.md with references
  */

package/dist/core/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2BjD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA2VlF;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7E;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/E;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDxE;AAkKD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CA6UjB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CAoEjB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2BjD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA2VlF;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7E;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/E;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDxE;AA4RD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAyCvE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgDtF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAMR;AA2DD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CAwVjB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CAoEjB"}

package/dist/core/generator.js

@@ -326,11 +326,11 @@ export async function generateFrameworkRules(framework) {
         return await readFile(templatePath);
     }
     const title = framework.charAt(0).toUpperCase() + framework.slice(1);
-    return `<!-- ${framework.toUpperCase()}:START -->
-# ${title} Framework Rules
-
-Framework-specific rules for ${title}.
-<!-- ${framework.toUpperCase()}:END -->
+    return `<!-- ${framework.toUpperCase()}:START -->
+# ${title} Framework Rules
+
+Framework-specific rules for ${title}.
+<!-- ${framework.toUpperCase()}:END -->
 `;
 }
 export async function generateModuleRules(module) {
@@ -374,31 +374,31 @@ export async function generateGitRules(pushMode) {
     // Add push mode configuration
     const pushModeConfig = `\n**AI Assistant Git Push Mode**: ${pushMode.toUpperCase()}\n\n`;
     const pushModeInstructions = {
-        manual: `**CRITICAL**: Never execute \`git push\` commands automatically.
-Always provide push commands for manual execution by the user.
-
-Example:
-\`\`\`
-✋ MANUAL ACTION REQUIRED:
-Run these commands manually (SSH password may be required):
-  git push origin main
-  git push origin v1.0.0
+        manual: `**CRITICAL**: Never execute \`git push\` commands automatically.
+Always provide push commands for manual execution by the user.
+
+Example:
+\`\`\`
+✋ MANUAL ACTION REQUIRED:
+Run these commands manually (SSH password may be required):
+  git push origin main
+  git push origin v1.0.0
 \`\`\``,
-        prompt: `**CRITICAL**: Always ask user permission before pushing.
-
-Example:
-\`\`\`
-Ready to push changes. Execute these commands?
-  git push origin main
-
-[Y/n]:
+        prompt: `**CRITICAL**: Always ask user permission before pushing.
+
+Example:
+\`\`\`
+Ready to push changes. Execute these commands?
+  git push origin main
+
+[Y/n]:
 \`\`\``,
-        auto: `**INFO**: Automatic push enabled.
-AI assistants may execute push commands automatically.
-
-⚠️ Only use this mode if:
-- SSH key has no password
-- GitHub CLI is authenticated
+        auto: `**INFO**: Automatic push enabled.
+AI assistants may execute push commands automatically.
+
+⚠️ Only use this mode if:
+- SSH key has no password
+- GitHub CLI is authenticated
 - You trust the AI assistant completely`,
     };
     // Insert push mode config after <!-- GIT:START -->
@@ -514,6 +514,251 @@ async function loadProjectConfigFromRulebook(projectRoot = process.cwd()) {
         return {};
     }
 }
+const AGENT_REGISTRY = [
+    // Core agents
+    {
+        task: 'Implementation',
+        agent: 'implementer',
+        model: 'sonnet',
+        when: 'Writing new code or modifying existing',
+    },
+    {
+        task: 'Research',
+        agent: 'researcher',
+        model: 'haiku',
+        when: 'Exploring codebase, finding patterns',
+    },
+    {
+        task: 'Testing',
+        agent: 'tester',
+        model: 'sonnet',
+        when: 'Writing and running tests',
+    },
+    {
+        task: 'Documentation',
+        agent: 'docs-writer',
+        model: 'haiku',
+        when: 'README, docs, changelogs',
+    },
+    {
+        task: 'Code Review',
+        agent: 'code-reviewer',
+        model: 'sonnet',
+        when: 'Reviewing implementations for quality',
+    },
+    {
+        task: 'Build/CI',
+        agent: 'build-engineer',
+        model: 'sonnet',
+        when: 'Build failures, CI, dependencies',
+    },
+    {
+        task: 'Security',
+        agent: 'security-reviewer',
+        model: 'haiku',
+        when: 'Dependency audit, vulnerability review',
+    },
+    // Specialist agents
+    {
+        task: 'Architecture',
+        agent: 'architect',
+        model: 'opus',
+        when: 'System design, ADRs, scalability decisions',
+    },
+    {
+        task: 'API Design',
+        agent: 'api-designer',
+        model: 'sonnet',
+        when: 'REST/GraphQL endpoints, OpenAPI specs',
+    },
+    {
+        task: 'Database',
+        agent: 'database-architect',
+        model: 'sonnet',
+        when: 'Schema design, migrations, query optimization',
+    },
+    {
+        task: 'DevOps',
+        agent: 'devops-engineer',
+        model: 'sonnet',
+        when: 'CI/CD, Docker, Kubernetes, infrastructure',
+    },
+    {
+        task: 'Performance',
+        agent: 'performance-engineer',
+        model: 'sonnet',
+        when: 'Profiling, benchmarks, optimization',
+    },
+    {
+        task: 'Refactoring',
+        agent: 'refactoring-agent',
+        model: 'sonnet',
+        when: 'Code smells, complexity reduction, cleanup',
+    },
+    {
+        task: 'Migration',
+        agent: 'migration-engineer',
+        model: 'sonnet',
+        when: 'DB migrations, API migrations, upgrades',
+    },
+    {
+        task: 'Accessibility',
+        agent: 'accessibility-reviewer',
+        model: 'haiku',
+        when: 'WCAG compliance, ARIA, screen readers',
+    },
+    {
+        task: 'i18n',
+        agent: 'i18n-engineer',
+        model: 'haiku',
+        when: 'Internationalization, localization, RTL',
+    },
+    {
+        task: 'UX Review',
+        agent: 'ux-reviewer',
+        model: 'haiku',
+        when: 'Usability, interaction patterns, error states',
+    },
+    // Orchestration
+    {
+        task: 'Orchestration',
+        agent: 'team-lead',
+        model: 'opus',
+        when: 'Multi-agent coordination for complex tasks',
+    },
+];
+/**
+ * Generate the agent delegation section for AGENTS.md.
+ * Adapts table based on detected languages and frameworks.
+ */
+export function generateDelegationSection(config) {
+    const lines = [];
+    const primaryLang = config.languages?.[0] || 'the project language';
+    const primaryFramework = config.frameworks?.[0] || '';
+    lines.push('## Agent Delegation');
+    lines.push('');
+    lines.push('Delegate work to specialist agents instead of doing everything in the main conversation. Each agent uses a cost-appropriate model.');
+    lines.push('');
+    lines.push('| Task | Agent | Model | When to use |');
+    lines.push('|------|-------|-------|-------------|');
+    for (const entry of AGENT_REGISTRY) {
+        lines.push(`| ${entry.task} | ${entry.agent} | ${entry.model} | ${entry.when} |`);
+    }
+    lines.push('');
+    lines.push('### Delegation Rules');
+    lines.push('');
+    lines.push('1. **Never write code directly in the main conversation** — delegate to the appropriate agent');
+    lines.push('2. **After implementing code**, launch tester + docs-writer in parallel to update tests and documentation');
+    lines.push('3. **The main conversation** serves for planning, coordination, and user communication only');
+    lines.push('4. **Use haiku agents** (researcher, docs-writer, security-reviewer) for read-only tasks — they are significantly cheaper');
+    lines.push('5. **Launch independent agents in parallel** when possible to maximize throughput');
+    lines.push('');
+    lines.push(`> **Project context**: Primary language is **${primaryLang}**${primaryFramework ? ` with **${primaryFramework}**` : ''}. Agents are pre-configured with this context.`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Resolve placeholder values from project config.
+ */
+export function resolveAgentPlaceholders(config) {
+    const primaryLang = config.languages?.[0] || 'TypeScript';
+    const primaryFramework = config.frameworks?.[0] || '';
+    // Map language to common test framework
+    const testFrameworkMap = {
+        typescript: 'vitest',
+        javascript: 'jest',
+        python: 'pytest',
+        rust: 'cargo test',
+        go: 'go test',
+        java: 'JUnit',
+        csharp: 'xUnit',
+        ruby: 'RSpec',
+        php: 'PHPUnit',
+        swift: 'XCTest',
+        kotlin: 'JUnit',
+        dart: 'flutter test',
+        elixir: 'ExUnit',
+        scala: 'ScalaTest',
+    };
+    // Map language to file naming convention
+    const fileNamingMap = {
+        typescript: 'kebab-case',
+        javascript: 'kebab-case',
+        python: 'snake_case',
+        rust: 'snake_case',
+        go: 'snake_case',
+        java: 'PascalCase',
+        csharp: 'PascalCase',
+        ruby: 'snake_case',
+        php: 'PascalCase',
+        swift: 'PascalCase',
+        kotlin: 'PascalCase',
+        dart: 'snake_case',
+        elixir: 'snake_case',
+        scala: 'PascalCase',
+    };
+    const langKey = primaryLang.toLowerCase();
+    return {
+        '{{language}}': primaryLang,
+        '{{framework}}': primaryFramework || 'none',
+        '{{test_framework}}': testFrameworkMap[langKey] || 'the project test framework',
+        '{{file_naming}}': fileNamingMap[langKey] || 'kebab-case',
+    };
+}
+/**
+ * Substitute placeholders in agent template content.
+ */
+export function substituteAgentPlaceholders(content, placeholders) {
+    let result = content;
+    for (const [key, value] of Object.entries(placeholders)) {
+        result = result.replaceAll(key, value);
+    }
+    return result;
+}
+/**
+ * Install agent definitions to .claude/agents/ with placeholder substitution.
+ */
+async function installAgentsWithPlaceholders(projectRoot, config) {
+    const agentsDir = path.join(getTemplatesDir(), 'agents');
+    const targetDir = path.join(projectRoot, '.claude', 'agents');
+    if (!(await fileExists(agentsDir)))
+        return;
+    await ensureDir(targetDir);
+    const placeholders = resolveAgentPlaceholders(config);
+    const { readdirSync } = await import('fs');
+    const files = readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+    for (const file of files) {
+        const content = await readFile(path.join(agentsDir, file));
+        const substituted = substituteAgentPlaceholders(content, placeholders);
+        await writeFile(path.join(targetDir, file), substituted);
+    }
+}
+/**
+ * Install dev skills to .claude/skills/ (modern Claude Code skills format).
+ * Each skill is a directory with a SKILL.md file.
+ * Always installed on init/update — useful for any project regardless of size.
+ */
+async function installDevSkillsFromTemplates(projectRoot) {
+    const { readdirSync, statSync } = await import('fs');
+    const skillsSourceDir = path.join(getTemplatesDir(), 'skills', 'dev');
+    const skillsTargetDir = path.join(projectRoot, '.claude', 'skills');
+    if (!(await fileExists(skillsSourceDir)))
+        return;
+    await ensureDir(skillsTargetDir);
+    const entries = readdirSync(skillsSourceDir);
+    for (const entry of entries) {
+        const entryPath = path.join(skillsSourceDir, entry);
+        if (!statSync(entryPath).isDirectory())
+            continue;
+        const skillFile = path.join(entryPath, 'SKILL.md');
+        if (!(await fileExists(skillFile)))
+            continue;
+        const targetSkillDir = path.join(skillsTargetDir, entry);
+        await ensureDir(targetSkillDir);
+        const content = await readFile(skillFile);
+        await writeFile(path.join(targetSkillDir, 'SKILL.md'), content);
+    }
+}
 /**
  * Generate modular AGENTS.md with references
  */
@@ -769,6 +1014,16 @@ export async function generateModularAgents(config, projectRoot = process.cwd())
     catch {
         // Multi-tool generation failed - skip silently
     }
+    // Generate agent delegation section
+    sections.push(generateDelegationSection(mergedConfig));
+    // Install agent definitions and dev skills to .claude/
+    try {
+        await installAgentsWithPlaceholders(projectRoot, mergedConfig);
+        await installDevSkillsFromTemplates(projectRoot);
+    }
+    catch {
+        // Agent/skill installation failed — skip silently
+    }
     // Append AGENTS.override.md content if present and non-empty
     try {
         const { readOverrideContent } = await import('./override-manager.js');