@hivehub/rulebook 5.5.2 → 5.8.0

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

@@ -1,30 +1,30 @@
----
-name: "Codebuddy"
-description: "Tool: Intelligent pair programming assistant"
-version: "1.0.0"
-category: "cli"
-author: "Rulebook"
-tags: ["cli", "cli-tool"]
-dependencies: []
-conflicts: []
----
-<!-- 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 -->
+---
+name: "Codebuddy"
+description: "Tool: Intelligent pair programming assistant"
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "cli-tool"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/cli/codeium/SKILL.md

@@ -1,30 +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 -->
+---
+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

@@ -1,31 +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 -->
+---
+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

@@ -1,44 +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 -->
+---
+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

@@ -1,38 +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 -->
+---
+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

@@ -1,28 +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 -->
+---
+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

@@ -1,45 +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 -->
+---
+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

@@ -1,28 +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 -->
+---
+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

@@ -1,28 +1,82 @@
----
-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 -->
+---
+name: "Opencode"
+description: "OpenCode (open-source terminal coding agent by SST). Reads AGENTS.md natively. Rulebook generates opencode.json plus .opencode/commands, .opencode/agents, .opencode/skills."
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "opencode", "agents", "mcp"]
+dependencies: []
+conflicts: []
+---
+<!-- OPENCODE:START -->
+# OpenCode Rules
+
+**Tool**: [OpenCode](https://opencode.ai) — open-source terminal coding agent.
+
+## Generated surface area
+
+When Rulebook detects OpenCode (`opencode.json` / `.opencode/` / `opencode`
+binary on PATH), it generates:
+
+- `opencode.json` with `$schema`, `mcp.rulebook`, and `instructions`.
+  Existing user keys (model, theme, permission, custom agents) are preserved.
+- `.opencode/commands/<name>.md` for every user-invocable Rulebook slash
+  command, with OpenCode-shaped frontmatter (`description`).
+- `.opencode/agents/<role>.md` for every Rulebook role agent
+  (researcher, implementer, tester, code-reviewer, architect, docs-writer,
+  security-reviewer, build-engineer, team-lead, etc.) with model tier
+  mapped (`haiku → claude-haiku-4-5`, `sonnet → claude-sonnet-4-6`,
+  `opus → claude-opus-4-7`) and a synthesized `permission` block.
+- `.opencode/skills/<normalized-name>/SKILL.md` for every Rulebook dev
+  skill, name-normalized to `[a-z0-9](-[a-z0-9])*` (≤64 chars) and
+  description bounded to ≤1024 chars.
+- `.opencode/.rulebook-managed.json` — sidecar listing managed keys so
+  `rulebook update` knows what to refresh vs. preserve.
+
+## Idempotency
+
+Files carrying the `<!-- RULEBOOK:START -->` marker are managed and
+refreshed on every `rulebook update`. Files without the marker are
+treated as user-owned and left untouched.
+
+## Sequential editing
+
+OpenCode follows the same Rulebook discipline as Claude Code:
+
+- Edit files one at a time.
+- For 3+ files, decompose into 1–2 file sub-tasks.
+- Diagnostic-first: type-check / lint before tests.
+
+## Quality gates
+
+- Type-check / lint must be clean.
+- Tests must pass.
+- Coverage ≥95%.
+- Pre-commit hooks enforce these — never `--no-verify`.
+
+## MCP
+
+`mcp.rulebook` in `opencode.json` exposes `rulebook_task_*`,
+`rulebook_memory_*`, `rulebook_decision_*`, `rulebook_knowledge_*`,
+`rulebook_learn_*`. Prefer MCP tools over shell commands when both
+exist.
+
+## Workflow
+
+1. Reference `AGENTS.md` and `.rulebook/specs/*.md`.
+2. Use `/rulebook-task-create`, `/rulebook-task-list`, `/handoff`.
+3. Delegate to role agents (`@researcher`, `@implementer`, `@tester`).
+4. Run quality checks before committing.
+5. Save learnings (`rulebook_memory_save`, `rulebook_knowledge_add`).
+
+## Documentation
+
+- [opencode.ai/docs/rules](https://opencode.ai/docs/rules/)
+- [opencode.ai/docs/config](https://opencode.ai/docs/config/)
+- [opencode.ai/docs/mcp-servers](https://opencode.ai/docs/mcp-servers/)
+- [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)
+- [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
+- [opencode.ai/docs/skills](https://opencode.ai/docs/skills/)
+- [opencode.ai/docs/permissions](https://opencode.ai/docs/permissions/)
+
+<!-- OPENCODE:END -->