@hivehub/rulebook 2.1.0 → 3.0.0

package/templates/skills/frameworks/react/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: "React"
+description: "React applications must comply with these quality bars."
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- REACT:START -->
+# React Framework Rules
+
+**CRITICAL**: React applications must comply with these quality bars.
+
+## Quality Commands
+- Lint & type check: `npm run lint` + `npm run type-check`
+- Unit/integration tests: `npm run test -- --watch=false`
+- Build: `npm run build`
+- Bundle analysis (optional): `npm run analyze`
+
+## Project Structure
+- Group features under `src/features/<name>/`
+- Maintain shared UI primitives in `src/components`
+- Keep hooks in `src/hooks`
+- Centralize state management in `src/state` (Redux/Zustand/Recoil)
+
+## Implementation Guidelines
+- Use TypeScript everywhere (no implicit `any`)
+- Prefer functional components with hooks
+- Co-locate component tests as `<Component>.test.tsx`
+- Use React Query/SWR for server state, keep caches invalidated on mutations
+- Wrap new pages with error boundaries and suspense where needed
+
+## Pre-Commit Checklist
+```bash
+npm run lint
+npm run type-check
+npm run test -- --watch=false
+npm run build
+```
+
+## Documentation
+- Update `/docs/react-architecture.md` when routes or global providers change
+- Record reusable components in Storybook or `/docs/ui-components.md`
+- Capture performance regressions in `/docs/performance.md`
+
+<!-- REACT:END -->

package/templates/skills/frameworks/react-native/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: "React Native"
+description: "Language: JavaScript, TypeScript"
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- REACT_NATIVE:START -->
+# React Native Framework Rules
+
+**Language**: JavaScript, TypeScript  
+**Version**: React Native 0.72+
+
+## Setup
+
+```bash
+npx react-native init MyApp --template react-native-template-typescript
+```
+
+## Quality Gates
+
+```bash
+npm run lint
+npm run type-check
+npm test
+npm run android  # Test build
+npm run ios      # Test build
+```
+
+## Best Practices
+
+✅ Use TypeScript  
+✅ Implement proper navigation (React Navigation)  
+✅ Use platform-specific code when needed  
+✅ Optimize images and assets  
+✅ Test on both iOS and Android  
+
+❌ Don't hardcode dimensions  
+❌ Don't skip accessibility  
+❌ Don't ignore memory leaks  
+
+## Project Structure
+
+```
+src/
+├── components/
+├── screens/
+├── navigation/
+├── services/
+└── utils/
+```
+
+<!-- REACT_NATIVE:END -->
+

package/templates/skills/frameworks/spring/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: "Spring"
+description: "Every Spring service must satisfy these quality gates before merge."
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- SPRING:START -->
+# Spring Boot Framework Rules
+
+**CRITICAL**: Every Spring service must satisfy these quality gates before merge.
+
+## Build & Quality Commands
+- Lint/format: `./gradlew checkstyleMain` or `mvn verify`
+- Unit tests: `./gradlew test` or `mvn test`
+- Integration tests: `./gradlew integrationTest` (if module exists)
+- Static analysis: `./gradlew jacocoTestReport` to ensure 80%+ coverage
+
+## Project Structure
+- Keep domain logic in `src/main/java/.../service`
+- Expose REST controllers in `controller` packages
+- Isolate configuration classes under `config`
+- Share DTOs via `dto` package and map with MapStruct where applicable
+
+## Implementation Guidelines
+- Manage configuration with `application.yml` profiles (dev/test/prod)
+- Prefer constructor injection, avoid `@Autowired` field injection
+- Wrap transactional operations with `@Transactional`
+- Use `ResponseEntity` for explicit HTTP semantics
+- Validate inputs using `javax.validation` annotations and `@Valid`
+
+## Build Matrix
+```bash
+# Gradle
+./gradlew clean check
+
+# Maven
+mvn -B clean verify
+```
+
+## Additional Checks
+- Ensure `application.yml` contains defaults for new properties
+- Update Flyway/Liquibase migrations when schema changes
+- Keep `README` and `/docs/architecture.md` synced with new services
+
+<!-- SPRING:END -->

package/templates/skills/frameworks/symfony/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: "Symfony"
+description: "Language: PHP"
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- SYMFONY:START -->
+# Symfony Framework Rules
+
+**Language**: PHP  
+**Version**: Symfony 6.0+ or 7.0+
+
+## Setup
+
+```yaml
+# config/packages/framework.yaml
+framework:
+    secret: '%env(APP_SECRET)%'
+    csrf_protection: true
+```
+
+## Quality Gates
+
+```bash
+php bin/console lint:twig templates/
+php bin/console lint:yaml config/
+vendor/bin/phpstan analyze src tests
+vendor/bin/phpunit
+```
+
+## Best Practices
+
+✅ Use dependency injection  
+✅ Follow PSR standards  
+✅ Use Doctrine ORM  
+✅ Implement security voters  
+
+❌ Don't bypass security  
+❌ Don't hardcode routes  
+
+<!-- SYMFONY:END -->
+

