@hivehub/rulebook 3.2.0 → 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 (172) 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 +332 -37
  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 +1 -1
  42. package/dist/mcp/rulebook-server.d.ts.map +1 -1
  43. package/dist/mcp/rulebook-server.js +144 -27
  44. package/dist/mcp/rulebook-server.js.map +1 -1
  45. package/dist/types.d.ts +1 -0
  46. package/dist/types.d.ts.map +1 -1
  47. package/package.json +1 -1
  48. package/templates/commands/rulebook-task-apply.md +2 -2
  49. package/templates/commands/rulebook-task-archive.md +3 -3
  50. package/templates/commands/rulebook-task-create.md +4 -4
  51. package/templates/commands/rulebook-task-list.md +2 -2
  52. package/templates/commands/rulebook-task-show.md +2 -2
  53. package/templates/commands/rulebook-task-validate.md +2 -2
  54. package/templates/core/RALPH.md +2 -2
  55. package/templates/core/RULEBOOK.md +13 -13
  56. package/templates/git/CI_CD_PATTERNS.md +4 -4
  57. package/templates/git/GITHUB_ACTIONS.md +3 -3
  58. package/templates/git/GITLAB_CI.md +4 -4
  59. package/templates/git/SECRETS_MANAGEMENT.md +4 -4
  60. package/templates/hooks/COMMIT_MSG.md +4 -4
  61. package/templates/hooks/POST_CHECKOUT.md +3 -3
  62. package/templates/hooks/PREPARE_COMMIT_MSG.md +3 -3
  63. package/templates/hooks/PRE_COMMIT.md +4 -4
  64. package/templates/hooks/PRE_PUSH.md +4 -4
  65. package/templates/skills/cli/aider/SKILL.md +10 -10
  66. package/templates/skills/cli/amazon-q/SKILL.md +10 -10
  67. package/templates/skills/cli/auggie/SKILL.md +10 -10
  68. package/templates/skills/cli/claude/SKILL.md +10 -10
  69. package/templates/skills/cli/claude-code/SKILL.md +146 -146
  70. package/templates/skills/cli/cline/SKILL.md +10 -10
  71. package/templates/skills/cli/codebuddy/SKILL.md +10 -10
  72. package/templates/skills/cli/codeium/SKILL.md +10 -10
  73. package/templates/skills/cli/codex/SKILL.md +10 -10
  74. package/templates/skills/cli/continue/SKILL.md +10 -10
  75. package/templates/skills/cli/cursor-cli/SKILL.md +10 -10
  76. package/templates/skills/cli/factory/SKILL.md +10 -10
  77. package/templates/skills/cli/gemini/SKILL.md +10 -10
  78. package/templates/skills/cli/kilocode/SKILL.md +10 -10
  79. package/templates/skills/cli/opencode/SKILL.md +10 -10
  80. package/templates/skills/core/agent-automation/SKILL.md +10 -10
  81. package/templates/skills/core/dag/SKILL.md +10 -10
  82. package/templates/skills/core/documentation-rules/SKILL.md +10 -10
  83. package/templates/skills/core/quality-enforcement/SKILL.md +10 -10
  84. package/templates/skills/core/rulebook/SKILL.md +1 -1
  85. package/templates/skills/frameworks/angular/SKILL.md +10 -10
  86. package/templates/skills/frameworks/django/SKILL.md +10 -10
  87. package/templates/skills/frameworks/electron/SKILL.md +10 -10
  88. package/templates/skills/frameworks/flask/SKILL.md +10 -10
  89. package/templates/skills/frameworks/flutter/SKILL.md +10 -10
  90. package/templates/skills/frameworks/jquery/SKILL.md +10 -10
  91. package/templates/skills/frameworks/laravel/SKILL.md +10 -10
  92. package/templates/skills/frameworks/nestjs/SKILL.md +10 -10
  93. package/templates/skills/frameworks/nextjs/SKILL.md +10 -10
  94. package/templates/skills/frameworks/nuxt/SKILL.md +10 -10
  95. package/templates/skills/frameworks/rails/SKILL.md +10 -10
  96. package/templates/skills/frameworks/react/SKILL.md +10 -10
  97. package/templates/skills/frameworks/react-native/SKILL.md +10 -10
  98. package/templates/skills/frameworks/spring/SKILL.md +10 -10
  99. package/templates/skills/frameworks/symfony/SKILL.md +10 -10
  100. package/templates/skills/frameworks/vue/SKILL.md +10 -10
  101. package/templates/skills/frameworks/zend/SKILL.md +10 -10
  102. package/templates/skills/ides/copilot/SKILL.md +10 -10
  103. package/templates/skills/ides/cursor/SKILL.md +10 -10
  104. package/templates/skills/ides/jetbrains-ai/SKILL.md +10 -10
  105. package/templates/skills/ides/replit/SKILL.md +10 -10
  106. package/templates/skills/ides/tabnine/SKILL.md +10 -10
  107. package/templates/skills/ides/vscode/SKILL.md +10 -10
  108. package/templates/skills/ides/windsurf/SKILL.md +10 -10
  109. package/templates/skills/ides/zed/SKILL.md +10 -10
  110. package/templates/skills/languages/ada/SKILL.md +68 -68
  111. package/templates/skills/languages/c/SKILL.md +10 -10
  112. package/templates/skills/languages/cpp/SKILL.md +10 -10
  113. package/templates/skills/languages/csharp/SKILL.md +10 -10
  114. package/templates/skills/languages/dart/SKILL.md +342 -342
  115. package/templates/skills/languages/elixir/SKILL.md +10 -10
  116. package/templates/skills/languages/erlang/SKILL.md +10 -10
  117. package/templates/skills/languages/go/SKILL.md +10 -10
  118. package/templates/skills/languages/haskell/SKILL.md +10 -10
  119. package/templates/skills/languages/java/SKILL.md +10 -10
  120. package/templates/skills/languages/javascript/SKILL.md +10 -10
  121. package/templates/skills/languages/julia/SKILL.md +10 -10
  122. package/templates/skills/languages/kotlin/SKILL.md +10 -10
  123. package/templates/skills/languages/lisp/SKILL.md +10 -10
  124. package/templates/skills/languages/lua/SKILL.md +10 -10
  125. package/templates/skills/languages/objectivec/SKILL.md +10 -10
  126. package/templates/skills/languages/php/SKILL.md +10 -10
  127. package/templates/skills/languages/python/SKILL.md +10 -10
  128. package/templates/skills/languages/r/SKILL.md +360 -360
  129. package/templates/skills/languages/ruby/SKILL.md +10 -10
  130. package/templates/skills/languages/rust/SKILL.md +10 -10
  131. package/templates/skills/languages/sas/SKILL.md +10 -10
  132. package/templates/skills/languages/scala/SKILL.md +10 -10
  133. package/templates/skills/languages/solidity/SKILL.md +10 -10
  134. package/templates/skills/languages/sql/SKILL.md +10 -10
  135. package/templates/skills/languages/swift/SKILL.md +10 -10
  136. package/templates/skills/languages/zig/SKILL.md +10 -10
  137. package/templates/skills/modules/atlassian/SKILL.md +10 -10
  138. package/templates/skills/modules/context7/SKILL.md +10 -10
  139. package/templates/skills/modules/figma/SKILL.md +10 -10
  140. package/templates/skills/modules/github-mcp/SKILL.md +10 -10
  141. package/templates/skills/modules/grafana/SKILL.md +10 -10
  142. package/templates/skills/modules/memory/SKILL.md +10 -10
  143. package/templates/skills/modules/notion/SKILL.md +10 -10
  144. package/templates/skills/modules/playwright/SKILL.md +10 -10
  145. package/templates/skills/modules/rulebook-mcp/SKILL.md +10 -10
  146. package/templates/skills/modules/serena/SKILL.md +10 -10
  147. package/templates/skills/modules/supabase/SKILL.md +10 -10
  148. package/templates/skills/modules/synap/SKILL.md +10 -10
  149. package/templates/skills/modules/vectorizer/SKILL.md +10 -10
  150. package/templates/skills/services/azure-blob/SKILL.md +10 -10
  151. package/templates/skills/services/cassandra/SKILL.md +10 -10
  152. package/templates/skills/services/dynamodb/SKILL.md +10 -10
  153. package/templates/skills/services/elasticsearch/SKILL.md +10 -10
  154. package/templates/skills/services/gcs/SKILL.md +10 -10
  155. package/templates/skills/services/influxdb/SKILL.md +10 -10
  156. package/templates/skills/services/kafka/SKILL.md +10 -10
  157. package/templates/skills/services/mariadb/SKILL.md +10 -10
  158. package/templates/skills/services/memcached/SKILL.md +10 -10
  159. package/templates/skills/services/minio/SKILL.md +10 -10
  160. package/templates/skills/services/mongodb/SKILL.md +10 -10
  161. package/templates/skills/services/mysql/SKILL.md +10 -10
  162. package/templates/skills/services/neo4j/SKILL.md +10 -10
  163. package/templates/skills/services/oracle/SKILL.md +10 -10
  164. package/templates/skills/services/postgresql/SKILL.md +10 -10
  165. package/templates/skills/services/rabbitmq/SKILL.md +10 -10
  166. package/templates/skills/services/redis/SKILL.md +10 -10
  167. package/templates/skills/services/s3/SKILL.md +10 -10
  168. package/templates/skills/services/sqlite/SKILL.md +10 -10
  169. package/templates/skills/services/sqlserver/SKILL.md +10 -10
  170. package/templates/skills/workflows/ralph/SETUP.md +228 -228
  171. package/templates/skills/workflows/ralph/SKILL.md +1 -1
  172. package/templates/skills/workflows/ralph/install.sh +1 -1
