@hivehub/rulebook 2.1.0 → 3.0.0

package/templates/skills/cli/codeium/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: "Codeium"
+description: "Tool: Free AI coding assistant"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/cli/codex/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: "Codex"
+description: "Tool: OpenAI code generation API"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/cli/continue/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: "Continue"
+description: "Tool: Open-source Copilot alternative (VS Code extension + CLI)"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- 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 -->

package/templates/skills/cli/cursor-cli/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: "Cursor CLI"
+description: "Tool: Cursor IDE automation and scripting"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- CURSOR_CLI:START -->
+# Cursor CLI Rules
+
+**Tool**: Cursor IDE automation and scripting
+
+## Quick Start
+
+```bash
+# Cursor reads .cursorrules automatically
+# This file is generated by rulebook init
+```
+
+## Usage
+
+Cursor automatically references:
+- `.cursorrules` (generated by rulebook)
+- `AGENTS.md` (via @AGENTS.md references)
+
+## Workflow
+
+1. Use `@AGENTS.md` in chat to reference standards
+2. Request: "Follow @AGENTS.md. Implement [feature] with tests."
+3. Cursor respects .cursorrules and AGENTS.md automatically
+4. Review and accept changes
+
+**Critical**: Generated `.cursorrules` points to AGENTS.md. Use @ mentions for explicit references.
+
+<!-- CURSOR_CLI:END -->

package/templates/skills/cli/factory/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: "Factory"
+description: "Tool: Code generation and automation"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- FACTORY:START -->
+# Factory Droid Rules
+
+**Tool**: Code generation and automation
+
+## Usage
+
+```
+"Follow @AGENTS.md standards. Generate [code] with tests."
+```
+
+## Workflow
+
+1. Reference AGENTS.md in prompts
+2. Review generated code
+3. Run quality checks
+
+<!-- FACTORY:END -->

package/templates/skills/cli/gemini/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: "Gemini CLI"
+description: "Tool: Google Gemini API with 2M token context"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- GEMINI:START -->
+# Gemini CLI Rules
+
+**Tool**: Google Gemini API with 2M token context
+
+## Quick Start
+
+```bash
+# Install gemini CLI
+npm install -g @google/generative-ai-cli
+
+# Set API key
+export GEMINI_API_KEY=your_key
+```
+
+## Usage
+
+```bash
+# Always reference AGENTS.md:
+gemini --prompt "Read @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Include files:
+gemini --files AGENTS.md,src/feature.ts
+```
+
+## Workflow
+
+1. Include AGENTS.md in context with `--files AGENTS.md`
+2. Request: "Follow @AGENTS.md. Implement [feature] with tests."
+3. Review output
+4. Run quality checks: `npm run lint && npm test`
+
+**Critical**: Reference @AGENTS.md for consistent code generation.
+
+<!-- GEMINI:END -->

package/templates/skills/cli/kilocode/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: "Kilocode"
+description: "Tool: Lightweight coding companion"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- KILOCODE:START -->
+# Kilo Code Rules
+
+**Tool**: Lightweight coding companion
+
+## Usage
+
+```
+"Follow @AGENTS.md. Implement [feature] with tests."
+```
+
+## Workflow
+
+1. Reference AGENTS.md
+2. Review code
+3. Run quality checks
+
+<!-- KILOCODE:END -->

package/templates/skills/cli/opencode/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: "Opencode"
+description: "Tool: Open-source AI assistant"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- OPENCODE:START -->
+# OpenCode Rules
+
+**Tool**: Open-source AI assistant
+
+## Usage
+
+```
+"Follow @AGENTS.md. Implement [feature] with tests."
+```
+
+## Workflow
+
+1. Reference AGENTS.md
+2. Review code
+3. Run quality checks
+
+<!-- OPENCODE:END -->

