@hivehub/rulebook 5.3.3 → 5.4.1

package/templates/ides/JETBRAINS_AI.md

@@ -1,35 +1,35 @@
-<!-- JETBRAINS_AI:START -->
-# JetBrains AI Assistant Rules
-
-**IDEs**: IntelliJ, PyCharm, WebStorm, GoLand, RustRover, Rider, CLion, PhpStorm
-
-## Quick Start
-
-JetBrains AI reads workspace files automatically.
-
-## Usage
-
-```bash
-# In AI Assistant chat:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Keep AGENTS.md open for AI to reference
-```
-
-## Features
-
-- **AI Chat**: Full conversation mode
-- **Inline Suggestions**: Context-aware completions
-- **Refactoring**: AI-powered code improvements
-- **Test Generation**: Automated test creation
-
-## Workflow
-
-1. Keep AGENTS.md open in editor
-2. Use AI Chat with "@AGENTS.md" references
-3. Review suggested changes
-4. Run IDE quality checks (built-in linters, tests)
-
-**Critical**: Keep AGENTS.md open for AI Assistant to include standards in context.
-
-<!-- JETBRAINS_AI:END -->
+<!-- JETBRAINS_AI:START -->
+# JetBrains AI Assistant Rules
+
+**IDEs**: IntelliJ, PyCharm, WebStorm, GoLand, RustRover, Rider, CLion, PhpStorm
+
+## Quick Start
+
+JetBrains AI reads workspace files automatically.
+
+## Usage
+
+```bash
+# In AI Assistant chat:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Keep AGENTS.md open for AI to reference
+```
+
+## Features
+
+- **AI Chat**: Full conversation mode
+- **Inline Suggestions**: Context-aware completions
+- **Refactoring**: AI-powered code improvements
+- **Test Generation**: Automated test creation
+
+## Workflow
+
+1. Keep AGENTS.md open in editor
+2. Use AI Chat with "@AGENTS.md" references
+3. Review suggested changes
+4. Run IDE quality checks (built-in linters, tests)
+
+**Critical**: Keep AGENTS.md open for AI Assistant to include standards in context.
+
+<!-- JETBRAINS_AI:END -->

package/templates/ides/REPLIT.md

@@ -1,36 +1,36 @@
-<!-- REPLIT:START -->
-# Replit IDE Rules
-
-**Tool**: Cloud IDE with Ghostwriter AI
-
-## Quick Start
-
-Replit Ghostwriter reads workspace files automatically.
-
-## Usage
-
-```bash
-# In Ghostwriter chat:
-"Follow @AGENTS.md. Implement [feature] with tests."
-
-# Inline completions:
-Accept/reject based on AGENTS.md standards
-```
-
-## Features
-
-- **Ghostwriter Chat**: AI assistant
-- **Inline Completions**: Code suggestions
-- **Explain Code**: AI explanations
-- **Generate Code**: Full implementations
-
-## Workflow
-
-1. Keep AGENTS.md in workspace (Ghostwriter reads it)
-2. Reference `@AGENTS.md` in chat
-3. Review suggestions
-4. Run tests in Replit console
-
-**Critical**: Ghostwriter has workspace context - AGENTS.md is automatically available.
-
-<!-- REPLIT:END -->
+<!-- REPLIT:START -->
+# Replit IDE Rules
+
+**Tool**: Cloud IDE with Ghostwriter AI
+
+## Quick Start
+
+Replit Ghostwriter reads workspace files automatically.
+
+## Usage
+
+```bash
+# In Ghostwriter chat:
+"Follow @AGENTS.md. Implement [feature] with tests."
+
+# Inline completions:
+Accept/reject based on AGENTS.md standards
+```
+
+## Features
+
+- **Ghostwriter Chat**: AI assistant
+- **Inline Completions**: Code suggestions
+- **Explain Code**: AI explanations
+- **Generate Code**: Full implementations
+
+## Workflow
+
+1. Keep AGENTS.md in workspace (Ghostwriter reads it)
+2. Reference `@AGENTS.md` in chat
+3. Review suggestions
+4. Run tests in Replit console
+
+**Critical**: Ghostwriter has workspace context - AGENTS.md is automatically available.
+
+<!-- REPLIT:END -->

package/templates/ides/TABNINE.md

@@ -1,29 +1,29 @@
-<!-- TABNINE:START -->
-# Tabnine AI Rules
-
-**Tool**: Multi-IDE AI completion with team learning
-
-## Quick Start
-
-Works in: VS Code, JetBrains, Vim, Sublime, Atom, Emacs
-
-## Usage
-
-Tabnine learns from your codebase automatically. Keep AGENTS.md in workspace for team learning.
-
-## Features
-
-- **Inline Completions**: AI-powered code suggestions
-- **Team Learning**: Learns from team patterns
-- **Multi-IDE**: Consistent across all editors
-
-## Workflow
-
-1. Keep AGENTS.md in project root
-2. Tabnine learns standards from codebase
-3. Accept/reject suggestions based on AGENTS.md patterns
-4. Team model improves over time
-
-**Critical**: Tabnine learns from existing code - maintain AGENTS.md standards in all files.
-
-<!-- TABNINE:END -->
+<!-- TABNINE:START -->
+# Tabnine AI Rules
+
+**Tool**: Multi-IDE AI completion with team learning
+
+## Quick Start
+
+Works in: VS Code, JetBrains, Vim, Sublime, Atom, Emacs
+
+## Usage
+
+Tabnine learns from your codebase automatically. Keep AGENTS.md in workspace for team learning.
+
+## Features
+
+- **Inline Completions**: AI-powered code suggestions
+- **Team Learning**: Learns from team patterns
+- **Multi-IDE**: Consistent across all editors
+
+## Workflow
+
+1. Keep AGENTS.md in project root
+2. Tabnine learns standards from codebase
+3. Accept/reject suggestions based on AGENTS.md patterns
+4. Team model improves over time
+
+**Critical**: Tabnine learns from existing code - maintain AGENTS.md standards in all files.
+
+<!-- TABNINE:END -->