@@ -152,7 +152,7 @@ rulebook task show <task-id>
152
152
  rulebook task create <task-id>
153
153
 
154
154
  # This creates:
155
- # /rulebook/tasks/<task-id>/
155
+ # /.rulebook/tasks/<task-id>/
156
156
  # ├── proposal.md # Why and what changes
157
157
  # ├── tasks.md # Implementation checklist
158
158
  # ├── design.md # Technical decisions (optional)
@@ -163,7 +163,7 @@ rulebook task create <task-id>
163
163
 
164
164
  ### Step 5: Write Proposal
165
165
 
166
- **File**: `/rulebook/tasks/<task-id>/proposal.md`
166
+ **File**: `/.rulebook/tasks/<task-id>/proposal.md`
167
167
 
168
168
  ```markdown
169
169
  # Proposal: Task Name
@@ -188,7 +188,7 @@ Detailed description of what will change:
188
188
 
189
189
  ### Step 6: Write Tasks Checklist
190
190
 
191
- **File**: `/rulebook/tasks/<task-id>/tasks.md`
191
+ **File**: `/.rulebook/tasks/<task-id>/tasks.md`
192
192
 
193
193
  ```markdown
194
194
  ## 1. Implementation Phase
@@ -206,7 +206,7 @@ Detailed description of what will change:
206
206
 
