@hivehub/rulebook 5.7.0 → 5.8.0

package/.claude/commands/rulebook-task-show.md

@@ -1,52 +1,52 @@
----
-name: /rulebook-task-show
-id: rulebook-task-show
-category: Rulebook
-description: Show detailed information about a specific Rulebook task.
----
-<!-- RULEBOOK:START -->
-**Guardrails**
-- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
-- Keep changes tightly scoped to the requested outcome.
-- Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
-
-**Steps**
-1. **Show Task Details**:
-   ```bash
-   rulebook task show <task-id>
-   ```
-   Displays:
-   - Task ID and title
-   - Status (pending, in-progress, completed, blocked)
-   - Created and updated dates
-   - Archive date (if archived)
-   - Proposal summary
-   - Spec files list
-
-2. **Review Proposal**:
-   - Read `proposal.md` to understand why and what changes
-   - Check impact assessment
-   - Verify breaking changes are documented
-
-3. **Review Tasks Checklist**:
-   - Check `tasks.md` for implementation checklist
-   - Identify completed items (`[x]`)
-   - Identify pending items (`[ ]`)
-   - Follow priority order (most critical first)
-
-4. **Review Spec Deltas**:
-   - Check `specs/*/spec.md` files
-   - Verify format compliance (SHALL/MUST, 4 hashtags for scenarios)
-   - Understand requirements and scenarios
-
-5. **Check Task Status**:
-   - Verify task is not blocked
-   - Check if task is ready for implementation
-   - Confirm all prerequisites are met
-
-**Reference**
-- Use `rulebook task list` to see all tasks
-- Use `rulebook task validate <task-id>` to check task format
-- See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
-<!-- RULEBOOK:END -->
-
+---
+name: /rulebook-task-show
+id: rulebook-task-show
+category: Rulebook
+description: Show detailed information about a specific Rulebook task.
+---
+<!-- RULEBOOK:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
+
+**Steps**
+1. **Show Task Details**:
+   ```bash
+   rulebook task show <task-id>
+   ```
+   Displays:
+   - Task ID and title
+   - Status (pending, in-progress, completed, blocked)
+   - Created and updated dates
+   - Archive date (if archived)
+   - Proposal summary
+   - Spec files list
+
+2. **Review Proposal**:
+   - Read `proposal.md` to understand why and what changes
+   - Check impact assessment
+   - Verify breaking changes are documented
+
+3. **Review Tasks Checklist**:
+   - Check `tasks.md` for implementation checklist
+   - Identify completed items (`[x]`)
+   - Identify pending items (`[ ]`)
+   - Follow priority order (most critical first)
+
+4. **Review Spec Deltas**:
+   - Check `specs/*/spec.md` files
+   - Verify format compliance (SHALL/MUST, 4 hashtags for scenarios)
+   - Understand requirements and scenarios
+
+5. **Check Task Status**:
+   - Verify task is not blocked
+   - Check if task is ready for implementation
+   - Confirm all prerequisites are met
+
+**Reference**
+- Use `rulebook task list` to see all tasks
+- Use `rulebook task validate <task-id>` to check task format
+- See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
+<!-- RULEBOOK:END -->
+

package/.claude/commands/rulebook-task-validate.md