package/templates/skills/core/agent-automation/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: "Agent Automation"
+description: "Mandatory workflow that AI agents MUST execute after EVERY implementation."
+version: "1.0.0"
+category: "core"
+author: "Rulebook"
+tags: ["core"]
+dependencies: []
+conflicts: []
+---
+<!-- AGENT_AUTOMATION:START -->
+# Agent Automation Rules
+
+**CRITICAL**: Mandatory workflow that AI agents MUST execute after EVERY implementation.
+
+## Workflow Overview
+
+After completing ANY feature, bug fix, or code change, execute this workflow in order:
+
+### Step 1: Quality Checks (MANDATORY)
+
+Run these checks in order - ALL must pass:
+
+```bash
+1. Type check (if applicable)
+2. Lint (MUST pass with ZERO warnings)
+3. Format code
+4. Run ALL tests (MUST pass 100%)
+5. Verify coverage meets threshold (default 95%)
+```
+
+**Language-specific commands**: See your language template (TYPESCRIPT, RUST, PYTHON, etc.) for exact commands.
+
+**IF ANY CHECK FAILS:**
+- ❌ STOP immediately
+- ❌ DO NOT proceed
+- ❌ DO NOT commit
+- ✅ Fix the issue first
+- ✅ Re-run ALL checks
+
+### Step 2: Security & Dependency Audits
+
+```bash
+# Check for vulnerabilities (language-specific)
+# Check for outdated dependencies (informational)
+# Find unused dependencies (optional)
+```
+
+**Language-specific commands**: See your language template for audit commands.
+
+**IF VULNERABILITIES FOUND:**
+- ✅ Attempt automatic fix
+- ✅ Document if auto-fix fails
+- ✅ Include in Step 5 report
+- ❌ Never ignore critical/high vulnerabilities without user approval
+
+### Step 3: Update OpenSpec Tasks
+
+If `openspec/` directory exists:
+
+```bash
+# Mark completed tasks as [DONE]
+# Update in-progress tasks
+# Add new tasks if discovered
+# Update progress percentages
+# Document deviations or blockers
+```
+
+### Step 4: Update Documentation
+
+```bash
+# Update ROADMAP.md (if feature is milestone)
+# Update CHANGELOG.md (conventional commits format)
+# Update feature specs (if implementation differs)
+# Update README.md (if public API changed)
+```
+
+### Step 5: Git Commit
+
+**ONLY after ALL above steps pass:**
+
+**⚠️ CRITICAL: All commit messages MUST be in English**
+
+```bash
+git add .
+git commit -m "<type>(<scope>): <description>
+
+- Detailed change 1
+- Detailed change 2
+- Tests: [describe coverage]
+- Coverage: X% (threshold: 95%)
+
+Closes #<issue> (if applicable)"
+```
+
+**Commit Types**: `feat`, `fix`, `docs`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`
+
+**Language Requirement**: Commit messages must be written in English. Never use Portuguese, Spanish, or any other language.
+
+### Step 6: Report to User
+
+```
+✅ Implementation Complete
+
+📝 Changes:
+- [List main changes]
+
+🧪 Quality Checks:
+- ✅ Type check: Passed
+- ✅ Linting: Passed (0 warnings)
+- ✅ Formatting: Applied
+- ✅ Tests: X/X passed (100%)
+- ✅ Coverage: X% (threshold: 95%)
+
+🔒 Security:
+- ✅ No vulnerabilities
+
+📊 OpenSpec:
+- ✅ Tasks updated
+- ✅ Progress: X% → Y%
+
+📚 Documentation:
+- ✅ CHANGELOG.md updated
+- ✅ [other docs updated]
+
+💾 Git:
+- ✅ Committed: <commit message>
+- ✅ Hash: <commit hash>
+
+📋 Next Steps:
+- [ ] Review changes
+- [ ] Push to remote (if ready)
+```
+
+## Automation Exceptions
+
+Skip steps ONLY when:
+
+1. **Exploratory Code**: User says "experimental", "draft", "try"
+   - Still run quality checks
+   - Don't commit
+
+2. **User Explicitly Requests**: User says "skip tests", "no commit"
+   - Only skip requested step
+   - Warn about skipped steps
+
+3. **Emergency Hotfix**: Critical production bug
+   - Run minimal checks
+   - Document technical debt
+
+**In ALL other cases: Execute complete workflow**
+
+## Error Recovery
+
+If workflow fails 3+ times:
+
+```bash
+1. Create backup branch
+2. Reset to last stable commit
+3. Report to user with error details
+4. Request guidance or try alternative approach
+```
+
+## Best Practices
+
+### DO's ✅
+- ALWAYS run complete workflow
+- ALWAYS update OpenSpec and documentation
+- ALWAYS use conventional commits
+- ALWAYS report summary to user
+- ASK before skipping steps
+
+### DON'Ts ❌
+- NEVER skip quality checks without permission
+- NEVER commit failing tests
+- NEVER commit linting errors
+- NEVER skip documentation updates
+- NEVER assume user wants to skip automation
+- NEVER commit debug code or secrets
+
+## Summary
+
+**Complete workflow after EVERY implementation:**
+
+1. ✅ Quality checks (type, lint, format, test, coverage)
+2. ✅ Security audit
+3. ✅ Update OpenSpec tasks
+4. ✅ Update documentation
+5. ✅ Git commit (conventional format)
+6. ✅ Report summary to user
+
+**Only skip with explicit user permission and document why.**
+
+<!-- AGENT_AUTOMATION:END -->