207
207
  ### Step 7: Write Spec Delta
208
208
 
209
- **File**: `/rulebook/tasks/<task-id>/specs/<module>/spec.md`
209
+ **File**: `/.rulebook/tasks/<task-id>/specs/<module>/spec.md`
210
210
 
211
211
  **CRITICAL FORMAT REQUIREMENTS:**
212
212
 
@@ -301,7 +301,7 @@ rulebook task archive <task-id> --yes
301
301
  1. Validates task format
302
302
  2. Checks task completion status
303
303
  3. Applies spec deltas to main specifications
304
- 4. Moves task to `/rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
304
+ 4. Moves task to `/.rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
305
305
  5. Updates related specifications
306
306
 
307
307
  ## Task Format Examples
@@ -1088,12 +1088,12 @@ rulebook task list --archived
1088
1088
 
1089
1089
  **Archived tasks are moved to:**
1090
1090
  ```
1091
- /rulebook/tasks/archive/YYYY-MM-DD-<task-id>/
1091
+ /.rulebook/tasks/archive/YYYY-MM-DD-<task-id>/
1092
1092
  ```
1093
1093
 
1094
1094
  **Structure:**
1095
1095
  ```
1096
- /rulebook/tasks/archive/2025-11-13-add-auth/
1096
+ /.rulebook/tasks/archive/2025-11-13-add-auth/
1097
1097
  ├── proposal.md
1098
1098
  ├── tasks.md # All items marked [x]
1099
1099
  ├── design.md
@@ -1338,7 +1338,7 @@ rulebook task create add-user-authentication
1338
1338
  ```
1339
1339
 
1340
1340
  **What it does:**
1341
- - Creates `/rulebook/tasks/<task-id>/` directory
1341
+ - Creates `/.rulebook/tasks/<task-id>/` directory
1342
1342
  - Generates `proposal.md` template
1343
1343
  - Generates `tasks.md` template
1344
1344
  - Creates `specs/` directory for spec deltas