@@ -1,53 +1,53 @@
----
-name: /rulebook-task-validate
-id: rulebook-task-validate
-category: Rulebook
-description: Validate Rulebook task format against OpenSpec-compatible requirements.
----
-<!-- RULEBOOK:START -->
-**Guardrails**
-- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
-- Keep changes tightly scoped to the requested outcome.
-- Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
-
-**Steps**
-1. **Validate Task Format**:
-   ```bash
-   rulebook task validate <task-id>
-   ```
-   Checks:
-   - Purpose section length (≥20 characters)
-   - Requirement keywords (SHALL/MUST)
-   - Scenario format (4 hashtags, not 3)
-   - Given/When/Then structure
-   - Delta headers format (ADDED/MODIFIED/REMOVED/RENAMED)
-
-2. **Review Validation Results**:
-   - **Errors**: Must be fixed before proceeding
-   - **Warnings**: Should be addressed but not blocking
-
-3. **Fix Format Issues**:
-   - **Purpose too short**: Expand "Why" section to ≥20 characters
-   - **Missing SHALL/MUST**: Add SHALL or MUST keyword to requirements
-   - **Wrong scenario format**: Change `### Scenario:` to `#### Scenario:` (4 hashtags)
-   - **Missing Given/When/Then**: Replace bullet points with Given/When/Then structure
-   - **Wrong delta headers**: Use ADDED/MODIFIED/REMOVED/RENAMED, not "New Requirements"
-
-4. **Re-validate After Fixes**:
-   ```bash
-   rulebook task validate <task-id>
-   ```
-   Ensure all errors are resolved.
-
-5. **Common Format Errors**:
-   - ❌ `### Scenario:` (3 hashtags) → ✅ `#### Scenario:` (4 hashtags)
-   - ❌ "The system provides X" → ✅ "The system SHALL provide X"
-   - ❌ `- WHEN user does X THEN Y` → ✅ `Given X\nWhen Y\nThen Z`
-   - ❌ `## New Requirements` → ✅ `## ADDED Requirements`
-
-**Reference**
-- See `/.rulebook/specs/RULEBOOK.md` for complete format requirements
-- Use Context7 MCP to get official OpenSpec format documentation
-- Use `rulebook task show <task-id>` to view task details
-<!-- RULEBOOK:END -->
-
+---
+name: /rulebook-task-validate
+id: rulebook-task-validate
+category: Rulebook
+description: Validate Rulebook task format against OpenSpec-compatible requirements.
+---
+<!-- RULEBOOK:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
+
+**Steps**
+1. **Validate Task Format**:
+   ```bash
+   rulebook task validate <task-id>
+   ```
+   Checks:
+   - Purpose section length (≥20 characters)
+   - Requirement keywords (SHALL/MUST)
+   - Scenario format (4 hashtags, not 3)
+   - Given/When/Then structure
+   - Delta headers format (ADDED/MODIFIED/REMOVED/RENAMED)
+
+2. **Review Validation Results**:
+   - **Errors**: Must be fixed before proceeding
+   - **Warnings**: Should be addressed but not blocking
+
+3. **Fix Format Issues**:
+   - **Purpose too short**: Expand "Why" section to ≥20 characters
+   - **Missing SHALL/MUST**: Add SHALL or MUST keyword to requirements
+   - **Wrong scenario format**: Change `### Scenario:` to `#### Scenario:` (4 hashtags)
+   - **Missing Given/When/Then**: Replace bullet points with Given/When/Then structure
+   - **Wrong delta headers**: Use ADDED/MODIFIED/REMOVED/RENAMED, not "New Requirements"
+
+4. **Re-validate After Fixes**:
+   ```bash
+   rulebook task validate <task-id>
+   ```
+   Ensure all errors are resolved.
+
+5. **Common Format Errors**:
+   - ❌ `### Scenario:` (3 hashtags) → ✅ `#### Scenario:` (4 hashtags)
+   - ❌ "The system provides X" → ✅ "The system SHALL provide X"
+   - ❌ `- WHEN user does X THEN Y` → ✅ `Given X\nWhen Y\nThen Z`
+   - ❌ `## New Requirements` → ✅ `## ADDED Requirements`
+
+**Reference**
+- See `/.rulebook/specs/RULEBOOK.md` for complete format requirements
+- Use Context7 MCP to get official OpenSpec format documentation
+- Use `rulebook task show <task-id>` to view task details
+<!-- RULEBOOK:END -->
+

package/.claude-plugin/marketplace.json