package/templates/skills/frameworks/vue/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: "Vue"
+description: "Vue 3 projects should follow these guardrails."
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- VUE:START -->
+# Vue Framework Rules
+
+**CRITICAL**: Vue 3 projects should follow these guardrails.
+
+## Quality Commands
+- Lint: `npm run lint`
+- Unit tests: `npm run test:unit`
+- e2e tests (Cypress/Playwright): `npm run test:e2e`
+- Build: `npm run build`
+
+## Project Structure
+- Place feature modules in `src/modules/<feature>/`
+- Keep reusable components in `src/components`
+- Shared composables go in `src/composables`
+- Centralize Pinia/Vuex stores under `src/stores`
+
+## Implementation Guidelines
+- Adopt `<script setup>` with TypeScript and define props via `defineProps`
+- Leverage `defineEmits` for typed event emission
+- Lazy-load routes with dynamic imports in `router/index.ts`
+- Ensure global styles scoped via `:global` or dedicated CSS files
+
+## Pre-Commit Commands
+```bash
+npm run lint
+npm run test:unit
+npm run build
+```
+
+## Documentation
+- Update `/docs/vue-architecture.md` with module tree changes
+- Document composables in `/docs/composables.md`
+- Add component usage examples to `/docs/ui-components.md`
+
+<!-- VUE:END -->

package/templates/skills/frameworks/zend/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: "Zend"
+description: "Language: PHP"
+version: "1.0.0"
+category: "frameworks"
+author: "Rulebook"
+tags: ["frameworks", "framework"]
+dependencies: []
+conflicts: []
+---
+<!-- ZEND:START -->
+# Zend/Laminas Framework Rules
+
+**Language**: PHP  
+**Version**: Laminas MVC 3.x+
+
+## Setup
+
+```php
+// config/modules.config.php
+return [
+    'Laminas\Router',
+    'Application',
+];
+```
+
+## Quality Gates
+
+```bash
+vendor/bin/phpcs --standard=PSR12 src/
+vendor/bin/phpstan analyze
+vendor/bin/phpunit
+```
+
+## Best Practices
+
+✅ Use service manager  
+✅ Implement middleware  
+✅ Use form validation  
+
+❌ Don't skip CSRF tokens  
+❌ Don't expose errors in production  
+
+<!-- ZEND:END -->
+

package/templates/skills/ides/copilot/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: "Copilot"
+description: "Tool: GitHub's AI pair programmer (inline + chat)"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- COPILOT:START -->
+# GitHub Copilot Rules
+
+**Tool**: GitHub's AI pair programmer (inline + chat)
+
+## Quick Start
+
+Copilot reads:
+- `.github/copilot-instructions.md` (generated by `rulebook init`)
+- Workspace context (open files)
+
+## Usage
+
+```bash
+# In Copilot Chat:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Inline suggestions:
+Accept/reject based on AGENTS.md standards
+```
+
+## Modes
+
+**Inline Completions**: Context-aware suggestions while typing
+**Copilot Chat**: Ask questions, request implementations
+**Workspace Agent** (Labs): Multi-file autonomous mode
+
+## Workflow
+
+1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
+2. Keep AGENTS.md open for context
+3. Use `@workspace` to include project context
+4. Reference `@AGENTS.md` explicitly in chat
+
+**Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
+
+<!-- COPILOT:END -->

package/templates/skills/ides/cursor/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: "Cursor"
+description: "IDE: AI-first code editor with Agent mode and Composer"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- CURSOR:START -->
+# Cursor IDE Rules
+
+**IDE**: AI-first code editor with Agent mode and Composer
+
+## Quick Start
+
+Cursor automatically reads:
+- `.cursorrules` (generated by `rulebook init`)
+- `AGENTS.md` (via `@AGENTS.md` references)
+
+## Usage
+
+```bash
+# In Cursor chat/composer:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Agent mode (Ctrl+Shift+K):
+Use for complex multi-file changes
+Reference @AGENTS.md for standards
+
+# Composer (Cmd+I):
+Use for quick edits
+Reference @AGENTS.md when needed
+```
+
+## Features
+
+- **Auto-context**: Reads .cursorrules automatically
+- **@ Mentions**: Use `@AGENTS.md` to include standards
+- **Agent Mode**: Autonomous multi-step implementations
+- **Composer**: Quick inline edits
+
+## Workflow
+
+1. Rulebook generates `.cursorrules` pointing to AGENTS.md
+2. Use `@AGENTS.md` in prompts for explicit reference
+3. Agent/Composer follows standards automatically
+4. Review changes and run quality checks
+
+**Critical**: `.cursorrules` ensures Cursor follows AGENTS.md by default.
+
+<!-- CURSOR:END -->

package/templates/skills/ides/jetbrains-ai/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: "JetBrains AI"
+description: "IDEs: IntelliJ, PyCharm, WebStorm, GoLand, RustRover, Rider, CLion, PhpStorm"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/ides/replit/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: "Replit"
+description: "Tool: Cloud IDE with Ghostwriter AI"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/ides/tabnine/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: "Tabnine"
+description: "Tool: Multi-IDE AI completion with team learning"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/ides/vscode/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: "VS Code"
+description: "IDE: VS Code with Copilot, Cody, Continue, or other AI extensions"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/ides/windsurf/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: "Windsurf"
+description: "IDE: AI-powered editor with Cascade AI and Flow State"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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/skills/ides/zed/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: "Zed"
+description: "Tool: High-performance collaborative editor (Rust-powered)"
+version: "1.0.0"
+category: "ides"
+author: "Rulebook"
+tags: ["ides", "ide"]
+dependencies: []
+conflicts: []
+---
+<!-- 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 -->