@@ -1351,7 +1351,7 @@ rulebook task create add-user-authentication
1351
1351
  ```bash
1352
1352
  $ rulebook task create add-email-notifications
1353
1353
  ✅ Task add-email-notifications created successfully
1354
- Location: rulebook/tasks/add-email-notifications/
1354
+ Location: .rulebook/tasks/add-email-notifications/
1355
1355
 
1356
1356
  ⚠️ Remember to:
1357
1357
  1. Check Context7 MCP for OpenSpec format requirements
@@ -1515,7 +1515,7 @@ rulebook task archive add-user-authentication --skip-validation
1515
1515
  1. Validates task format (unless `--skip-validation` is used)
1516
1516
  2. Checks task completion status
1517
1517
  3. Applies spec deltas to main specifications
1518
- 4. Moves task to `/rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
1518
+ 4. Moves task to `/.rulebook/tasks/archive/YYYY-MM-DD-<task-id>/`
1519
1519
  5. Updates related specifications
1520
1520
 
1521
1521
  **Example:**
@@ -1800,7 +1800,7 @@ rulebook config --feature agent --disable
1800
1800
  If your project previously used OpenSpec:
1801
1801
 
1802
1802
  1. **Automatic Migration**: Run `rulebook update` to automatically migrate OpenSpec tasks to Rulebook format
1803
- 2. **Manual Migration**: Tasks in `/openspec/changes/` will be moved to `/rulebook/tasks/`
1803
+ 2. **Manual Migration**: Tasks in `/openspec/changes/` will be moved to `/.rulebook/tasks/`
1804
1804
  3. **Format Compatibility**: Rulebook uses OpenSpec-compatible format, so existing tasks remain valid
1805
1805
 
1806
1806
  ## Context7 MCP Requirement
@@ -1872,7 +1872,7 @@ If your project previously used OpenSpec:
1872
1872
 
1873
1873
  **Error**: "No tasks found"
1874
1874
  - **Fix**: Create a task first with `rulebook task create <task-id>`
1875
- - **Check**: Verify `/rulebook/tasks/` directory exists
1875
+ - **Check**: Verify `/.rulebook/tasks/` directory exists
1876
1876
 
1877
1877
  ### Migration Errors
1878
1878
 
@@ -1887,7 +1887,7 @@ If your project previously used OpenSpec:
1887
1887
 
1888
1888
  ## Examples
1889
1889
 
1890
- See `/rulebook/tasks/` directory for examples of correctly formatted tasks.
1890
+ See `/.rulebook/tasks/` directory for examples of correctly formatted tasks.
1891
1891
 
1892
1892
  <!-- RULEBOOK:END -->
1893
1893
 
@@ -655,7 +655,7 @@ npx @hivehub/rulebook workflows
655
655
 
656
656
  ## Related Templates
657
657
 
658
- - See `/rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions specifics
659
- - See `/rulebook/specs/GITLAB_CI.md` for GitLab CI specifics
660
- - See `/rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
661
- - See `/rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
658
+ - See `/.rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions specifics
659
+ - See `/.rulebook/specs/GITLAB_CI.md` for GitLab CI specifics
660
+ - See `/.rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
661
+ - See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
@@ -722,7 +722,7 @@ npx @hivehub/rulebook workflows
722
722
 
723
723
  ## Related Templates
724
724
 
725
- - See `/rulebook/specs/CI_CD_PATTERNS.md` for common CI/CD patterns
726
- - See `/rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
727
- - See `/rulebook/specs/QUALITY_ENFORCEMENT.md` for quality gates
725
+ - See `/.rulebook/specs/CI_CD_PATTERNS.md` for common CI/CD patterns
726
+ - See `/.rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
727
+ - See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality gates
728
728
  - See language-specific templates for test/build commands
@@ -724,7 +724,7 @@ npx @hivehub/rulebook workflows
724
724
 
725
725
  ## Related Templates
726
726
 
727
- - See `/rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions comparison
728
- - See `/rulebook/specs/CI_CD_PATTERNS.md` for general CI/CD patterns
729
- - See `/rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
730
- - See `/rulebook/specs/QUALITY_ENFORCEMENT.md` for quality gates
727
+ - See `/.rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions comparison
728
+ - See `/.rulebook/specs/CI_CD_PATTERNS.md` for general CI/CD patterns
729
+ - See `/.rulebook/specs/SECRETS_MANAGEMENT.md` for secrets handling
730
+ - See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality gates
@@ -579,7 +579,7 @@ AWS_SECRET_ACCESS_KEY=your-secret-key
579
579
 
580
580
  ## Related Templates
581
581
 
