@hivehub/rulebook 3.2.1 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/.claude/commands/rulebook-task-apply.md +2 -2
  2. package/.claude/commands/rulebook-task-archive.md +3 -3
  3. package/.claude/commands/rulebook-task-create.md +4 -4
  4. package/.claude/commands/rulebook-task-list.md +2 -2
  5. package/.claude/commands/rulebook-task-show.md +2 -2
  6. package/.claude/commands/rulebook-task-validate.md +2 -2
  7. package/.claude-plugin/marketplace.json +1 -1
  8. package/.claude-plugin/plugin.json +1 -1
  9. package/README.md +8 -8
  10. package/dist/cli/commands.d.ts.map +1 -1
  11. package/dist/cli/commands.js +328 -33
  12. package/dist/cli/commands.js.map +1 -1
  13. package/dist/core/config-manager.d.ts +10 -0
  14. package/dist/core/config-manager.d.ts.map +1 -1
  15. package/dist/core/config-manager.js +105 -0
  16. package/dist/core/config-manager.js.map +1 -1
  17. package/dist/core/generator.js +38 -38
  18. package/dist/core/generator.js.map +1 -1
  19. package/dist/core/migrator.d.ts.map +1 -1
  20. package/dist/core/migrator.js +3 -3
  21. package/dist/core/migrator.js.map +1 -1
  22. package/dist/core/openspec-manager.d.ts +2 -2
  23. package/dist/core/openspec-manager.d.ts.map +1 -1
  24. package/dist/core/openspec-manager.js +5 -14
  25. package/dist/core/openspec-manager.js.map +1 -1
  26. package/dist/core/openspec-migrator.d.ts.map +1 -1
  27. package/dist/core/openspec-migrator.js +3 -3
  28. package/dist/core/openspec-migrator.js.map +1 -1
  29. package/dist/core/prd-generator.d.ts.map +1 -1
  30. package/dist/core/prd-generator.js +2 -1
  31. package/dist/core/prd-generator.js.map +1 -1
  32. package/dist/core/ralph-manager.d.ts +9 -1
  33. package/dist/core/ralph-manager.d.ts.map +1 -1
  34. package/dist/core/ralph-manager.js +56 -2
  35. package/dist/core/ralph-manager.js.map +1 -1
  36. package/dist/core/task-manager.d.ts.map +1 -1
  37. package/dist/core/task-manager.js +26 -26
  38. package/dist/core/task-manager.js.map +1 -1
  39. package/dist/core/validator.js +6 -6
  40. package/dist/core/validator.js.map +1 -1
  41. package/dist/mcp/rulebook-server.d.ts.map +1 -1
  42. package/dist/mcp/rulebook-server.js +131 -20
  43. package/dist/mcp/rulebook-server.js.map +1 -1
  44. package/dist/types.d.ts +1 -0
  45. package/dist/types.d.ts.map +1 -1
  46. package/package.json +1 -1
  47. package/templates/commands/rulebook-task-apply.md +2 -2
  48. package/templates/commands/rulebook-task-archive.md +3 -3
  49. package/templates/commands/rulebook-task-create.md +4 -4
  50. package/templates/commands/rulebook-task-list.md +2 -2
  51. package/templates/commands/rulebook-task-show.md +2 -2
  52. package/templates/commands/rulebook-task-validate.md +2 -2
  53. package/templates/core/RALPH.md +2 -2
  54. package/templates/core/RULEBOOK.md +13 -13
  55. package/templates/git/CI_CD_PATTERNS.md +4 -4
  56. package/templates/git/GITHUB_ACTIONS.md +3 -3
  57. package/templates/git/GITLAB_CI.md +4 -4
  58. package/templates/git/SECRETS_MANAGEMENT.md +4 -4
  59. package/templates/hooks/COMMIT_MSG.md +4 -4
  60. package/templates/hooks/POST_CHECKOUT.md +3 -3
  61. package/templates/hooks/PREPARE_COMMIT_MSG.md +3 -3
  62. package/templates/hooks/PRE_COMMIT.md +4 -4
  63. package/templates/hooks/PRE_PUSH.md +4 -4
  64. package/templates/skills/cli/aider/SKILL.md +10 -10
  65. package/templates/skills/cli/amazon-q/SKILL.md +10 -10
  66. package/templates/skills/cli/auggie/SKILL.md +10 -10
  67. package/templates/skills/cli/claude/SKILL.md +10 -10
  68. package/templates/skills/cli/claude-code/SKILL.md +146 -146
  69. package/templates/skills/cli/cline/SKILL.md +10 -10
  70. package/templates/skills/cli/codebuddy/SKILL.md +10 -10
  71. package/templates/skills/cli/codeium/SKILL.md +10 -10
  72. package/templates/skills/cli/codex/SKILL.md +10 -10
  73. package/templates/skills/cli/continue/SKILL.md +10 -10
  74. package/templates/skills/cli/cursor-cli/SKILL.md +10 -10
  75. package/templates/skills/cli/factory/SKILL.md +10 -10
  76. package/templates/skills/cli/gemini/SKILL.md +10 -10
  77. package/templates/skills/cli/kilocode/SKILL.md +10 -10
  78. package/templates/skills/cli/opencode/SKILL.md +10 -10
  79. package/templates/skills/core/agent-automation/SKILL.md +10 -10
  80. package/templates/skills/core/dag/SKILL.md +10 -10
  81. package/templates/skills/core/documentation-rules/SKILL.md +10 -10
  82. package/templates/skills/core/quality-enforcement/SKILL.md +10 -10
  83. package/templates/skills/core/rulebook/SKILL.md +1 -1
  84. package/templates/skills/frameworks/angular/SKILL.md +10 -10
  85. package/templates/skills/frameworks/django/SKILL.md +10 -10
  86. package/templates/skills/frameworks/electron/SKILL.md +10 -10
  87. package/templates/skills/frameworks/flask/SKILL.md +10 -10
  88. package/templates/skills/frameworks/flutter/SKILL.md +10 -10
  89. package/templates/skills/frameworks/jquery/SKILL.md +10 -10
  90. package/templates/skills/frameworks/laravel/SKILL.md +10 -10
  91. package/templates/skills/frameworks/nestjs/SKILL.md +10 -10
  92. package/templates/skills/frameworks/nextjs/SKILL.md +10 -10
  93. package/templates/skills/frameworks/nuxt/SKILL.md +10 -10
  94. package/templates/skills/frameworks/rails/SKILL.md +10 -10
  95. package/templates/skills/frameworks/react/SKILL.md +10 -10
  96. package/templates/skills/frameworks/react-native/SKILL.md +10 -10
  97. package/templates/skills/frameworks/spring/SKILL.md +10 -10
  98. package/templates/skills/frameworks/symfony/SKILL.md +10 -10
  99. package/templates/skills/frameworks/vue/SKILL.md +10 -10
  100. package/templates/skills/frameworks/zend/SKILL.md +10 -10
  101. package/templates/skills/ides/copilot/SKILL.md +10 -10
  102. package/templates/skills/ides/cursor/SKILL.md +10 -10
  103. package/templates/skills/ides/jetbrains-ai/SKILL.md +10 -10
  104. package/templates/skills/ides/replit/SKILL.md +10 -10
  105. package/templates/skills/ides/tabnine/SKILL.md +10 -10
  106. package/templates/skills/ides/vscode/SKILL.md +10 -10
  107. package/templates/skills/ides/windsurf/SKILL.md +10 -10
  108. package/templates/skills/ides/zed/SKILL.md +10 -10
  109. package/templates/skills/languages/ada/SKILL.md +68 -68
  110. package/templates/skills/languages/c/SKILL.md +10 -10
  111. package/templates/skills/languages/cpp/SKILL.md +10 -10
  112. package/templates/skills/languages/csharp/SKILL.md +10 -10
  113. package/templates/skills/languages/dart/SKILL.md +342 -342
  114. package/templates/skills/languages/elixir/SKILL.md +10 -10
  115. package/templates/skills/languages/erlang/SKILL.md +10 -10
  116. package/templates/skills/languages/go/SKILL.md +10 -10
  117. package/templates/skills/languages/haskell/SKILL.md +10 -10
  118. package/templates/skills/languages/java/SKILL.md +10 -10
  119. package/templates/skills/languages/javascript/SKILL.md +10 -10
  120. package/templates/skills/languages/julia/SKILL.md +10 -10
  121. package/templates/skills/languages/kotlin/SKILL.md +10 -10
  122. package/templates/skills/languages/lisp/SKILL.md +10 -10
  123. package/templates/skills/languages/lua/SKILL.md +10 -10
  124. package/templates/skills/languages/objectivec/SKILL.md +10 -10
  125. package/templates/skills/languages/php/SKILL.md +10 -10
  126. package/templates/skills/languages/python/SKILL.md +10 -10
  127. package/templates/skills/languages/r/SKILL.md +360 -360
  128. package/templates/skills/languages/ruby/SKILL.md +10 -10
  129. package/templates/skills/languages/rust/SKILL.md +10 -10
  130. package/templates/skills/languages/sas/SKILL.md +10 -10
  131. package/templates/skills/languages/scala/SKILL.md +10 -10
  132. package/templates/skills/languages/solidity/SKILL.md +10 -10
  133. package/templates/skills/languages/sql/SKILL.md +10 -10
  134. package/templates/skills/languages/swift/SKILL.md +10 -10
  135. package/templates/skills/languages/zig/SKILL.md +10 -10
  136. package/templates/skills/modules/atlassian/SKILL.md +10 -10
  137. package/templates/skills/modules/context7/SKILL.md +10 -10
  138. package/templates/skills/modules/figma/SKILL.md +10 -10
  139. package/templates/skills/modules/github-mcp/SKILL.md +10 -10
  140. package/templates/skills/modules/grafana/SKILL.md +10 -10
  141. package/templates/skills/modules/memory/SKILL.md +10 -10
  142. package/templates/skills/modules/notion/SKILL.md +10 -10
  143. package/templates/skills/modules/playwright/SKILL.md +10 -10
  144. package/templates/skills/modules/rulebook-mcp/SKILL.md +10 -10
  145. package/templates/skills/modules/serena/SKILL.md +10 -10
  146. package/templates/skills/modules/supabase/SKILL.md +10 -10
  147. package/templates/skills/modules/synap/SKILL.md +10 -10
  148. package/templates/skills/modules/vectorizer/SKILL.md +10 -10
  149. package/templates/skills/services/azure-blob/SKILL.md +10 -10
  150. package/templates/skills/services/cassandra/SKILL.md +10 -10
  151. package/templates/skills/services/dynamodb/SKILL.md +10 -10
  152. package/templates/skills/services/elasticsearch/SKILL.md +10 -10
  153. package/templates/skills/services/gcs/SKILL.md +10 -10
  154. package/templates/skills/services/influxdb/SKILL.md +10 -10
  155. package/templates/skills/services/kafka/SKILL.md +10 -10
  156. package/templates/skills/services/mariadb/SKILL.md +10 -10
  157. package/templates/skills/services/memcached/SKILL.md +10 -10
  158. package/templates/skills/services/minio/SKILL.md +10 -10
  159. package/templates/skills/services/mongodb/SKILL.md +10 -10
  160. package/templates/skills/services/mysql/SKILL.md +10 -10
  161. package/templates/skills/services/neo4j/SKILL.md +10 -10
  162. package/templates/skills/services/oracle/SKILL.md +10 -10
  163. package/templates/skills/services/postgresql/SKILL.md +10 -10
  164. package/templates/skills/services/rabbitmq/SKILL.md +10 -10
  165. package/templates/skills/services/redis/SKILL.md +10 -10
  166. package/templates/skills/services/s3/SKILL.md +10 -10
  167. package/templates/skills/services/sqlite/SKILL.md +10 -10
  168. package/templates/skills/services/sqlserver/SKILL.md +10 -10
  169. package/templates/skills/workflows/ralph/SETUP.md +228 -228
  170. package/templates/skills/workflows/ralph/SKILL.md +1 -1
  171. package/templates/skills/workflows/ralph/install.sh +1 -1