@@ -1,28 +1,28 @@
-{
-  "name": "hivehub-marketplace",
-  "owner": {
-    "name": "HiveLLM Team",
-    "email": "support@hivellm.com",
-    "url": "https://github.com/hivellm"
-  },
-  "plugins": [
-    {
-      "name": "rulebook",
-      "source": ".",
-      "description": "Standardize AI-generated projects with skills, templates, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
-      "version": "4.3.0",
-      "repository": "https://github.com/hivellm/rulebook",
-      "homepage": "https://github.com/hivellm/rulebook#readme",
-      "keywords": [
-        "ai",
-        "automation",
-        "templates",
-        "standards",
-        "skills",
-        "mcp",
-        "task-management",
-        "quality-gates"
-      ]
-    }
-  ]
-}
+{
+  "name": "hivehub-marketplace",
+  "owner": {
+    "name": "HiveLLM Team",
+    "email": "support@hivellm.com",
+    "url": "https://github.com/hivellm"
+  },
+  "plugins": [
+    {
+      "name": "rulebook",
+      "source": ".",
+      "description": "Standardize AI-generated projects with skills, templates, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
+      "version": "4.3.0",
+      "repository": "https://github.com/hivellm/rulebook",
+      "homepage": "https://github.com/hivellm/rulebook#readme",
+      "keywords": [
+        "ai",
+        "automation",
+        "templates",
+        "standards",
+        "skills",
+        "mcp",
+        "task-management",
+        "quality-gates"
+      ]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
-{
-  "name": "rulebook",
-  "description": "Standardize AI-generated projects with Ralph autonomous loop, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
-  "version": "5.2.0",
-  "author": {
-    "name": "HiveLLM"
-  }
-}
+{
+  "name": "rulebook",
+  "description": "Standardize AI-generated projects with Ralph autonomous loop, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
+  "version": "5.2.0",
+  "author": {
+    "name": "HiveLLM"
+  }
+}

package/README.md

@@ -25,10 +25,22 @@ npx @hivehub/rulebook@latest update
 
 # Check project health
 npx @hivehub/rulebook@latest doctor
+
+# Apply the recommended Claude Code setup (MCP, agents, workflows, settings)
+npx @hivehub/rulebook@latest claude
 ```
 
 That's it. Rulebook detects your stack, generates rules for every AI tool in your project, sets up quality gates, and configures MCP integration — all in one command.
 
+Then, inside Claude Code, spec a feature and let the backlog implement itself:
+
+```
+/spec rate-limit the public REST API   # asks questions, creates rulebook tasks
+/rulebook-driver                        # implements every task, opus review gate
+```
+
+See [Usage Examples](docs/usage-examples.md) for the full set of end-to-end flows.
+
 > Install globally with `npm install -g @hivehub/rulebook` to use `rulebook` directly.
 
 ---
@@ -137,6 +149,77 @@ Cross-platform (Node.js, no `jq` dependency).
 
 ---
 
+## Multi-Agent Workflows
+
+`rulebook init`/`update` installs orchestrated [Claude Code Workflow](https://code.claude.com/docs/en/workflows) scripts into `.claude/workflows/`. Each fans work out across the bundled agents with cost-tiered models — `haiku` for read-only steps, `sonnet` for implementation, `opus` for the final review gate.
+
+| Workflow | What it does | Args |
+|----------|--------------|------|
+| `rulebook-driver` | Loops the backlog: discover next unchecked task item → implement (SDD+TDD) → independent **opus** reviewer gate (≤3 rounds) → document → next, until drained / a item fails / cap / low budget | `{ once?, maxItems?, minBudget? }` |
+| `spec-author` | Help author a task spec: research → draft proposal + SHALL/MUST spec → **opus** gap-critic returns ranked clarifying questions + gaps for you to answer (re-run with answers to iterate) | `{ topic, answers? }` |
+| `feature-pipeline` | research → architect (opus) → implement → test → **opus** review → document | `{ feature }` |
+| `bugfix` | root-cause → TDD fix → **opus** quality-gatekeeper verdict (≤2 rounds) | `{ bug }` |
+| `review-fanout` | Adversarial multi-dimension review of the diff (correctness/security/perf/tests), each finding verified, **opus** synthesis | — |
+| `release-gate` | Parallel build / tests+coverage / security / docs → single go/no-go | — |
+
+The independent reviewers run as fresh subagents with **no developer context** — they see only the `git diff` plus the spec, so the gate is a genuine second opinion.
+
+### Running a workflow
+
+Invoke a workflow from Claude Code with the matching slash command. Some take arguments (a JSON object):
+
+```
+/rulebook-driver                              # drain the whole backlog
+/rulebook-driver { "once": true }             # one item, then stop
+/rulebook-driver { "maxItems": 5 }            # at most 5 items this run
+/spec-author { "topic": "rate-limit the public API" }
+/feature-pipeline { "feature": "add CSV export to the report page" }
+/bugfix { "bug": "tasks.md checkbox state lost on archive" }
+/review-fanout                                # reviews the current git diff
+/release-gate                                 # go/no-go before a release
+```
+
+### `rulebook-driver` — the backlog loop
+
+Discovers the first unchecked `- [ ]` item (lowest phase first, never reordered), then per item: implement (SDD+TDD) → independent **opus** review → on reject, loops back to the dev with the blocking issues (max 3 rounds) → document. It then moves to the next item and repeats until one of: backlog drained, an item fails review after 3 rounds (the loop halts — sequential tasks must not build on a broken item), `maxItems` reached (default 25), or the token budget runs low (`minBudget`, default 60k). Args: `{ once?, maxItems?, minBudget? }`.
+
+### `spec-author` — interactive spec authoring
+
+Because workflow subagents are **non-interactive**, `spec-author` cannot prompt you mid-run. Instead it researches the codebase, drafts a proposal + SHALL/MUST spec, then returns ranked clarifying **questions** and detected **gaps**. The loop:
+
+1. `/spec-author { "topic": "..." }` → returns a draft + questions/gaps.
+2. Answer the questions.
+3. Re-run feeding the answers back: `/spec-author { "topic": "...", "answers": [{ "question": "...", "answer": "..." }] }`.
+4. Repeat until it returns `ready: true` (no open questions). Then create the task with `rulebook task create` using the finalized spec.
+
+### What the reviewers check
+
+The `rulebook-driver`, `feature-pipeline`, and `bugfix` gates judge two axes and only pass when both hold: **SDD** — every SHALL/MUST scenario in the spec is satisfied and nothing unspecified was added; **TDD** — tests exist for the new behavior, were written for it, and actually run and pass. The reviewer runs the type-checker and the relevant tests itself rather than trusting the developer's report.
+
+---
+
+## Claude Code Setup
+
+`rulebook claude` applies the recommended Claude Code setup in one idempotent, non-interactive step — useful to (re)apply the best configuration at any time without re-running `init`.
+
+```bash
+rulebook claude                 # apply the recommended setup
+rulebook claude --model opus    # same, but set the default model to opus (default: sonnet)
+```
+
+It installs the MCP server entry, skills, agent definitions, and the workflows above, then layers an opinionated, cost-aware `.claude/settings.json`:
+
+| Applied | Detail |
+|---------|--------|
+| Hooks | team enforcement, quality gates, session handoff, terse mode |
+| Permissions allowlist | auto-approves safe read-only Bash (`ls`/`cat`/`grep`/`rg`/`find`/`git status\|diff\|log\|blame`/`npm run type-check`/`npm test`) + `mcp__rulebook` — fewer prompts, no loss of safety |
+| `statusLine` | shows project dir + git branch |
+| `model` | cost-aware default (`sonnet`; `opus` stays reserved for the workflow review gates) |
+
+All settings are **additive and non-clobbering**: existing `permissions.allow` entries, a user-authored `statusLine`, and an explicit `model` are preserved. Restart Claude Code after running it to load the new configuration. Requires Claude Code installed (`~/.claude`); otherwise it no-ops with a notice.
+
+---
+
 ## MCP Server
 
 MCP tools exposed via stdio transport. Zero configuration after `rulebook mcp init`.
@@ -172,6 +255,8 @@ rulebook init --light            # No quality enforcement
 rulebook update                  # Update to latest rules
 rulebook doctor                  # Health checks (file sizes, broken imports, stale state)
 rulebook validate                # Check project standards
+rulebook claude                  # Apply recommended Claude Code setup (MCP, agents, workflows, settings)
+rulebook claude --model opus     # Same, overriding the default model (default: sonnet)
 ```
 
 ### Task Management
@@ -294,6 +379,7 @@ All config lives in `.rulebook/rulebook.json`:
 
 Full documentation in [`/docs`](docs/):
 
+- [Usage Examples](docs/usage-examples.md) — end-to-end flows for every workflow
 - [Getting Started](docs/guides/GETTING_STARTED.md)
 - [Best Practices](docs/guides/BEST_PRACTICES.md)
 - [CLI Agents](docs/CLI_AGENTS.md)

package/dist/cli/commands/claude.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `rulebook claude` — apply the recommended Claude Code setup for this project.
+ *
+ * Idempotent and non-interactive: installs MCP + skills + agents + workflows
+ * via setupClaudeCodeIntegration, then layers the opinionated, quality- and
+ * cost-aware settings (safe permissions allowlist, statusLine, terse default,
+ * default model) onto .claude/settings.json. Prints a summary of what changed.
+ */
+export interface ClaudeSetupOptions {
+    /** Cost-aware default model written to settings.json when none is set. */
+    model?: string;
+}
+/**
+ * `rulebook claude` / `rulebook claude setup`.
+ */
+export declare function claudeSetupCommand(options?: ClaudeSetupOptions): Promise<void>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/cli/commands/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDxF"}

package/dist/cli/commands/claude.js

@@ -0,0 +1,56 @@
+/**
+ * `rulebook claude` — apply the recommended Claude Code setup for this project.
+ *
+ * Idempotent and non-interactive: installs MCP + skills + agents + workflows
+ * via setupClaudeCodeIntegration, then layers the opinionated, quality- and
+ * cost-aware settings (safe permissions allowlist, statusLine, terse default,
+ * default model) onto .claude/settings.json. Prints a summary of what changed.
+ */
+import chalk from 'chalk';
+import { setupClaudeCodeIntegration } from '../../core/claude/claude-mcp.js';
+import { applyClaudeSettings } from '../../core/claude/claude-settings-manager.js';
+/**
+ * `rulebook claude` / `rulebook claude setup`.
+ */
+export async function claudeSetupCommand(options = {}) {
+    const cwd = process.cwd();
+    const defaultModel = options.model ?? 'sonnet';
+    try {
+        const result = await setupClaudeCodeIntegration(cwd);
+        if (!result.detected) {
+            console.log(chalk.yellow('⚠ Claude Code not detected (no ~/.claude). Nothing applied.'));
+            console.log(chalk.gray('  Install Claude Code, then re-run "rulebook claude".'));
+            return;
+        }
+        await applyClaudeSettings(cwd, {
+            teamEnforcement: true,
+            sessionHandoff: true,
+            qualityEnforcement: true,
+            terseMode: true,
+            permissionsAllowlist: true,
+            statusLine: true,
+            defaultModel,
+            updateCheck: true,
+        });
+        console.log(chalk.green('\n✅ Claude Code setup applied'));
+        if (result.mcpConfigured)
+            console.log(chalk.gray('  • MCP server configured in .mcp.json'));
+        if (result.skillsInstalled.length)
+            console.log(chalk.gray(`  • ${result.skillsInstalled.length} skills → .claude/commands/`));
+        if (result.devSkillsInstalled.length)
+            console.log(chalk.gray(`  • ${result.devSkillsInstalled.length} dev skills → .claude/skills/`));
+        if (result.agentDefinitionsInstalled.length)
+            console.log(chalk.gray(`  • ${result.agentDefinitionsInstalled.length} agents → .claude/agents/`));
+        if (result.workflowDefinitionsInstalled.length)
+            console.log(chalk.gray(`  • ${result.workflowDefinitionsInstalled.length} workflows → .claude/workflows/`));
+        console.log(chalk.gray('  • settings.json: hooks, safe permissions allowlist, statusLine'));
+        console.log(chalk.gray(`  • settings.json: default model "${defaultModel}", terse mode on`));
+        console.log(chalk.gray('\nRestart Claude Code to load the updated configuration.'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red(`\n❌ Failed to apply Claude Code setup: ${message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/cli/commands/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/cli/commands/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAOnF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAA8B,EAAE;IACvE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,CAAC;QAErD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAC5E,CAAC;YACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CACpE,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,mBAAmB,CAAC,GAAG,EAAE;YAC7B,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,IAAI;YACxB,SAAS,EAAE,IAAI;YACf,oBAAoB,EAAE,IAAI;YAC1B,UAAU,EAAE,IAAI;YAChB,YAAY;YACZ,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,aAAa;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAC5F,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,6BAA6B,CAAC,CAAC,CAAC;QAC7F,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,kBAAkB,CAAC,MAAM,+BAA+B,CAAC,CAAC,CAAC;QAClG,IAAI,MAAM,CAAC,yBAAyB,CAAC,MAAM;YACzC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,yBAAyB,CAAC,MAAM,2BAA2B,CAAC,CACtF,CAAC;QACJ,IAAI,MAAM,CAAC,4BAA4B,CAAC,MAAM;YAC5C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,OAAO,MAAM,CAAC,4BAA4B,CAAC,MAAM,iCAAiC,CACnF,CACF,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;QAC5F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,YAAY,kBAAkB,CAAC,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwoBhB"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiqBhB"}

package/dist/cli/commands/init.js

@@ -94,8 +94,21 @@ export async function initCommand(options) {
         const cliMinimal = Boolean(options.minimal);
         const cliLight = Boolean(options.light);
         const cliLean = Boolean(options.lean);
+        // Language + library selection. Interactive terminals (and not --yes) get a
+        // confirm/edit prompt — which also lets an empty project select manually.
+        // Non-interactive runs (--yes, CI, piped stdin) fall back to detection results.
+        let selectedLanguages = detection.languages.map((l) => l.language);
+        let selectedLibraries = detection.libraries.map((l) => l.library);
+        const interactive = !options.yes && Boolean(process.stdin.isTTY);
+        if (interactive) {
+            const { promptLanguagesAndLibraries } = await import('../prompts.js');
+            const picked = await promptLanguagesAndLibraries(detection);
+            selectedLanguages = picked.languages;
+            selectedLibraries = picked.libraries;
+        }
         const config = {
-            languages: detection.languages.map((l) => l.language),
+            languages: selectedLanguages,
+            libraries: selectedLibraries,
             modules: cliMinimal ? [] : detection.modules.filter((m) => m.detected).map((m) => m.module),
             ides: cliMinimal ? [] : ['cursor'],
             projectType: 'application',
@@ -444,7 +457,7 @@ export async function initCommand(options) {
             const rulesSpinner = ora('Generating path-scoped .claude/rules/ for detected languages...').start();
             try {
                 const { generateRules } = await import('../../core/generators/rules-generator.js');
-                const rulesResult = await generateRules(cwd, { languages: detection.languages });
+                const rulesResult = await generateRules(cwd, { languages: detection.languages }, config.libraries ?? []);
                 if (rulesResult.written.length > 0) {
                     rulesSpinner.succeed(`Generated ${rulesResult.written.length} language rule file(s) in .claude/rules/`);
                     for (const f of rulesResult.written) {
@@ -492,6 +505,9 @@ export async function initCommand(options) {
                     if (result.agentDefinitionsInstalled.length > 0) {
                         console.log(chalk.gray(`  • ${result.agentDefinitionsInstalled.length} agent definitions installed to .claude/agents/`));
                     }
+                    if (result.workflowDefinitionsInstalled.length > 0) {
+                        console.log(chalk.gray(`  • ${result.workflowDefinitionsInstalled.length} workflows installed to .claude/workflows/`));
+                    }
                 }
                 else {
                     claudeIntSpinner.info('Claude Code not detected (skipped)');