package/templates/ides/VSCODE.md

@@ -1,40 +1,40 @@
-<!-- VSCODE:START -->
-# VS Code AI Extensions Rules
-
-**IDE**: VS Code with Copilot, Cody, Continue, or other AI extensions
-
-## Quick Start
-
-VS Code reads:
-- `.vscode/settings.json` (generated by `rulebook init`)
-- `.vscode/copilot-instructions.md` (if Copilot enabled)
-
-## Usage
-
-```bash
-# In any AI chat/extension:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Keep AGENTS.md open for context
-# Extensions will reference it automatically
-```
-
-## Supported Extensions
-
-- GitHub Copilot
-- Cody
-- Continue
-- Codeium
-- Tabnine
-- Amazon Q
-
-## Workflow
-
-1. Rulebook generates `.vscode/settings.json` and `copilot-instructions.md`
-2. Keep AGENTS.md open in workspace
-3. Reference `@AGENTS.md` in extension prompts
-4. Extensions read workspace context automatically
-
-**Critical**: Generated settings point extensions to AGENTS.md standards.
-
-<!-- VSCODE:END -->
+<!-- VSCODE:START -->
+# VS Code AI Extensions Rules
+
+**IDE**: VS Code with Copilot, Cody, Continue, or other AI extensions
+
+## Quick Start
+
+VS Code reads:
+- `.vscode/settings.json` (generated by `rulebook init`)
+- `.vscode/copilot-instructions.md` (if Copilot enabled)
+
+## Usage
+
+```bash
+# In any AI chat/extension:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Keep AGENTS.md open for context
+# Extensions will reference it automatically
+```
+
+## Supported Extensions
+
+- GitHub Copilot
+- Cody
+- Continue
+- Codeium
+- Tabnine
+- Amazon Q
+
+## Workflow
+
+1. Rulebook generates `.vscode/settings.json` and `copilot-instructions.md`
+2. Keep AGENTS.md open in workspace
+3. Reference `@AGENTS.md` in extension prompts
+4. Extensions read workspace context automatically
+
+**Critical**: Generated settings point extensions to AGENTS.md standards.
+
+<!-- VSCODE:END -->

package/templates/ides/WINDSURF.md

@@ -1,36 +1,36 @@
-<!-- WINDSURF:START -->
-# Windsurf IDE Rules
-
-**IDE**: AI-powered editor with Cascade AI and Flow State
-
-## Quick Start
-
-Windsurf reads:
-- `.windsurfrules` (generated by `rulebook init`)
-- AGENTS.md (when open in workspace)
-
-## Usage
-
-```bash
-# In Windsurf chat:
-"Follow @AGENTS.md. Implement [feature] with tests."
-
-# Cascade AI:
-Multi-file autonomous mode
-Reference @AGENTS.md for standards
-
-# Flow State:
-Inline suggestions
-Context-aware completions
-```
-
-## Workflow
-
-1. Rulebook generates `.windsurfrules` → points to AGENTS.md
-2. Keep AGENTS.md open in workspace
-3. Use Cascade for complex tasks with `@AGENTS.md` references
-4. Flow State provides inline suggestions
-
-**Critical**: `.windsurfrules` ensures standards are followed automatically.
-
-<!-- WINDSURF:END -->
+<!-- WINDSURF:START -->
+# Windsurf IDE Rules
+
+**IDE**: AI-powered editor with Cascade AI and Flow State
+
+## Quick Start
+
+Windsurf reads:
+- `.windsurfrules` (generated by `rulebook init`)
+- AGENTS.md (when open in workspace)
+
+## Usage
+
+```bash
+# In Windsurf chat:
+"Follow @AGENTS.md. Implement [feature] with tests."
+
+# Cascade AI:
+Multi-file autonomous mode
+Reference @AGENTS.md for standards
+
+# Flow State:
+Inline suggestions
+Context-aware completions
+```
+
+## Workflow
+
+1. Rulebook generates `.windsurfrules` → points to AGENTS.md
+2. Keep AGENTS.md open in workspace
+3. Use Cascade for complex tasks with `@AGENTS.md` references
+4. Flow State provides inline suggestions
+
+**Critical**: `.windsurfrules` ensures standards are followed automatically.
+
+<!-- WINDSURF:END -->

package/templates/ides/WINDSURF_RULES.md

@@ -1,14 +1,14 @@
-<!-- RULEBOOK:START -->
-# Windsurf — Project Rules
-
-You are an AI assistant for this project. Follow these rules:
-
-1. Read AGENTS.md for full project context before starting any task
-2. Never create files in the root unless explicitly asked
-3. All TypeScript must be strict-mode compatible
-4. Write tests for new functionality
-5. Run quality checks before marking work complete
-
-## Project Structure
-Follow the existing directory structure. See AGENTS.md for details.
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# Windsurf — Project Rules
+
+You are an AI assistant for this project. Follow these rules:
+
+1. Read AGENTS.md for full project context before starting any task
+2. Never create files in the root unless explicitly asked
+3. All TypeScript must be strict-mode compatible
+4. Write tests for new functionality
+5. Run quality checks before marking work complete
+
+## Project Structure
+Follow the existing directory structure. See AGENTS.md for details.
+<!-- RULEBOOK:END -->

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