@hivehub/rulebook 4.0.0 → 4.2.0

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

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

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

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

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

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

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