582
- - See `/rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions secrets
583
- - See `/rulebook/specs/GITLAB_CI.md` for GitLab CI secrets
584
- - See `/rulebook/specs/CI_CD_PATTERNS.md` for deployment patterns
585
- - See `/rulebook/specs/GIT.md` for .gitignore patterns
582
+ - See `/.rulebook/specs/GITHUB_ACTIONS.md` for GitHub Actions secrets
583
+ - See `/.rulebook/specs/GITLAB_CI.md` for GitLab CI secrets
584
+ - See `/.rulebook/specs/CI_CD_PATTERNS.md` for deployment patterns
585
+ - See `/.rulebook/specs/GIT.md` for .gitignore patterns
@@ -524,7 +524,7 @@ npx @hivehub/rulebook init
524
524
 
525
525
  ## Related Templates
526
526
 
527
- - See `/rulebook/specs/PRE_COMMIT.md` for quality checks before commit
528
- - See `/rulebook/specs/PREPARE_COMMIT_MSG.md` for auto-generating commit messages
529
- - See `/rulebook/specs/GIT.md` for git workflow and commit conventions
530
- - See `/rulebook/specs/DOCUMENTATION_RULES.md` for changelog generation from commits
527
+ - See `/.rulebook/specs/PRE_COMMIT.md` for quality checks before commit
528
+ - See `/.rulebook/specs/PREPARE_COMMIT_MSG.md` for auto-generating commit messages
529
+ - See `/.rulebook/specs/GIT.md` for git workflow and commit conventions
530
+ - See `/.rulebook/specs/DOCUMENTATION_RULES.md` for changelog generation from commits
@@ -540,7 +540,7 @@ npx @hivehub/rulebook init
540
540
 
541
541
  ## Related Templates
542
542
 
543
- - See `/rulebook/specs/PRE_COMMIT.md` for pre-commit quality checks
544
- - See `/rulebook/specs/PRE_PUSH.md` for pre-push validation
545
- - See `/rulebook/specs/GIT.md` for git workflow
543
+ - See `/.rulebook/specs/PRE_COMMIT.md` for pre-commit quality checks
544
+ - See `/.rulebook/specs/PRE_PUSH.md` for pre-push validation
545
+ - See `/.rulebook/specs/GIT.md` for git workflow
546
546
  - See language-specific templates for dependency management commands
@@ -614,6 +614,6 @@ npx @hivehub/rulebook init
614
614
 
615
615
  ## Related Templates
616
616
 
617
- - See `/rulebook/specs/COMMIT_MSG.md` for commit message validation
618
- - See `/rulebook/specs/GIT.md` for git workflow and branch naming
619
- - See `/rulebook/specs/PRE_COMMIT.md` for pre-commit checks
617
+ - See `/.rulebook/specs/COMMIT_MSG.md` for commit message validation
618
+ - See `/.rulebook/specs/GIT.md` for git workflow and branch naming
619
+ - See `/.rulebook/specs/PRE_COMMIT.md` for pre-commit checks
@@ -407,8 +407,8 @@ Hook configuration in `.rulebook`:
407
407
 
408
408
  ## Related Templates
409
409
 
410
- - See `/rulebook/specs/PRE_PUSH.md` for build and test checks before push
411
- - See `/rulebook/specs/COMMIT_MSG.md` for commit message validation
412
- - See `/rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
413
- - See `/rulebook/specs/GIT.md` for git workflow and commit conventions
410
+ - See `/.rulebook/specs/PRE_PUSH.md` for build and test checks before push
411
+ - See `/.rulebook/specs/COMMIT_MSG.md` for commit message validation
412
+ - See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
413
+ - See `/.rulebook/specs/GIT.md` for git workflow and commit conventions
414
414
  - See language-specific templates for language-specific quality commands
@@ -594,8 +594,8 @@ Hook configuration in `.rulebook`:
594
594
 
595
595
  ## Related Templates
596
596
 
