@hivehub/rulebook 4.0.0 → 4.2.0

package/templates/ides/ZED.md

@@ -1,32 +1,32 @@
-<!-- ZED:START -->
-# Zed Editor Rules
-
-**Tool**: High-performance collaborative editor (Rust-powered)
-
-## Quick Start
-
-Zed reads workspace files for AI context.
-
-## Usage
-
-```bash
-# In Zed AI assistant:
-"Follow @AGENTS.md. Implement [feature] with tests."
-```
-
-## Features
-
-- **AI Assistant**: Inline chat
-- **Collaborative Editing**: Real-time collaboration
-- **Fast Performance**: Rust-based, instant responsiveness
-
-## Workflow
-
-1. Keep AGENTS.md open in workspace
-2. Use AI assistant with `@AGENTS.md` references
-3. Review suggestions
-4. Run quality checks in terminal
-
-**Critical**: Zed's AI reads open files - keep AGENTS.md accessible.
-
-<!-- ZED:END -->
+<!-- ZED:START -->
+# Zed Editor Rules
+
+**Tool**: High-performance collaborative editor (Rust-powered)
+
+## Quick Start
+
+Zed reads workspace files for AI context.
+
+## Usage
+
+```bash
+# In Zed AI assistant:
+"Follow @AGENTS.md. Implement [feature] with tests."
+```
+
+## Features
+
+- **AI Assistant**: Inline chat
+- **Collaborative Editing**: Real-time collaboration
+- **Fast Performance**: Rust-based, instant responsiveness
+
+## Workflow
+
+1. Keep AGENTS.md open in workspace
+2. Use AI assistant with `@AGENTS.md` references
+3. Review suggestions
+4. Run quality checks in terminal
+
+**Critical**: Zed's AI reads open files - keep AGENTS.md accessible.
+
+<!-- ZED:END -->

package/templates/ides/cursor-mdc/go.mdc

@@ -1,24 +1,24 @@
----
-description: Go coding standards and best practices
-globs: ["**/*.go"]
-alwaysApply: false
----
-
-# Go Rules
-
-See `/.rulebook/specs/GO.md` for full requirements.
-
-## Key Rules
-
-- Always check and handle errors (never `_` for error returns)
-- Use `errors.Is()` / `errors.As()` for error comparison
-- Prefer `context.Context` for cancellation and deadlines
-- Use `fmt.Errorf("...: %w", err)` for error wrapping
-- Follow standard Go project layout (`cmd/`, `internal/`, `pkg/`)
-- Run `gofmt` and `golangci-lint` before committing
-
-## Error Handling
-
-- Return errors as last return value
-- Wrap errors with context using `%w`
-- Use sentinel errors for well-known conditions
+---
+description: Go coding standards and best practices
+globs: ["**/*.go"]
+alwaysApply: false
+---
+
+# Go Rules
+
+See `/.rulebook/specs/GO.md` for full requirements.
+
+## Key Rules
+
+- Always check and handle errors (never `_` for error returns)
+- Use `errors.Is()` / `errors.As()` for error comparison
+- Prefer `context.Context` for cancellation and deadlines
+- Use `fmt.Errorf("...: %w", err)` for error wrapping
+- Follow standard Go project layout (`cmd/`, `internal/`, `pkg/`)
+- Run `gofmt` and `golangci-lint` before committing
+
+## Error Handling
+
+- Return errors as last return value
+- Wrap errors with context using `%w`
+- Use sentinel errors for well-known conditions

package/templates/ides/cursor-mdc/python.mdc

@@ -1,24 +1,24 @@
----
-description: Python coding standards and best practices
-globs: ["**/*.py"]
-alwaysApply: false
----
-
-# Python Rules
-
-See `/.rulebook/specs/PYTHON.md` for full requirements.
-
-## Key Rules
-
-- Type hints required for all function signatures
-- Use `dataclasses` or `pydantic` for structured data
-- Prefer `pathlib.Path` over `os.path`
-- Use `async/await` for I/O-bound operations
-- Black formatting, ruff linting
-- `__all__` in modules to control public API
-
-## Error Handling
-
-- Use specific exception types (not bare `except`)
-- Validate inputs at module boundaries
-- Log errors with context before re-raising
+---
+description: Python coding standards and best practices
+globs: ["**/*.py"]
+alwaysApply: false
+---
+
+# Python Rules
+
+See `/.rulebook/specs/PYTHON.md` for full requirements.
+
+## Key Rules
+
+- Type hints required for all function signatures
+- Use `dataclasses` or `pydantic` for structured data
+- Prefer `pathlib.Path` over `os.path`
+- Use `async/await` for I/O-bound operations
+- Black formatting, ruff linting
+- `__all__` in modules to control public API
+
+## Error Handling
+
+- Use specific exception types (not bare `except`)
+- Validate inputs at module boundaries
+- Log errors with context before re-raising