@@ -8,7 +8,7 @@ description: Implement an approved Rulebook task and keep tasks checklist in syn
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
12
12
  - **CRITICAL**: Update `tasks.md` IMMEDIATELY after completing and testing each implementation step.
13
13
 
14
14
  **Steps**
@@ -62,6 +62,6 @@ Track these steps as TODOs and complete them one by one.
62
62
  **Reference**
63
63
  - Use `rulebook task show <task-id>` when additional context is required
64
64
  - Use `rulebook task validate <task-id>` to check format before archiving
65
- - See `/rulebook/specs/RULEBOOK.md` for complete task management guidelines and priority order
65
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines and priority order
66
66
  <!-- RULEBOOK:END -->
67
67
 
@@ -8,7 +8,7 @@ description: Archive a completed Rulebook task and apply spec deltas to main spe
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
12
12
 
13
13
  **Steps**
14
14
  1. **Verify Task Completion**:
@@ -46,7 +46,7 @@ description: Archive a completed Rulebook task and apply spec deltas to main spe
46
46
  - Validates task format (unless skipped)
47
47
  - Checks task completion status
48
48
  - Applies spec deltas to main specifications
49
- - Moves task to `/rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
49
+ - Moves task to `/.rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
50
50
  - Updates related specifications
51
51
 