597
- - See `/rulebook/specs/PRE_COMMIT.md` for fast quality checks before commit
598
- - See `/rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
599
- - See `/rulebook/specs/GIT.md` for git workflow and conventions
600
- - See `/rulebook/specs/GITHUB_ACTIONS.md` for CI/CD integration
597
+ - See `/.rulebook/specs/PRE_COMMIT.md` for fast quality checks before commit
598
+ - See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality standards
599
+ - See `/.rulebook/specs/GIT.md` for git workflow and conventions
600
+ - See `/.rulebook/specs/GITHUB_ACTIONS.md` for CI/CD integration
601
601
  - See language-specific templates for test commands and coverage tools
@@ -1,13 +1,13 @@
1
- ---
2
- name: "Aider"
3
- description: "Tool: AI pair programming in terminal (`pip install aider-chat`)"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
1
+ ---
2
+ name: "Aider"
3
+ description: "Tool: AI pair programming in terminal (`pip install aider-chat`)"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
11
  <!-- AIDER:START -->
12
12
  # Aider CLI Rules
13
13
 
@@ -1,13 +1,13 @@
1
- ---
2
- name: "Amazon Q"
3
- description: "Tool: AWS-focused AI assistant with security scanning"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
1
+ ---
2
+ name: "Amazon Q"
3
+ description: "Tool: AWS-focused AI assistant with security scanning"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
11
  <!-- AMAZON_Q:START -->
12
12
  # Amazon Q Developer Rules
13
13
 
@@ -1,13 +1,13 @@
1
- ---
2
- name: "Auggie"
3
- description: "Tool: TDD mode and intelligent refactoring"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
1
+ ---
2
+ name: "Auggie"
3
+ description: "Tool: TDD mode and intelligent refactoring"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
11
  <!-- AUGGIE:START -->
12
12
  # Auggie (Augment CLI) Rules
13
13
 
@@ -1,13 +1,13 @@
1
- ---
2
- name: "Claude"
3
- description: "Tool: Anthropic Claude API with 200K context window"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
1
+ ---
2
+ name: "Claude"
3
+ description: "Tool: Anthropic Claude API with 200K context window"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
11
  <!-- CLAUDE:START -->
12
12
  # Claude API/CLI Rules
13
13
 
@@ -1,146 +1,146 @@
1
- ---
2
- name: "Claude Code"
3
- description: "Tool: Anthropic Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- CLAUDE_CODE:START -->
12
- # Claude Code CLI Rules
13
-
14
- **Tool**: Anthropic Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
15
-
16
- ## Quick Start
17
-
18
- ```bash
19
- export ANTHROPIC_API_KEY=your_key
20
- claude --model claude-sonnet-4-20250514
21
- ```
22
-
23
- ## Essential Usage
24
-
25
- ```bash
26
- # Always read AGENTS.md and CLAUDE.md first
27
- claude "Read AGENTS.md and CLAUDE.md, then implement [feature] with tests"
28
-
29
- # Key flags:
30
- --model claude-sonnet-4-20250514 # Model selection (default: sonnet)
31
- --dangerously-skip-permissions # Skip permission prompts (use with caution)
32
- --verbose # Debug mode
33
- ```
34
-
35
- ## ⚠️ CRITICAL: File Editing Rules
36
-
37
- **MANDATORY**: When editing multiple files, Claude Code MUST edit files **SEQUENTIALLY**, one at a time.
38
-
39
- ### Why Sequential Editing is Required
40
-
41
- Claude Code's Edit tool uses exact string matching for replacements. When multiple files are edited in parallel:
42
- - The tool may fail to find the exact string in some files
43
- - Race conditions can cause partial or corrupted edits
44
- - Error recovery becomes impossible
45
-
46
- ### Correct File Editing Pattern
47
-
48
- ```
49
- ✅ CORRECT (Sequential):
50
- 1. Edit file A → Wait for confirmation
51
- 2. Edit file B → Wait for confirmation
52
- 3. Edit file C → Wait for confirmation
53
-
54
- ❌ WRONG (Parallel):
55
- 1. Edit files A, B, C simultaneously → Failures likely
56
- ```
57
-
58
- ### Implementation Rules
59
-
60
- 1. **NEVER call multiple Edit tools in parallel** for different files
61
- 2. **ALWAYS wait for each edit to complete** before starting the next
62
- 3. **Verify each edit succeeded** before proceeding
63
- 4. **If an edit fails**, retry that specific edit before moving on
64
-
65
- ## ⚠️ CRITICAL: Test Implementation Rules
66
-
67
- **MANDATORY**: When implementing tests, Claude Code MUST write **complete, production-quality tests**.
68
-
69
- ### Forbidden Test Patterns
70
-
71
- ```typescript
72
- // ❌ NEVER do this - placeholder tests
73
- it('should work', () => {
74
- expect(true).toBe(true);
75
- });
76
-
77
- // ❌ NEVER do this - skipped tests
78
- it.skip('should handle edge case', () => {});
79
-
80
- // ❌ NEVER do this - incomplete assertions
81
- it('should return data', () => {
82
- const result = getData();
83
- expect(result).toBeDefined(); // Too weak!
84
- });
85
-
86
- // ❌ NEVER do this - "simplify" by removing test cases
87
- // Original had 10 test cases, don't reduce to 3
88
- ```
89
-
90
- ### Required Test Patterns
91
-
92
- ```typescript
93
- // ✅ CORRECT - complete test with proper assertions
94
- it('should return user data with correct structure', () => {
95
- const result = getUserById(1);
96
- expect(result).toEqual({
97
- id: 1,
98
- name: 'John Doe',
99
- email: 'john@example.com',
100
- createdAt: expect.any(Date),
101
- });
102
- });
103
-
104
- // ✅ CORRECT - test edge cases and error paths
105
- it('should throw NotFoundError when user does not exist', () => {
106
- expect(() => getUserById(999)).toThrow(NotFoundError);
107
- });
108
-
109
- // ✅ CORRECT - test all branches
110
- describe('validateEmail', () => {
111
- it('should return true for valid email', () => {...});
112
- it('should return false for missing @', () => {...});
113
- it('should return false for missing domain', () => {...});
114
- it('should return false for empty string', () => {...});
115
- });
116
- ```
117
-
118
- ### Test Implementation Rules
119
-
120
- 1. **NEVER simplify tests** - Implement the full, complete test as originally designed
121
- 2. **NEVER skip test cases** - Every test case in the spec must be implemented
122
- 3. **NEVER use placeholder assertions** - Each assertion must verify actual behavior
123
- 4. **ALWAYS test error paths** - Exceptions, edge cases, and failure modes
124
- 5. **ALWAYS maintain coverage** - Tests must achieve the project's coverage threshold
125
-
126
- ## Workflow
127
-
128
- 1. **Always read AGENTS.md and CLAUDE.md first** for project standards
129
- 2. **Plan file changes before editing** - List all files that need modification
130
- 3. **Edit files sequentially** - One file at a time, verify each edit
131
- 4. **Write complete tests** - No placeholders, no simplifications
132
- 5. **Run quality checks**: `npm run lint && npm test`
133
- 6. **Verify coverage threshold** is met before committing
134
-
135
- ## Quality Gates
136
-
137
- Before completing any task:
138
- - [ ] All files edited successfully (sequential editing)
139
- - [ ] All tests implemented completely (no placeholders)
140
- - [ ] Linting passes with zero warnings
141
- - [ ] All tests pass (100% pass rate)
142
- - [ ] Coverage threshold met (check AGENTS.md for threshold)
143
-
144
- **Critical**: Reference AGENTS.md and CLAUDE.md in prompts for consistent code generation.
145
-
146
- <!-- CLAUDE_CODE:END -->
1
+ ---
2
+ name: "Claude Code"
3
+ description: "Tool: Anthropic Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- CLAUDE_CODE:START -->
12
+ # Claude Code CLI Rules
13
+
14
+ **Tool**: Anthropic Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
15
+
16
+ ## Quick Start
17
+
18
+ ```bash
19
+ export ANTHROPIC_API_KEY=your_key
20
+ claude --model claude-sonnet-4-20250514
21
+ ```
22
+
23
+ ## Essential Usage
24
+
25
+ ```bash
26
+ # Always read AGENTS.md and CLAUDE.md first
27
+ claude "Read AGENTS.md and CLAUDE.md, then implement [feature] with tests"
28
+
29
+ # Key flags:
30
+ --model claude-sonnet-4-20250514 # Model selection (default: sonnet)
31
+ --dangerously-skip-permissions # Skip permission prompts (use with caution)
32
+ --verbose # Debug mode
33
+ ```
34
+
35
+ ## ⚠️ CRITICAL: File Editing Rules
36
+
37
+ **MANDATORY**: When editing multiple files, Claude Code MUST edit files **SEQUENTIALLY**, one at a time.
38
+
39
+ ### Why Sequential Editing is Required
40
+
41
+ Claude Code's Edit tool uses exact string matching for replacements. When multiple files are edited in parallel:
42
+ - The tool may fail to find the exact string in some files
43
+ - Race conditions can cause partial or corrupted edits
44
+ - Error recovery becomes impossible
45
+
46
+ ### Correct File Editing Pattern
47
+
48
+ ```
49
+ ✅ CORRECT (Sequential):
50
+ 1. Edit file A → Wait for confirmation
51
+ 2. Edit file B → Wait for confirmation
52
+ 3. Edit file C → Wait for confirmation
53
+
54
+ ❌ WRONG (Parallel):
55
+ 1. Edit files A, B, C simultaneously → Failures likely
56
+ ```
57
+
58
+ ### Implementation Rules
59
+
60
+ 1. **NEVER call multiple Edit tools in parallel** for different files
61
+ 2. **ALWAYS wait for each edit to complete** before starting the next
62
+ 3. **Verify each edit succeeded** before proceeding
63
+ 4. **If an edit fails**, retry that specific edit before moving on
64
+
65
+ ## ⚠️ CRITICAL: Test Implementation Rules
66
+
67
+ **MANDATORY**: When implementing tests, Claude Code MUST write **complete, production-quality tests**.
68
+
69
+ ### Forbidden Test Patterns
70
+
71
+ ```typescript
72
+ // ❌ NEVER do this - placeholder tests
73
+ it('should work', () => {
74
+ expect(true).toBe(true);
75
+ });
76
+
77
+ // ❌ NEVER do this - skipped tests
78
+ it.skip('should handle edge case', () => {});
79
+
80
+ // ❌ NEVER do this - incomplete assertions
81
+ it('should return data', () => {
82
+ const result = getData();
83
+ expect(result).toBeDefined(); // Too weak!
84
+ });
85
+
86
+ // ❌ NEVER do this - "simplify" by removing test cases
87
+ // Original had 10 test cases, don't reduce to 3
88
+ ```
89
+
90
+ ### Required Test Patterns
91
+
92
+ ```typescript
93
+ // ✅ CORRECT - complete test with proper assertions
94
+ it('should return user data with correct structure', () => {
95
+ const result = getUserById(1);
96
+ expect(result).toEqual({
97
+ id: 1,
98
+ name: 'John Doe',
99
+ email: 'john@example.com',
100
+ createdAt: expect.any(Date),
101
+ });
102
+ });
103
+
104
+ // ✅ CORRECT - test edge cases and error paths
105
+ it('should throw NotFoundError when user does not exist', () => {
106
+ expect(() => getUserById(999)).toThrow(NotFoundError);
107
+ });
108
+
109
+ // ✅ CORRECT - test all branches
110
+ describe('validateEmail', () => {
111
+ it('should return true for valid email', () => {...});
112
+ it('should return false for missing @', () => {...});
113
+ it('should return false for missing domain', () => {...});
114
+ it('should return false for empty string', () => {...});
115
+ });
116
+ ```
117
+
118
+ ### Test Implementation Rules
119
+
120
+ 1. **NEVER simplify tests** - Implement the full, complete test as originally designed
121
+ 2. **NEVER skip test cases** - Every test case in the spec must be implemented
122
+ 3. **NEVER use placeholder assertions** - Each assertion must verify actual behavior
123
+ 4. **ALWAYS test error paths** - Exceptions, edge cases, and failure modes
124
+ 5. **ALWAYS maintain coverage** - Tests must achieve the project's coverage threshold
125
+
126
+ ## Workflow
127
+
128
+ 1. **Always read AGENTS.md and CLAUDE.md first** for project standards
129
+ 2. **Plan file changes before editing** - List all files that need modification
130
+ 3. **Edit files sequentially** - One file at a time, verify each edit
131
+ 4. **Write complete tests** - No placeholders, no simplifications
132
+ 5. **Run quality checks**: `npm run lint && npm test`
133
+ 6. **Verify coverage threshold** is met before committing
134
+
135
+ ## Quality Gates
136
+
137
+ Before completing any task:
138
+ - [ ] All files edited successfully (sequential editing)
139
+ - [ ] All tests implemented completely (no placeholders)
140
+ - [ ] Linting passes with zero warnings
141
+ - [ ] All tests pass (100% pass rate)
142
+ - [ ] Coverage threshold met (check AGENTS.md for threshold)
143
+
144
+ **Critical**: Reference AGENTS.md and CLAUDE.md in prompts for consistent code generation.
145
+
146
+ <!-- CLAUDE_CODE:END -->
@@ -1,13 +1,13 @@
1
- ---
2
- name: "Cline"
3
- description: "Tool: VS Code extension with autonomous mode"
4
- version: "1.0.0"
5
- category: "cli"
6
- author: "Rulebook"
7
- tags: ["cli", "cli-tool"]
8
- dependencies: []
9
- conflicts: []
10
- ---
1
+ ---
2
+ name: "Cline"
3
+ description: "Tool: VS Code extension with autonomous mode"
4
+ version: "1.0.0"
5
+ category: "cli"
6
+ author: "Rulebook"
7
+ tags: ["cli", "cli-tool"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
11
  <!-- CLINE:START -->
12
12
  # Cline CLI Rules
13
13