package/templates/ides/cursor-mdc/quality.mdc

@@ -1,25 +1,25 @@
----
-description: Quality enforcement rules — type safety, linting, testing, coverage
-alwaysApply: true
----
-
-# Quality Enforcement
-
-See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for full requirements.
-
-## Mandatory Quality Gates
-
-Every change MUST pass all quality gates before merge:
-
-1. **Type Check** — `npm run type-check` (zero TypeScript errors)
-2. **Lint** — `npm run lint` (zero ESLint errors)
-3. **Tests** — `npm test` (all tests pass)
-4. **Coverage** — Meet configured threshold (default 75%)
-
-## Code Standards
-
-- No `any` types without explicit justification
-- No unused variables or imports
-- Error handling at system boundaries only
-- No over-engineering: minimum complexity for the task
-- No backwards-compatibility hacks for unused code
+---
+description: Quality enforcement rules — type safety, linting, testing, coverage
+alwaysApply: true
+---
+
+# Quality Enforcement
+
+See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for full requirements.
+
+## Mandatory Quality Gates
+
+Every change MUST pass all quality gates before merge:
+
+1. **Type Check** — `npm run type-check` (zero TypeScript errors)
+2. **Lint** — `npm run lint` (zero ESLint errors)
+3. **Tests** — `npm test` (all tests pass)
+4. **Coverage** — Meet configured threshold (default 75%)
+
+## Code Standards
+
+- No `any` types without explicit justification
+- No unused variables or imports
+- Error handling at system boundaries only
+- No over-engineering: minimum complexity for the task
+- No backwards-compatibility hacks for unused code

package/templates/ides/cursor-mdc/ralph.mdc

@@ -1,39 +1,39 @@
----
-description: Ralph autonomous loop directives for AI-driven task completion
-alwaysApply: false
----
-
-# Ralph Autonomous Loop
-
-See `/.rulebook/specs/AGENT_AUTOMATION.md` for full directives.
-
-## Ralph Commands
-
-```bash
-rulebook ralph init     # Initialize autonomous loop
-rulebook ralph run      # Start iterating on tasks
-rulebook ralph status   # Check progress
-rulebook ralph pause    # Pause for manual intervention
-rulebook ralph history  # View past iterations
-```
-
-## PRD Format
-
-Ralph uses `.rulebook/ralph/prd.json` with `userStories[]`:
-
-```json
-{
-  "id": "US-001",
-  "title": "Story Title",
-  "description": "What needs to be done",
-  "acceptanceCriteria": ["Must compile", "Tests pass"],
-  "passes": false
-}
-```
-
-## Quality Gates
-
-All 4 gates MUST pass per iteration:
-- type-check ✓, lint ✓, tests ✓, coverage ✓
-
-Failed gates mark the story `passes: false` for retry.
+---
+description: Ralph autonomous loop directives for AI-driven task completion
+alwaysApply: false
+---
+
+# Ralph Autonomous Loop
+
+See `/.rulebook/specs/AGENT_AUTOMATION.md` for full directives.
+
+## Ralph Commands
+
+```bash
+rulebook ralph init     # Initialize autonomous loop
+rulebook ralph run      # Start iterating on tasks
+rulebook ralph status   # Check progress
+rulebook ralph pause    # Pause for manual intervention
+rulebook ralph history  # View past iterations
+```
+
+## PRD Format
+
+Ralph uses `.rulebook/ralph/prd.json` with `userStories[]`:
+
+```json
+{
+  "id": "US-001",
+  "title": "Story Title",
+  "description": "What needs to be done",
+  "acceptanceCriteria": ["Must compile", "Tests pass"],
+  "passes": false
+}
+```
+
+## Quality Gates
+
+All 4 gates MUST pass per iteration:
+- type-check ✓, lint ✓, tests ✓, coverage ✓
+
+Failed gates mark the story `passes: false` for retry.

package/templates/ides/cursor-mdc/rulebook.mdc