52
52
  6. **Verify Archive**:
@@ -65,6 +65,6 @@ description: Archive a completed Rulebook task and apply spec deltas to main spe
65
65
  **Reference**
66
66
  - Use `rulebook task list --archived` to see archived tasks
67
67
  - Use `rulebook task show <task-id>` to view task details
68
- - See `/rulebook/specs/RULEBOOK.md` for complete task management guidelines
68
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
69
69
  <!-- RULEBOOK:END -->
70
70
 
@@ -8,7 +8,7 @@ description: Create a new Rulebook task following OpenSpec-compatible format wit
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
12
12
  - **CRITICAL**: Context7 MCP is REQUIRED for task creation to ensure correct OpenSpec-compatible format.
13
13
  - Identify any vague or ambiguous details and ask the necessary follow-up questions before editing files.
14
14
 
@@ -30,7 +30,7 @@ description: Create a new Rulebook task following OpenSpec-compatible format wit
30
30
  ```bash
31
31
  rulebook task create <task-id>
32
32
  ```
33
- This creates `/rulebook/tasks/<task-id>/` with:
33
+ This creates `/.rulebook/tasks/<task-id>/` with:
34
34
  - `proposal.md` - Why and what changes
35
35
  - `tasks.md` - Implementation checklist
36
36
  - `specs/` - Directory for spec deltas
