@hivehub/rulebook 5.5.2 → 5.8.0

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

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

package/templates/compact-context/_default.md

@@ -1,23 +1,23 @@
-# Post-compaction cheat sheet
-
-This file is re-injected after every conversation compaction. Keep it
-**short (≤50 lines)** and only include directives that must survive
-compaction. Everything else belongs in `CLAUDE.md`, `AGENTS.md`, or
-`.claude/rules/`.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before making changes.
-- Never revert or discard uncommitted work — fix forward.
-- Edit files sequentially, not in parallel (see `.claude/rules/sequential-editing.md`).
-- Run diagnostics (`type-check`, `lint`) before running the full test suite.
-- If a fix fails twice, stop and escalate — do not retry a third time.
-- Prefer MCP tools over shell commands when an equivalent MCP tool exists.
-- Save learnings to `.rulebook/learnings/` at the end of significant work.
-
-## Project-specific reminders
-
-(Edit this file to add reminders unique to your project. Examples:
-build command, primary language toolchain, forbidden directories,
-where canonical documentation lives, critical files that must not
-be touched without review.)
+# Post-compaction cheat sheet
+
+This file is re-injected after every conversation compaction. Keep it
+**short (≤50 lines)** and only include directives that must survive
+compaction. Everything else belongs in `CLAUDE.md`, `AGENTS.md`, or
+`.claude/rules/`.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before making changes.
+- Never revert or discard uncommitted work — fix forward.
+- Edit files sequentially, not in parallel (see `.claude/rules/sequential-editing.md`).
+- Run diagnostics (`type-check`, `lint`) before running the full test suite.
+- If a fix fails twice, stop and escalate — do not retry a third time.
+- Prefer MCP tools over shell commands when an equivalent MCP tool exists.
+- Save learnings to `.rulebook/learnings/` at the end of significant work.
+
+## Project-specific reminders
+
+(Edit this file to add reminders unique to your project. Examples:
+build command, primary language toolchain, forbidden directories,
+where canonical documentation lives, critical files that must not
+be touched without review.)

package/templates/compact-context/cpp.md

@@ -1,26 +1,26 @@
-# Post-compaction cheat sheet (C/C++ project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `cmake --build <build>` before running tests.
-- Warnings are errors (`-Wall -Wextra -Werror`).
-- Smart pointers only — no raw `new`/`delete` without justification.
-- Edit files sequentially, not in parallel.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Configure**: `cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON`
-- **Build**: `cmake --build build -j`
-- **Test**: `ctest --test-dir build --output-on-failure`
-- **Format**: `clang-format -i <files>`
-- **Sanitize (CI)**: `-fsanitize=address,undefined`
-
-## Forbidden
-
-- No `using namespace std;` in headers.
-- No undefined behavior shortcuts (strict aliasing, signed overflow).
-- No out-of-source build pollution in `build/` committed.
+# Post-compaction cheat sheet (C/C++ project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `cmake --build <build>` before running tests.
+- Warnings are errors (`-Wall -Wextra -Werror`).
+- Smart pointers only — no raw `new`/`delete` without justification.
+- Edit files sequentially, not in parallel.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Configure**: `cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON`
+- **Build**: `cmake --build build -j`
+- **Test**: `ctest --test-dir build --output-on-failure`
+- **Format**: `clang-format -i <files>`
+- **Sanitize (CI)**: `-fsanitize=address,undefined`
+
+## Forbidden
+
+- No `using namespace std;` in headers.
+- No undefined behavior shortcuts (strict aliasing, signed overflow).
+- No out-of-source build pollution in `build/` committed.

package/templates/compact-context/go.md