@@ -1,38 +1,38 @@
----
-description: Core Rulebook project directives and task management rules
-alwaysApply: true
----
-
-# Project Agent Directives
-
-Generated by @hivehub/rulebook. See `.rulebook/specs/` for detailed specifications.
-
-## Task Management
-
-All tasks MUST follow the Rulebook task structure:
-
-```
-.rulebook/tasks/<task-id>/
-├── proposal.md         # Why and what changes
-├── tasks.md            # Simple checklist only
-└── specs/<module>/spec.md  # Technical specs
-```
-
-- Use `rulebook task create` to create tasks
-- `tasks.md` contains ONLY simple checklist items
-- Technical details go in `specs/<module>/spec.md`
-- NEVER create README.md or PROCESS.md in task directories
-
-## Quality Gates
-
-Before every commit:
-- `npm run type-check` — TypeScript must compile
-- `npm run lint` — Zero lint errors
-- `npm test` — All tests must pass
-- Coverage threshold must be met
-
-## Spec References
-
-- Core rules: `/.rulebook/specs/RULEBOOK.md`
-- Quality enforcement: `/.rulebook/specs/QUALITY_ENFORCEMENT.md`
-- Git workflow: `/.rulebook/specs/GIT.md`
+---
+description: Core Rulebook project directives and task management rules
+alwaysApply: true
+---
+
+# Project Agent Directives
+
+Generated by @hivehub/rulebook. See `.rulebook/specs/` for detailed specifications.
+
+## Task Management
+
+All tasks MUST follow the Rulebook task structure:
+
+```
+.rulebook/tasks/<task-id>/
+├── proposal.md         # Why and what changes
+├── tasks.md            # Simple checklist only
+└── specs/<module>/spec.md  # Technical specs
+```
+
+- Use `rulebook task create` to create tasks
+- `tasks.md` contains ONLY simple checklist items
+- Technical details go in `specs/<module>/spec.md`
+- NEVER create README.md or PROCESS.md in task directories
+
+## Quality Gates
+
+Before every commit:
+- `npm run type-check` — TypeScript must compile
+- `npm run lint` — Zero lint errors
+- `npm test` — All tests must pass
+- Coverage threshold must be met
+
+## Spec References
+
+- Core rules: `/.rulebook/specs/RULEBOOK.md`
+- Quality enforcement: `/.rulebook/specs/QUALITY_ENFORCEMENT.md`
+- Git workflow: `/.rulebook/specs/GIT.md`

package/templates/ides/cursor-mdc/rust.mdc

@@ -1,24 +1,24 @@
----
-description: Rust coding standards and best practices
-globs: ["**/*.rs"]
-alwaysApply: false
----
-
-# Rust Rules
-
-See `/.rulebook/specs/RUST.md` for full requirements.
-
-## Key Rules
-
-- Prefer `Result<T, E>` over `unwrap()` / `expect()`
-- Use `thiserror` for library errors, `anyhow` for application errors
-- Minimize `clone()` — prefer borrows and lifetimes
-- Use `clippy` with `#![deny(clippy::all)]`
-- Document public API with `///` doc comments
-- Prefer iterator adapters over manual loops
-
-## Error Handling
-
-- Propagate errors with `?` operator
-- Define domain error enums with `thiserror`
-- Never `panic!` in library code
+---
+description: Rust coding standards and best practices
+globs: ["**/*.rs"]
+alwaysApply: false
+---
+
+# Rust Rules
+
+See `/.rulebook/specs/RUST.md` for full requirements.
+
+## Key Rules
+
+- Prefer `Result<T, E>` over `unwrap()` / `expect()`
+- Use `thiserror` for library errors, `anyhow` for application errors
+- Minimize `clone()` — prefer borrows and lifetimes
+- Use `clippy` with `#![deny(clippy::all)]`
+- Document public API with `///` doc comments
+- Prefer iterator adapters over manual loops
+
+## Error Handling
+
+- Propagate errors with `?` operator
+- Define domain error enums with `thiserror`
+- Never `panic!` in library code

package/templates/ides/cursor-mdc/typescript.mdc

@@ -1,25 +1,25 @@
----
-description: TypeScript coding standards and best practices
-globs: ["**/*.ts", "**/*.tsx"]
-alwaysApply: false
----
-
-# TypeScript Rules
-
-See `/.rulebook/specs/TYPESCRIPT.md` for full requirements.
-
-## Key Rules
-
-- Strict mode enabled — all types must be explicit
-- No `any` without justification comment
-- Use `interface` for public API shapes, `type` for unions/aliases
-- Prefer `async/await` over raw Promises
-- Use `readonly` for immutable data
-- `path.join()` for file paths (never string concatenation)
-- Export only what is needed (avoid barrel re-exports)
-
-## Error Handling
-
-- Validate at system boundaries (user input, external APIs)
-- Use typed error classes for domain errors
-- Never swallow errors silently
+---
+description: TypeScript coding standards and best practices
+globs: ["**/*.ts", "**/*.tsx"]
+alwaysApply: false
+---
+
+# TypeScript Rules
+
+See `/.rulebook/specs/TYPESCRIPT.md` for full requirements.
+
+## Key Rules
+
+- Strict mode enabled — all types must be explicit
+- No `any` without justification comment
+- Use `interface` for public API shapes, `type` for unions/aliases
+- Prefer `async/await` over raw Promises
+- Use `readonly` for immutable data
+- `path.join()` for file paths (never string concatenation)
+- Export only what is needed (avoid barrel re-exports)
+
+## Error Handling
+
+- Validate at system boundaries (user input, external APIs)
+- Use typed error classes for domain errors
+- Never swallow errors silently