@@ -77,10 +77,10 @@ description: Create a new Rulebook task following OpenSpec-compatible format wit
77
77
  - Delta headers: Use ADDED/MODIFIED/REMOVED/RENAMED ✅
78
78
 
79
79
  **Reference**
80
- - See `/rulebook/specs/RULEBOOK.md` for complete task management guidelines
80
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
81
81
  - Use `rulebook task show <task-id>` to view task details
82
82
  - Use `rulebook task list` to see all tasks
83
- - Search existing requirements with `rg -n "Requirement:|Scenario:" rulebook/tasks` before writing new ones
83
+ - Search existing requirements with `rg -n "Requirement:|Scenario:" .rulebook/tasks` before writing new ones
84
84
  - Explore the codebase with `rg <keyword>`, `ls`, or direct file reads so proposals align with current implementation realities
85
85
 
86
86
  **Common Pitfalls to Avoid**
@@ -8,7 +8,7 @@ description: List all Rulebook tasks (active and optionally archived).
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
12
12
 
13
13
  **Steps**
14
14
  1. **List Active Tasks**:
@@ -37,6 +37,6 @@ description: List all Rulebook tasks (active and optionally archived).
37
37
  **Reference**
38
38
  - Use `rulebook task show <task-id>` to view task details
39
39
  - Use `rulebook task validate <task-id>` to check task format