@@ -1,26 +1,26 @@
-# Post-compaction cheat sheet (Go project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `go vet ./...` before `go test ./...`.
-- `gofmt -s -w .` on every file you touch.
-- `context.Context` as first parameter for I/O or blocking functions.
-- Edit files sequentially, not in parallel.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Build**: `go build ./...`
-- **Vet**: `go vet ./...`
-- **Test**: `go test -race ./...`
-- **Format**: `gofmt -s -w .` and `goimports -w .`
-- **Mod tidy**: `go mod tidy` after adding imports
-
-## Forbidden
-
-- No `_ = err` — handle or wrap every error.
-- No vendored `/vendor/` unless project explicitly vendors.
-- No new modules without authorization.
+# Post-compaction cheat sheet (Go project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `go vet ./...` before `go test ./...`.
+- `gofmt -s -w .` on every file you touch.
+- `context.Context` as first parameter for I/O or blocking functions.
+- Edit files sequentially, not in parallel.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Build**: `go build ./...`
+- **Vet**: `go vet ./...`
+- **Test**: `go test -race ./...`
+- **Format**: `gofmt -s -w .` and `goimports -w .`
+- **Mod tidy**: `go mod tidy` after adding imports
+
+## Forbidden
+
+- No `_ = err` — handle or wrap every error.
+- No vendored `/vendor/` unless project explicitly vendors.
+- No new modules without authorization.

package/templates/compact-context/python.md

@@ -1,26 +1,26 @@
-# Post-compaction cheat sheet (Python project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- Type-check (`mypy` / `pyright`) before `pytest`.
-- `ruff check` before committing.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Install**: `pip install -e .` or `poetry install` or `uv sync`
-- **Type-check**: `mypy .` or `pyright`
-- **Lint**: `ruff check .`
-- **Format**: `ruff format .` or `black .`
-- **Test**: `pytest`
-
-## Forbidden
-
-- No bare `except:` — catch specific exceptions.
-- No new dependencies without authorization.
-- No `rm -rf` in this repo.
+# Post-compaction cheat sheet (Python project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- Type-check (`mypy` / `pyright`) before `pytest`.
+- `ruff check` before committing.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Install**: `pip install -e .` or `poetry install` or `uv sync`
+- **Type-check**: `mypy .` or `pyright`
+- **Lint**: `ruff check .`
+- **Format**: `ruff format .` or `black .`
+- **Test**: `pytest`
+
+## Forbidden
+
+- No bare `except:` — catch specific exceptions.
+- No new dependencies without authorization.
+- No `rm -rf` in this repo.

package/templates/compact-context/rust.md

@@ -1,28 +1,28 @@
-# Post-compaction cheat sheet (Rust project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `cargo check` before `cargo test` — check is 5–10x faster.
-- `cargo clippy -- -D warnings` must pass.
-- `cargo fmt` before committing — no style debates.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Check**: `cargo check --all-targets`
-- **Build**: `cargo build`
-- **Test**: `cargo test --all-features`
-- **Lint**: `cargo clippy -- -D warnings`
-- **Format**: `cargo fmt`
-- **Run**: `cargo run`
-
-## Forbidden
-
-- No `unwrap()`/`expect()` in non-test code without a safety comment.
-- No `unsafe` without a `// SAFETY:` comment.
-- No new crates without authorization.
+# Post-compaction cheat sheet (Rust project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `cargo check` before `cargo test` — check is 5–10x faster.
+- `cargo clippy -- -D warnings` must pass.
+- `cargo fmt` before committing — no style debates.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Check**: `cargo check --all-targets`
+- **Build**: `cargo build`
+- **Test**: `cargo test --all-features`
+- **Lint**: `cargo clippy -- -D warnings`
+- **Format**: `cargo fmt`
+- **Run**: `cargo run`
+
+## Forbidden
+
+- No `unwrap()`/`expect()` in non-test code without a safety comment.
+- No `unsafe` without a `// SAFETY:` comment.
+- No new crates without authorization.

package/templates/compact-context/typescript.md

