@hivehub/rulebook 3.2.1 → 3.3.1
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.
- package/.claude/commands/rulebook-task-apply.md +2 -2
- package/.claude/commands/rulebook-task-archive.md +3 -3
- package/.claude/commands/rulebook-task-create.md +4 -4
- package/.claude/commands/rulebook-task-list.md +2 -2
- package/.claude/commands/rulebook-task-show.md +2 -2
- package/.claude/commands/rulebook-task-validate.md +2 -2
- package/.claude-plugin/marketplace.json +29 -29
- package/.claude-plugin/plugin.json +8 -8
- package/README.md +8 -8
- package/dist/cli/commands.d.ts.map +1 -1
- package/dist/cli/commands.js +328 -33
- package/dist/cli/commands.js.map +1 -1
- package/dist/core/config-manager.d.ts +10 -0
- package/dist/core/config-manager.d.ts.map +1 -1
- package/dist/core/config-manager.js +118 -0
- package/dist/core/config-manager.js.map +1 -1
- package/dist/core/generator.js +10 -10
- package/dist/core/generator.js.map +1 -1
- package/dist/core/migrator.d.ts.map +1 -1
- package/dist/core/migrator.js +3 -3
- package/dist/core/migrator.js.map +1 -1
- package/dist/core/openspec-manager.d.ts +2 -2
- package/dist/core/openspec-manager.d.ts.map +1 -1
- package/dist/core/openspec-manager.js +5 -14
- package/dist/core/openspec-manager.js.map +1 -1
- package/dist/core/openspec-migrator.d.ts.map +1 -1
- package/dist/core/openspec-migrator.js +3 -3
- package/dist/core/openspec-migrator.js.map +1 -1
- package/dist/core/prd-generator.d.ts.map +1 -1
- package/dist/core/prd-generator.js +2 -1
- package/dist/core/prd-generator.js.map +1 -1
- package/dist/core/ralph-manager.d.ts +9 -1
- package/dist/core/ralph-manager.d.ts.map +1 -1
- package/dist/core/ralph-manager.js +56 -2
- package/dist/core/ralph-manager.js.map +1 -1
- package/dist/core/task-manager.d.ts.map +1 -1
- package/dist/core/task-manager.js +2 -2
- package/dist/core/task-manager.js.map +1 -1
- package/dist/core/validator.js +6 -6
- package/dist/core/validator.js.map +1 -1
- package/dist/mcp/rulebook-server.d.ts.map +1 -1
- package/dist/mcp/rulebook-server.js +152 -20
- package/dist/mcp/rulebook-server.js.map +1 -1
- package/dist/types.d.ts +1 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/templates/commands/rulebook-task-apply.md +2 -2
- package/templates/commands/rulebook-task-archive.md +3 -3
- package/templates/commands/rulebook-task-create.md +4 -4
- package/templates/commands/rulebook-task-list.md +2 -2
- package/templates/commands/rulebook-task-show.md +2 -2
- package/templates/commands/rulebook-task-validate.md +2 -2
- package/templates/core/RALPH.md +2 -2
- package/templates/core/RULEBOOK.md +13 -13
- package/templates/git/CI_CD_PATTERNS.md +4 -4
- package/templates/git/GITHUB_ACTIONS.md +3 -3
- package/templates/git/GITLAB_CI.md +4 -4
- package/templates/git/SECRETS_MANAGEMENT.md +4 -4
- package/templates/hooks/COMMIT_MSG.md +4 -4
- package/templates/hooks/POST_CHECKOUT.md +3 -3
- package/templates/hooks/PREPARE_COMMIT_MSG.md +3 -3
- package/templates/hooks/PRE_COMMIT.md +4 -4
- package/templates/hooks/PRE_PUSH.md +4 -4
- package/templates/skills/cli/aider/SKILL.md +10 -10
- package/templates/skills/cli/amazon-q/SKILL.md +10 -10
- package/templates/skills/cli/auggie/SKILL.md +10 -10
- package/templates/skills/cli/claude/SKILL.md +10 -10
- package/templates/skills/cli/claude-code/SKILL.md +146 -146
- package/templates/skills/cli/cline/SKILL.md +10 -10
- package/templates/skills/cli/codebuddy/SKILL.md +10 -10
- package/templates/skills/cli/codeium/SKILL.md +10 -10
- package/templates/skills/cli/codex/SKILL.md +10 -10
- package/templates/skills/cli/continue/SKILL.md +10 -10
- package/templates/skills/cli/cursor-cli/SKILL.md +10 -10
- package/templates/skills/cli/factory/SKILL.md +10 -10
- package/templates/skills/cli/gemini/SKILL.md +10 -10
- package/templates/skills/cli/kilocode/SKILL.md +10 -10
- package/templates/skills/cli/opencode/SKILL.md +10 -10
- package/templates/skills/core/agent-automation/SKILL.md +10 -10
- package/templates/skills/core/dag/SKILL.md +10 -10
- package/templates/skills/core/documentation-rules/SKILL.md +10 -10
- package/templates/skills/core/quality-enforcement/SKILL.md +10 -10
- package/templates/skills/core/rulebook/SKILL.md +1 -1
- package/templates/skills/frameworks/angular/SKILL.md +10 -10
- package/templates/skills/frameworks/django/SKILL.md +10 -10
- package/templates/skills/frameworks/electron/SKILL.md +10 -10
- package/templates/skills/frameworks/flask/SKILL.md +10 -10
- package/templates/skills/frameworks/flutter/SKILL.md +10 -10
- package/templates/skills/frameworks/jquery/SKILL.md +10 -10
- package/templates/skills/frameworks/laravel/SKILL.md +10 -10
- package/templates/skills/frameworks/nestjs/SKILL.md +10 -10
- package/templates/skills/frameworks/nextjs/SKILL.md +10 -10
- package/templates/skills/frameworks/nuxt/SKILL.md +10 -10
- package/templates/skills/frameworks/rails/SKILL.md +10 -10
- package/templates/skills/frameworks/react/SKILL.md +10 -10
- package/templates/skills/frameworks/react-native/SKILL.md +10 -10
- package/templates/skills/frameworks/spring/SKILL.md +10 -10
- package/templates/skills/frameworks/symfony/SKILL.md +10 -10
- package/templates/skills/frameworks/vue/SKILL.md +10 -10
- package/templates/skills/frameworks/zend/SKILL.md +10 -10
- package/templates/skills/ides/copilot/SKILL.md +10 -10
- package/templates/skills/ides/cursor/SKILL.md +10 -10
- package/templates/skills/ides/jetbrains-ai/SKILL.md +10 -10
- package/templates/skills/ides/replit/SKILL.md +10 -10
- package/templates/skills/ides/tabnine/SKILL.md +10 -10
- package/templates/skills/ides/vscode/SKILL.md +10 -10
- package/templates/skills/ides/windsurf/SKILL.md +10 -10
- package/templates/skills/ides/zed/SKILL.md +10 -10
- package/templates/skills/languages/ada/SKILL.md +68 -68
- package/templates/skills/languages/c/SKILL.md +10 -10
- package/templates/skills/languages/cpp/SKILL.md +10 -10
- package/templates/skills/languages/csharp/SKILL.md +10 -10
- package/templates/skills/languages/dart/SKILL.md +342 -342
- package/templates/skills/languages/elixir/SKILL.md +10 -10
- package/templates/skills/languages/erlang/SKILL.md +10 -10
- package/templates/skills/languages/go/SKILL.md +10 -10
- package/templates/skills/languages/haskell/SKILL.md +10 -10
- package/templates/skills/languages/java/SKILL.md +10 -10
- package/templates/skills/languages/javascript/SKILL.md +10 -10
- package/templates/skills/languages/julia/SKILL.md +10 -10
- package/templates/skills/languages/kotlin/SKILL.md +10 -10
- package/templates/skills/languages/lisp/SKILL.md +10 -10
- package/templates/skills/languages/lua/SKILL.md +10 -10
- package/templates/skills/languages/objectivec/SKILL.md +10 -10
- package/templates/skills/languages/php/SKILL.md +10 -10
- package/templates/skills/languages/python/SKILL.md +10 -10
- package/templates/skills/languages/r/SKILL.md +360 -360
- package/templates/skills/languages/ruby/SKILL.md +10 -10
- package/templates/skills/languages/rust/SKILL.md +10 -10
- package/templates/skills/languages/sas/SKILL.md +10 -10
- package/templates/skills/languages/scala/SKILL.md +10 -10
- package/templates/skills/languages/solidity/SKILL.md +10 -10
- package/templates/skills/languages/sql/SKILL.md +10 -10
- package/templates/skills/languages/swift/SKILL.md +10 -10
- package/templates/skills/languages/zig/SKILL.md +10 -10
- package/templates/skills/modules/atlassian/SKILL.md +10 -10
- package/templates/skills/modules/context7/SKILL.md +10 -10
- package/templates/skills/modules/figma/SKILL.md +10 -10
- package/templates/skills/modules/github-mcp/SKILL.md +10 -10
- package/templates/skills/modules/grafana/SKILL.md +10 -10
- package/templates/skills/modules/memory/SKILL.md +10 -10
- package/templates/skills/modules/notion/SKILL.md +10 -10
- package/templates/skills/modules/playwright/SKILL.md +10 -10
- package/templates/skills/modules/rulebook-mcp/SKILL.md +10 -10
- package/templates/skills/modules/serena/SKILL.md +10 -10
- package/templates/skills/modules/supabase/SKILL.md +10 -10
- package/templates/skills/modules/synap/SKILL.md +10 -10
- package/templates/skills/modules/vectorizer/SKILL.md +10 -10
- package/templates/skills/services/azure-blob/SKILL.md +10 -10
- package/templates/skills/services/cassandra/SKILL.md +10 -10
- package/templates/skills/services/dynamodb/SKILL.md +10 -10
- package/templates/skills/services/elasticsearch/SKILL.md +10 -10
- package/templates/skills/services/gcs/SKILL.md +10 -10
- package/templates/skills/services/influxdb/SKILL.md +10 -10
- package/templates/skills/services/kafka/SKILL.md +10 -10
- package/templates/skills/services/mariadb/SKILL.md +10 -10
- package/templates/skills/services/memcached/SKILL.md +10 -10
- package/templates/skills/services/minio/SKILL.md +10 -10
- package/templates/skills/services/mongodb/SKILL.md +10 -10
- package/templates/skills/services/mysql/SKILL.md +10 -10
- package/templates/skills/services/neo4j/SKILL.md +10 -10
- package/templates/skills/services/oracle/SKILL.md +10 -10
- package/templates/skills/services/postgresql/SKILL.md +10 -10
- package/templates/skills/services/rabbitmq/SKILL.md +10 -10
- package/templates/skills/services/redis/SKILL.md +10 -10
- package/templates/skills/services/s3/SKILL.md +10 -10
- package/templates/skills/services/sqlite/SKILL.md +10 -10
- package/templates/skills/services/sqlserver/SKILL.md +10 -10
- package/templates/skills/workflows/ralph/SETUP.md +228 -228
- package/templates/skills/workflows/ralph/SKILL.md +1 -1
- 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
|
-
#
|
|
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**:
|
|
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**:
|
|
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**:
|
|
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
|
|
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
|
-
|
|
1091
|
+
/.rulebook/tasks/archive/YYYY-MM-DD-<task-id>/
|
|
1092
1092
|
```
|
|
1093
1093
|
|
|
1094
1094
|
**Structure:**
|
|
1095
1095
|
```
|
|
1096
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
659
|
-
- See
|
|
660
|
-
- See
|
|
661
|
-
- See
|
|
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
|
|
726
|
-
- See
|
|
727
|
-
- See
|
|
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
|
|
728
|
-
- See
|
|
729
|
-
- See
|
|
730
|
-
- See
|
|
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
|
|
583
|
-
- See
|
|
584
|
-
- See
|
|
585
|
-
- See
|
|
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
|
|
528
|
-
- See
|
|
529
|
-
- See
|
|
530
|
-
- See
|
|
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
|
|
544
|
-
- See
|
|
545
|
-
- See
|
|
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
|
|
618
|
-
- See
|
|
619
|
-
- See
|
|
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
|
|
411
|
-
- See
|
|
412
|
-
- See
|
|
413
|
-
- See
|
|
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
|
|
598
|
-
- See
|
|
599
|
-
- See
|
|
600
|
-
- See
|
|
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
|
|