40
- - See `/rulebook/specs/RULEBOOK.md` for complete task management guidelines
40
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
41
41
  <!-- RULEBOOK:END -->
42
42
 
@@ -8,7 +8,7 @@ description: Show detailed information about a specific Rulebook task.
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines.
12
12
 
13
13
  **Steps**
14
14
  1. **Show Task Details**:
@@ -47,6 +47,6 @@ description: Show detailed information about a specific Rulebook task.
47
47
  **Reference**
48
48
  - Use `rulebook task list` to see all tasks
49
49
  - Use `rulebook task validate <task-id>` to check task format
50
- - See `/rulebook/specs/RULEBOOK.md` for complete task management guidelines
50
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
51
51
  <!-- RULEBOOK:END -->
52
52
 
@@ -8,7 +8,7 @@ description: Validate Rulebook task format against OpenSpec-compatible requireme
8
8
  **Guardrails**
9
9
  - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
10
10
  - Keep changes tightly scoped to the requested outcome.
11
- - Refer to `/rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
11
+ - Refer to `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines and format requirements.
12
12
 
13
13
  **Steps**
14
14
  1. **Validate Task Format**:
@@ -46,7 +46,7 @@ description: Validate Rulebook task format against OpenSpec-compatible requireme
46
46
  - ❌ `## New Requirements` → ✅ `## ADDED Requirements`
47
47
 
48
48
  **Reference**
49
- - See `/rulebook/specs/RULEBOOK.md` for complete format requirements
49
+ - See `/.rulebook/specs/RULEBOOK.md` for complete format requirements
50
50
  - Use Context7 MCP to get official OpenSpec format documentation
51
51
  - Use `rulebook task show <task-id>` to view task details
52
52
  <!-- RULEBOOK:END -->
@@ -10,7 +10,7 @@
10
10
  "name": "rulebook",
11
11
  "source": ".",
12
12
  "description": "Standardize AI-generated projects with skills, templates, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
13
- "version": "3.2.1",
13
+ "version": "3.3.0",
14
14
  "repository": "https://github.com/hivellm/rulebook",
15
15
  "homepage": "https://github.com/hivellm/rulebook#readme",