@@ -1,29 +1,29 @@
-# Post-compaction cheat sheet (TypeScript project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `npm run type-check` before `npm test` — type errors are cheaper.
-- `npm run lint` must pass with zero warnings.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-- Use MCP tools (`mcp__rulebook__*`) over shell where available.
-
-## Build & test quick reference
-
-- **Install**: `npm install`
-- **Build**: `npm run build` (TypeScript → `dist/`)
-- **Type-check**: `npm run type-check`
-- **Lint**: `npm run lint`
-- **Test**: `npm test` (or `npx vitest run <file>` for single file)
-- **Dev**: `npm run dev`
-
-## Forbidden
-
-- No `any` without justification.
-- No `// @ts-ignore` without a one-line reason.
-- No new dependencies without explicit authorization.
-- No `rm -rf` in this repo.
+# Post-compaction cheat sheet (TypeScript project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `npm run type-check` before `npm test` — type errors are cheaper.
+- `npm run lint` must pass with zero warnings.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+- Use MCP tools (`mcp__rulebook__*`) over shell where available.
+
+## Build & test quick reference
+
+- **Install**: `npm install`
+- **Build**: `npm run build` (TypeScript → `dist/`)
+- **Type-check**: `npm run type-check`
+- **Lint**: `npm run lint`
+- **Test**: `npm test` (or `npx vitest run <file>` for single file)
+- **Dev**: `npm run dev`
+
+## Forbidden
+
+- No `any` without justification.
+- No `// @ts-ignore` without a one-line reason.
+- No new dependencies without explicit authorization.
+- No `rm -rf` in this repo.

package/templates/core/AGENTS_LEAN.md

@@ -157,20 +157,6 @@ LANGUAGE_REFS
 
 MODULE_REFS
 
-## Ralph Autonomous Loop
-
-5-gate quality enforcement (type-check, lint, tests, coverage, security) per iteration, fresh context per iteration, parallel story execution, plan checkpoints, learning extraction.
-
-```bash
-rulebook ralph init                    # Generate PRD from tasks
-rulebook ralph run --max-iterations 10
-rulebook ralph status / history / pause / resume
-```
-
-PRD format: `userStories` array with `id`, `title`, `description`, `acceptanceCriteria`, `priority`, `passes: boolean`, `notes`. Status tracked via `passes`, NOT enum.
-
-Iteration records in `.rulebook/ralph/history/iteration-N.json`. Status: `success` (5/5 gates), `partial` (2-4), `failed` (0-1).
-
 ## Multi-Agent Teams
 
 Requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`. Background `Agent` calls **must** use a Team (`team_name` parameter) — standalone background agents can't communicate via `SendMessage`. Foreground calls and `team-lead` agents are exempt.

package/templates/core/AGENTS_OVERRIDE.md

@@ -1,16 +1,16 @@
-<!-- OVERRIDE:START -->
-# Project-Specific Overrides
-
-This file contains project-specific directives that take precedence over the generated AGENTS.md.
-
-Add your custom rules, team conventions, or project-specific context here.
-This file is NEVER overwritten by `rulebook init` or `rulebook update`.
-
-## Example Overrides
-
-- **Preferred patterns**: Always use X pattern for Y
-- **Team conventions**: Code reviews require 2 approvals
-- **Project context**: This project targets Node.js 20+ only
-- **Custom quality gates**: Run `npm run e2e` before merging
-
-<!-- OVERRIDE:END -->
+<!-- OVERRIDE:START -->
+# Project-Specific Overrides
+
+This file contains project-specific directives that take precedence over the generated AGENTS.md.
+
+Add your custom rules, team conventions, or project-specific context here.
+This file is NEVER overwritten by `rulebook init` or `rulebook update`.
+
+## Example Overrides
+
+- **Preferred patterns**: Always use X pattern for Y
+- **Team conventions**: Code reviews require 2 approvals
+- **Project context**: This project targets Node.js 20+ only
+- **Custom quality gates**: Run `npm run e2e` before merging
+
+<!-- OVERRIDE:END -->