@hivehub/rulebook 4.1.0 → 4.2.0

package/templates/cli/CLAUDE.md

@@ -1,117 +1,117 @@
-<!-- CLAUDE:START -->
-# Claude API/CLI Rules
-
-**Tool**: Anthropic Claude API with 200K context window
-
-## Quick Start
-
-```bash
-export ANTHROPIC_API_KEY=your_key
-# Use via API or compatible CLIs
-```
-
-## Usage
-
-In API requests or CLI prompts, include:
-```
-"Follow these project standards from AGENTS.md:
-[paste relevant AGENTS.md sections]
-
-Implement [feature] with tests first (95%+ coverage)."
-```
-
-## Workflow
-
-1. Include AGENTS.md content in system prompt or context
-2. Request features with standards reference
-3. Review generated code
-4. Run quality checks
-5. Save learnings to persistent memory
-
-**Critical**: Claude has 200K context - paste full AGENTS.md for best results.
-
-## ⚠️ Token Optimization (CRITICAL)
-
-**MINIMIZE unnecessary output to reduce token consumption:**
-
-### DO ✅
-- Output code directly without explanations
-- Use code comments for complex logic instead of markdown
-- Return results concisely: "✅ Done" or "❌ Error: reason"
-- Use tables only when absolutely necessary
-- Combine multiple small outputs into single response
-
-### DON'T ❌
-- **NEVER generate markdown reports or summaries** unless explicitly requested
-- **NEVER use excessive heading levels** (#, ##, ###, etc.)
-- **NEVER create "Quality Checks" sections** with status boxes
-- **NEVER output commit messages verbatim** - just say "committed"
-- **NEVER explain what you did** - assume user knows project structure
-- **NEVER use emoji status lines** (✅ Type check: Passed) - too verbose
-- **NEVER generate "Next Steps" sections** - just do the work
-- **NEVER output implementation details in plain text** - put in code comments
-
-### Example: BAD (Wastes Tokens)
-```
-✅ Implementation Complete
-
-📝 Changes:
-- Added UserService class
-- Added authentication middleware
-- Updated routes configuration
-
-🧪 Quality Checks:
-- ✅ Type check: Passed
-- ✅ Linting: Passed (0 warnings)
-- ✅ Tests: 45/45 passed (100%)
-- ✅ Coverage: 96% (threshold: 95%)
-
-📊 Summary:
-This implementation adds...
-
-Next Steps:
-1. Review the code
-2. Deploy to production
-```
-
-### Example: GOOD (Efficient)
-```
-✅ Done. UserService added with auth middleware.
-```
-
-Put details in code comments, not markdown.
-
-## Persistent Memory Integration
-
-### Search for Past Context
-Before implementing a feature, search memory for similar past work:
-
-```bash
-# Search for past implementations
-rulebook memory search "feature name" --mode hybrid --type feature
-
-# View timeline of related work
-rulebook memory timeline --memoryId <id>
-```
-
-### Save Implementation Insights
-After completing implementation, capture key learnings:
-
-```bash
-# Save feature implementation
-rulebook memory save "Implemented [feature] with [approach]. Key decision: [why]. Gotcha: [edge case]. Pattern: [reusable solution]" --type feature --title "[Feature name]" --tags tag1,tag2
-
-# Save bugfix insights
-rulebook memory save "Fixed [bug] by [solution]. Root cause: [why it happened]. Test case: [added validation]" --type bugfix --title "[Bug description]" --tags bugfix,area
-
-# Save architectural decisions
-rulebook memory save "Chose [approach] over [alternative] because [reasoning]. Tradeoffs: [what was sacrificed]. Future implications: [impact on architecture]" --type decision --title "[Decision name]" --tags architecture,decision
-```
-
-### Use Context from Memory
-When Claude Code returns, your memory system auto-captures learnings. Review and augment:
-1. Search relevant memories: `rulebook memory search "your topic"`
-2. Review 3-layer search results: compact → timeline → full details
-3. Reference past patterns in new implementations
-
-<!-- CLAUDE:END -->
+<!-- CLAUDE:START -->
+# Claude API/CLI Rules
+
+**Tool**: Anthropic Claude API with 200K context window
+
+## Quick Start
+
+```bash
+export ANTHROPIC_API_KEY=your_key
+# Use via API or compatible CLIs
+```
+
+## Usage
+
+In API requests or CLI prompts, include:
+```
+"Follow these project standards from AGENTS.md:
+[paste relevant AGENTS.md sections]
+
+Implement [feature] with tests first (95%+ coverage)."
+```
+
+## Workflow
+
+1. Include AGENTS.md content in system prompt or context
+2. Request features with standards reference
+3. Review generated code
+4. Run quality checks
+5. Save learnings to persistent memory
+
+**Critical**: Claude has 200K context - paste full AGENTS.md for best results.
+
+## ⚠️ Token Optimization (CRITICAL)
+
+**MINIMIZE unnecessary output to reduce token consumption:**
+
+### DO ✅
+- Output code directly without explanations
+- Use code comments for complex logic instead of markdown
+- Return results concisely: "✅ Done" or "❌ Error: reason"
+- Use tables only when absolutely necessary
+- Combine multiple small outputs into single response
+
+### DON'T ❌
+- **NEVER generate markdown reports or summaries** unless explicitly requested
+- **NEVER use excessive heading levels** (#, ##, ###, etc.)
+- **NEVER create "Quality Checks" sections** with status boxes
+- **NEVER output commit messages verbatim** - just say "committed"
+- **NEVER explain what you did** - assume user knows project structure
+- **NEVER use emoji status lines** (✅ Type check: Passed) - too verbose
+- **NEVER generate "Next Steps" sections** - just do the work
+- **NEVER output implementation details in plain text** - put in code comments
+
+### Example: BAD (Wastes Tokens)
+```
+✅ Implementation Complete
+
+📝 Changes:
+- Added UserService class
+- Added authentication middleware
+- Updated routes configuration
+
+🧪 Quality Checks:
+- ✅ Type check: Passed
+- ✅ Linting: Passed (0 warnings)
+- ✅ Tests: 45/45 passed (100%)
+- ✅ Coverage: 96% (threshold: 95%)
+
+📊 Summary:
+This implementation adds...
+
+Next Steps:
+1. Review the code
+2. Deploy to production
+```
+
+### Example: GOOD (Efficient)
+```
+✅ Done. UserService added with auth middleware.
+```
+
+Put details in code comments, not markdown.
+
+## Persistent Memory Integration
+
+### Search for Past Context
+Before implementing a feature, search memory for similar past work:
+
+```bash
+# Search for past implementations
+rulebook memory search "feature name" --mode hybrid --type feature
+
+# View timeline of related work
+rulebook memory timeline --memoryId <id>
+```
+
+### Save Implementation Insights
+After completing implementation, capture key learnings:
+
+```bash
+# Save feature implementation
+rulebook memory save "Implemented [feature] with [approach]. Key decision: [why]. Gotcha: [edge case]. Pattern: [reusable solution]" --type feature --title "[Feature name]" --tags tag1,tag2
+
+# Save bugfix insights
+rulebook memory save "Fixed [bug] by [solution]. Root cause: [why it happened]. Test case: [added validation]" --type bugfix --title "[Bug description]" --tags bugfix,area
+
+# Save architectural decisions
+rulebook memory save "Chose [approach] over [alternative] because [reasoning]. Tradeoffs: [what was sacrificed]. Future implications: [impact on architecture]" --type decision --title "[Decision name]" --tags architecture,decision
+```
+
+### Use Context from Memory
+When Claude Code returns, your memory system auto-captures learnings. Review and augment:
+1. Search relevant memories: `rulebook memory search "your topic"`
+2. Review 3-layer search results: compact → timeline → full details
+3. Reference past patterns in new implementations
+
+<!-- CLAUDE:END -->

package/templates/cli/CLINE.md

@@ -1,99 +1,99 @@
-<!-- CLINE:START -->
-# Cline CLI Rules
-
-**Tool**: VS Code extension with autonomous mode
-
-## Quick Start
-
-Install Cline extension in VS Code or use CLI mode.
-
-## Usage
-
-```bash
-# In prompts, always reference standards:
-"Follow @AGENTS.md. Implement [feature] with tests first (95%+ coverage)."
-
-# Cline will:
-- Read AGENTS.md
-- Write tests
-- Implement feature
-- Run quality checks
-```
-
-## Workflow
-
-1. Keep AGENTS.md open in workspace
-2. Request features with "Follow @AGENTS.md" prefix
-3. Search memory for similar past implementations before starting
-4. Review proposed changes before approval
-5. Verify tests pass after implementation
-6. Save learnings to persistent memory
-
-**Critical**: Reference @AGENTS.md in every prompt for consistent output.
-
-## ⚠️ Token Optimization (CRITICAL)
-
-**Minimize output to reduce token consumption:**
-
-### DO ✅
-- Output code directly
-- Use code comments for explanations
-- Return concise results: "✅ Done" instead of reports
-- Combine multiple small outputs
-
-### DON'T ❌
-- **NEVER generate markdown reports** unless explicitly requested
-- **NEVER use emoji status lines** (✅ Type check: Passed)
-- **NEVER create "Quality Checks" sections** with status boxes
-- **NEVER explain implementation details** in plain text
-- **NEVER add "Next Steps" sections**
-
-**Example**:
-- ❌ BAD: "✅ Type check: Passed. ✅ Linting: 0 warnings. ✅ Tests: 45/45..." (500+ tokens)
-- ✅ GOOD: "✅ Checks pass. Tests: 45/45." (~50 tokens)
-
-## Persistent Memory Integration
-
-### Before Implementation
-Always search for past similar work:
-
-```bash
-# Search for feature implementations
-rulebook memory search "your feature" --mode hybrid
-
-# View specific implementation details
-rulebook memory get <memory-id>
-```
-
-### Prompt Template with Memory
-When requesting a feature, include memory context:
-
-```
-Follow @AGENTS.md and @.rulebook/memory.md.
-
-Similar past implementations from memory:
-[paste relevant memory summaries]
-
-Implement [feature]...
-```
-
-### After Implementation
-Cline's auto-capture may save learnings. Augment with additional context:
-
-```bash
-# Verify auto-captured memory
-rulebook memory search "feature name" --type feature
-
-# Add additional context if needed
-rulebook memory save "Implementation details and patterns..." --type feature --title "Feature name"
-```
-
-## Memory-Aware Development
-
-The memory system provides:
-- **Pattern discovery**: Find reusable solutions from past work
-- **Gotcha avoidance**: Learn from past edge cases
-- **Decision context**: Understand architectural choices
-- **Faster iteration**: Reference proven approaches
-
-<!-- CLINE:END -->
+<!-- CLINE:START -->
+# Cline CLI Rules
+
+**Tool**: VS Code extension with autonomous mode
+
+## Quick Start
+
+Install Cline extension in VS Code or use CLI mode.
+
+## Usage
+
+```bash
+# In prompts, always reference standards:
+"Follow @AGENTS.md. Implement [feature] with tests first (95%+ coverage)."
+
+# Cline will:
+- Read AGENTS.md
+- Write tests
+- Implement feature
+- Run quality checks
+```
+
+## Workflow
+
+1. Keep AGENTS.md open in workspace
+2. Request features with "Follow @AGENTS.md" prefix
+3. Search memory for similar past implementations before starting
+4. Review proposed changes before approval
+5. Verify tests pass after implementation
+6. Save learnings to persistent memory
+
+**Critical**: Reference @AGENTS.md in every prompt for consistent output.
+
+## ⚠️ Token Optimization (CRITICAL)
+
+**Minimize output to reduce token consumption:**
+
+### DO ✅
+- Output code directly
+- Use code comments for explanations
+- Return concise results: "✅ Done" instead of reports
+- Combine multiple small outputs
+
+### DON'T ❌
+- **NEVER generate markdown reports** unless explicitly requested
+- **NEVER use emoji status lines** (✅ Type check: Passed)
+- **NEVER create "Quality Checks" sections** with status boxes
+- **NEVER explain implementation details** in plain text
+- **NEVER add "Next Steps" sections**
+
+**Example**:
+- ❌ BAD: "✅ Type check: Passed. ✅ Linting: 0 warnings. ✅ Tests: 45/45..." (500+ tokens)
+- ✅ GOOD: "✅ Checks pass. Tests: 45/45." (~50 tokens)
+
+## Persistent Memory Integration
+
+### Before Implementation
+Always search for past similar work:
+
+```bash
+# Search for feature implementations
+rulebook memory search "your feature" --mode hybrid
+
+# View specific implementation details
+rulebook memory get <memory-id>
+```
+
+### Prompt Template with Memory
+When requesting a feature, include memory context:
+
+```
+Follow @AGENTS.md and @.rulebook/memory.md.
+
+Similar past implementations from memory:
+[paste relevant memory summaries]
+
+Implement [feature]...
+```
+
+### After Implementation
+Cline's auto-capture may save learnings. Augment with additional context:
+
+```bash
+# Verify auto-captured memory
+rulebook memory search "feature name" --type feature
+
+# Add additional context if needed
+rulebook memory save "Implementation details and patterns..." --type feature --title "Feature name"
+```
+
+## Memory-Aware Development
+
+The memory system provides:
+- **Pattern discovery**: Find reusable solutions from past work
+- **Gotcha avoidance**: Learn from past edge cases
+- **Decision context**: Understand architectural choices
+- **Faster iteration**: Reference proven approaches
+
+<!-- CLINE:END -->

package/templates/cli/CODEBUDDY.md

@@ -1,20 +1,20 @@
-<!-- CODEBUDDY:START -->
-# CodeBuddy Code Rules
-
-**Tool**: Intelligent pair programming assistant
-
-## Usage
-
-Reference AGENTS.md in all requests:
-```
-"Follow @AGENTS.md standards. Implement [feature] with tests first."
-```
-
-## Workflow
-
-1. Include AGENTS.md in context
-2. Request features with standards reference
-3. Review code
-4. Run `npm run lint && npm test`
-
-<!-- CODEBUDDY:END -->
+<!-- CODEBUDDY:START -->
+# CodeBuddy Code Rules
+
+**Tool**: Intelligent pair programming assistant
+
+## Usage
+
+Reference AGENTS.md in all requests:
+```
+"Follow @AGENTS.md standards. Implement [feature] with tests first."
+```
+
+## Workflow
+
+1. Include AGENTS.md in context
+2. Request features with standards reference
+3. Review code
+4. Run `npm run lint && npm test`
+
+<!-- CODEBUDDY:END -->

package/templates/cli/CODEIUM.md

@@ -1,20 +1,20 @@
-<!-- CODEIUM:START -->
-# Codeium CLI/Extension Rules
-
-**Tool**: Free AI coding assistant
-
-## Usage
-
-Reference AGENTS.md in prompts:
-```
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-```
-
-## Workflow
-
-1. Keep AGENTS.md open for context
-2. Use inline suggestions or chat
-3. Review generated code
-4. Run quality checks
-
-<!-- CODEIUM:END -->
+<!-- CODEIUM:START -->
+# Codeium CLI/Extension Rules
+
+**Tool**: Free AI coding assistant
+
+## Usage
+
+Reference AGENTS.md in prompts:
+```
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+```
+
+## Workflow
+
+1. Keep AGENTS.md open for context
+2. Use inline suggestions or chat
+3. Review generated code
+4. Run quality checks
+
+<!-- CODEIUM:END -->

package/templates/cli/CODEX.md

@@ -1,21 +1,21 @@
-<!-- CODEX:START -->
-# Codex (OpenAI) Rules
-
-**Tool**: OpenAI code generation API
-
-## Usage
-
-Include AGENTS.md content in API system prompt:
-```
-System: "Follow these standards: [AGENTS.md content]"
-User: "Implement [feature] with tests (95%+ coverage)."
-```
-
-## Workflow
-
-1. Paste AGENTS.md into system prompt
-2. Request features
-3. Review code
-4. Run quality checks
-
-<!-- CODEX:END -->
+<!-- CODEX:START -->
+# Codex (OpenAI) Rules
+
+**Tool**: OpenAI code generation API
+
+## Usage
+
+Include AGENTS.md content in API system prompt:
+```
+System: "Follow these standards: [AGENTS.md content]"
+User: "Implement [feature] with tests (95%+ coverage)."
+```
+
+## Workflow
+
+1. Paste AGENTS.md into system prompt
+2. Request features
+3. Review code
+4. Run quality checks
+
+<!-- CODEX:END -->

package/templates/cli/CONTINUE.md

@@ -1,34 +1,34 @@
-<!-- CONTINUE:START -->
-# Continue CLI/Extension Rules
-
-**Tool**: Open-source Copilot alternative (VS Code extension + CLI)
-
-## Quick Start
-
-```bash
-# In VS Code: Install Continue extension
-# Or CLI: npm install -g continue-cli
-```
-
-## Usage
-
-```bash
-# Always reference AGENTS.md in prompts:
-"Follow @AGENTS.md standards. Implement [feature] with tests (95%+ coverage)."
-
-# Slash commands:
-/edit    # Edit files
-/chat    # Ask questions
-/cmd     # Run terminal commands
-```
-
-## Workflow
-
-1. Open AGENTS.md in editor for Continue to read
-2. Use `/edit` to modify code following standards
-3. Reference AGENTS.md in every request
-4. Run quality checks after changes
-
-**Critical**: Keep AGENTS.md open or reference it explicitly in prompts.
-
-<!-- CONTINUE:END -->
+<!-- CONTINUE:START -->
+# Continue CLI/Extension Rules
+
+**Tool**: Open-source Copilot alternative (VS Code extension + CLI)
+
+## Quick Start
+
+```bash
+# In VS Code: Install Continue extension
+# Or CLI: npm install -g continue-cli
+```
+
+## Usage
+
+```bash
+# Always reference AGENTS.md in prompts:
+"Follow @AGENTS.md standards. Implement [feature] with tests (95%+ coverage)."
+
+# Slash commands:
+/edit    # Edit files
+/chat    # Ask questions
+/cmd     # Run terminal commands
+```
+
+## Workflow
+
+1. Open AGENTS.md in editor for Continue to read
+2. Use `/edit` to modify code following standards
+3. Reference AGENTS.md in every request
+4. Run quality checks after changes
+
+**Critical**: Keep AGENTS.md open or reference it explicitly in prompts.
+
+<!-- CONTINUE:END -->