16
16
  "keywords": [
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "rulebook",
3
3
  "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.",
4
- "version": "3.2.1",
4
+ "version": "3.3.0",
5
5
  "author": {
6
6
  "name": "HiveLLM"
7
7
  }
package/README.md CHANGED
@@ -65,7 +65,7 @@ npx @hivehub/rulebook@latest update
65
65
  - 📁 **Consolidated Directory Structure**: Single `.rulebook/` directory for all rulebook data
66
66
  - `memory/` subdirectory for persistent memory system
67
67
  - `ralph/` subdirectory for autonomous loop state and history
68
- - Automatic migration from `.rulebook-memory/` and `.rulebook-ralph/` during `init` and `update`
68
+ - Automatic migration from `rulebook/`, `.rulebook-memory/`, and `.rulebook-ralph/` during `init` and `update`
69
69
  - 📖 **Comprehensive Ralph Documentation**: 450+ lines of guides, examples, and best practices
70
70
  - Complete Ralph usage guide with task sizing guidelines
71
71
  - Configuration reference and MCP integration examples
@@ -189,7 +189,7 @@ npx @hivehub/rulebook@latest update
189
189
  - 🎯 **Built-in Task Management**: OpenSpec deprecated and integrated into Rulebook's native task system
190
190
  - 📋 **RULEBOOK.md Template**: Core template with task management directives and Context7 MCP requirements
191
191
  - 🚫 **Automatic .gitignore**: `npx @hivellm/rulebook@latest init` now creates/updates `.gitignore` automatically for 28 languages
192
- - 🔄 **Migration Support**: Existing OpenSpec tasks automatically migrated to `/rulebook/tasks/` format
192
+ - 🔄 **Migration Support**: Existing OpenSpec tasks automatically migrated to `/.rulebook/tasks/` format
193
193
 
194
194
  > **Breaking Change**: OpenSpec module removed. Use `npx @hivellm/rulebook@latest task` commands instead. See [Migration Guide](docs/guides/OPENSPEC_MIGRATION.md).
195
195
 
@@ -291,7 +291,7 @@ Memory is enabled in `.rulebook`:
291
291
  - 6 CLI commands + 4 MCP tools
292
292
  - 🧠 **Persistent Memory**: Context that survives across AI sessions — hybrid BM25+HNSW search, auto-capture, zero native dependencies
293
293
  - 🔍 **Auto-Detection**: Detects languages, frameworks, MCP modules, and services from your project files
294
- - 📁 **Modular Architecture**: Templates in `/rulebook/` directory — smaller AGENTS.md, on-demand loading
294
+ - 📁 **Modular Architecture**: Templates in `/.rulebook/` directory — smaller AGENTS.md, on-demand loading
295
295
  - 🔗 **Git Hook Automation**: Pre-commit/pre-push hooks with language-aware quality checks
296
296
  - 🔌 **23 MCP Functions**: Task management (7), skills (6), persistent memory (6), Ralph loop (4) via Model Context Protocol
297
297
  - 📝 **106+ Templates**: 28 languages, 17 frameworks, 8 IDEs, 20 services, 15 CLI agents
@@ -305,7 +305,7 @@ Memory is enabled in `.rulebook`:
305
305
  1. Detects your language(s), frameworks, MCP modules, and services
306
306
  2. Asks setup questions (or use `--minimal` for defaults)
307
307
  3. Generates AGENTS.md with AI assistant rules (modular structure)
308
- 4. Creates `/rulebook/` directory with language/framework/module/service templates
308
+ 4. Creates `/.rulebook/` directory with language/framework/module/service templates
309
309
  5. Creates/updates `.gitignore` automatically for detected languages
310
310
  6. Auto-configures Claude Code integration (MCP + skills) if detected
311
311
  7. Optionally installs Git hooks (pre-commit/pre-push)
@@ -316,7 +316,7 @@ Memory is enabled in `.rulebook`:
316
316
  ```bash
317
317
  npx @hivehub/rulebook update
318
318
  ```
319
- - Automatically migrates embedded templates to modular `/rulebook/` structure
319
+ - Automatically migrates embedded templates to modular `/.rulebook/` structure
320
320
  - Automatically migrates OpenSpec tasks to Rulebook format (if OpenSpec exists)
321
321
  - Merges latest templates while preserving your customizations
322
322
  - Updates AGENTS.md with references to modular files
@@ -644,7 +644,7 @@ Each service template provides:
644
644
  - Development and testing integration
645
645
  - Common pitfalls and solutions
646
646
 
647
- Templates are generated in `/rulebook/[SERVICE].md` and referenced in `AGENTS.md` for easy access during development.
647
+ Templates are generated in `/.rulebook/specs/[SERVICE].md` and referenced in `AGENTS.md` for easy access during development.
648
648
 
649
649
  **Server Details:**
650
650
  - **Transport**: stdio only - stdout contains ONLY JSON-RPC 2.0 messages
@@ -660,8 +660,8 @@ The MCP server configuration lives in your `.rulebook` file:
660
660
  {
661
661
  "mcp": {
662
662
  "enabled": true,
663
- "tasksDir": "rulebook/tasks",
664
- "archiveDir": "rulebook/archive"
663
+ "tasksDir": ".rulebook/tasks",
664
+ "archiveDir": ".rulebook/archive"
665
665
  }
666
666
  }
667
667
  ```
@@ -1 +1 @@
1
- {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}