@hivehub/rulebook 5.5.2 → 5.7.0

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

@@ -1,65 +0,0 @@
----
-name: "Flutter"
-description: "Language: Dart"
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- FLUTTER:START -->
-# Flutter Framework Rules
-
-**Language**: Dart  
-**Version**: Flutter 3.10+
-
-## Setup
-
-```yaml
-# pubspec.yaml
-dependencies:
-  flutter:
-    sdk: flutter
-  cupertino_icons: ^1.0.2
-
-dev_dependencies:
-  flutter_test:
-    sdk: flutter
-  flutter_lints: ^2.0.0
-```
-
-## Quality Gates
-
-```bash
-dart format --set-exit-if-changed .
-dart analyze --fatal-infos
-flutter test
-flutter build apk --release  # Test build
-```
-
-## Best Practices
-
-✅ Use StatelessWidget when possible  
-✅ Implement proper state management (Provider, Riverpod, Bloc)  
-✅ Use const constructors  
-✅ Optimize widget rebuilds  
-✅ Test on multiple devices  
-
-❌ Don't use `print()` in production  
-❌ Don't skip null safety  
-❌ Don't ignore platform differences  
-
-## Project Structure
-
-```
-lib/
-├── main.dart
-├── models/
-├── screens/
-├── widgets/
-└── services/
-```
-
-<!-- FLUTTER:END -->
-

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

@@ -1,42 +0,0 @@
----
-name: "jQuery"
-description: "Language: JavaScript"
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- JQUERY:START -->
-# jQuery Framework Rules
-
-**Language**: JavaScript  
-**Version**: jQuery 3.x+
-
-## Setup
-
-```html
-<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
-```
-
-## Best Practices
-
-✅ Use modern JS alongside jQuery  
-✅ Minimize DOM manipulation  
-✅ Cache jQuery selectors  
-✅ Use event delegation  
-
-❌ Don't use jQuery for everything  
-❌ Don't pollute global scope  
-❌ Don't skip CSP headers  
-
-## Quality Gates
-
-```bash
-eslint src/**/*.js
-jest
-```
-
-<!-- JQUERY:END -->
-

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

@@ -1,48 +0,0 @@
----
-name: "Laravel"
-description: "Laravel services must respect these conventions and quality checks."
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- LARAVEL:START -->
-# Laravel Framework Rules
-
-**CRITICAL**: Laravel services must respect these conventions and quality checks.
-
-## Quality Commands
-- Static analysis: `./vendor/bin/pint --test`
-- Lint style: `./vendor/bin/phpcs --standard=PSR12 app/`
-- Unit tests: `php artisan test`
-- Feature tests: `php artisan test --testsuite=Feature`
-- Coverage: ensure `php artisan test --coverage` ≥ 80%
-
-## Project Structure
-- Keep HTTP controllers in `app/Http/Controllers`
-- Use form requests for validation in `app/Http/Requests`
-- Organize business logic in `app/Services`
-- Leverage repositories for data persistence where appropriate
-- Store queued jobs in `app/Jobs`
-
-## Implementation Guidelines
-- Use migrations for every schema change (`php artisan make:migration`)
-- Keep Eloquent models lean; move heavy logic into services
-- Cache configuration after deployment (`php artisan config:cache`)
-- Register scheduled tasks in `app/Console/Kernel.php`
-- Ensure `app/Providers` registers new bindings/events
-
-## Composer Hygiene
-```bash
-composer install --no-dev --prefer-dist
-composer dump-autoload
-```
-
-## Additional Checks
-- Sync `.env.example` whenever new variables are introduced
-- Document API changes in `/docs/laravel-api.md`
-- Generate API resources via `php artisan make:resource`
-
-<!-- LARAVEL:END -->

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

@@ -1,53 +0,0 @@
----
-name: "NestJS"
-description: "Align all NestJS services, modules, and controllers with these conventions."
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- NESTJS:START -->
-# NestJS Framework Rules
-
-**CRITICAL**: Align all NestJS services, modules, and controllers with these conventions.
-
-## Project Structure
-- Maintain feature-first modules under `src/<feature>/`
-- Keep global providers in `src/common/`
-- Register new modules in `AppModule` and ensure dependency injection consistency
-- Prefer `@nestjs/config` for environment configuration
-
-## Quality Gates
-- Lint: `npm run lint`
-- Unit tests: `npm run test`
-- e2e tests: `npm run test:e2e`
-- Build validation: `npm run build`
-- Coverage threshold: **80%+** for service and controller layers
-
-## Implementation Guidelines
-- Use DTOs with `class-validator` and `class-transformer`
-- Encapsulate database access in providers (avoid direct repository use in controllers)
-- Document routes with `@nestjs/swagger` when OpenAPI is enabled
-- Keep asynchronous logic wrapped with `try/catch` and map errors to HTTP exceptions
-
-## Scripts to Run Before Commit
-```bash
-npm run lint
-npm run test
-npm run test:e2e
-npm run build
-```
-
-## Additional Checks
-- Ensure Circular Dependency detection is clean (`npm run lint -- --max-warnings=0`)
-- Synchronize `.env.example` with actual required variables
-- Maintain aligned versions for Nest core packages (`@nestjs/*`)
-
-## Documentation
-- Update `/docs/architecture.md` with new modules and providers
-- Keep OpenAPI spec regenerated via `npm run swagger:generate`
-- Log breaking changes in `CHANGELOG.md`
-
-<!-- NESTJS:END -->

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

@@ -1,137 +0,0 @@
----
-name: "Next.js"
-description: "Language: TypeScript, JavaScript"
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- NEXTJS:START -->
-# Next.js Framework Rules
-
-**Language**: TypeScript, JavaScript  
-**Version**: Next.js 14+ (App Router)
-
-## Setup & Configuration
-
-```typescript
-// next.config.ts
-import type { NextConfig } from 'next'
-
-const nextConfig: NextConfig = {
-  reactStrictMode: true,
-  images: {
-    domains: ['your-domain.com'],
-  },
-  env: {
-    CUSTOM_KEY: process.env.CUSTOM_KEY,
-  },
-}
-
-export default nextConfig
-```
-
-## Quality Gates
-
-```bash
-# Type check
-npm run type-check  # or: tsc --noEmit
-
-# Lint
-npm run lint        # Next.js ESLint
-
-# Format
-npx prettier --check "**/*.{ts,tsx}"
-
-# Tests
-npm test            # Vitest or Jest
-
-# Build
-npm run build       # Must succeed
-
-# Check bundle size
-npm run build && npx @next/bundle-analyzer
-```
-
-## Best Practices
-
-✅ **DO:**
-- Use App Router (app/) for new projects
-- Implement Server Components by default
-- Use Client Components ('use client') only when needed
-- Optimize images with next/image
-- Use dynamic imports for code splitting
-- Implement proper metadata/SEO
-- Use Server Actions for mutations
-- Enable React Strict Mode
-
-❌ **DON'T:**
-- Use getServerSideProps/getStaticProps in App Router
-- Fetch on client when server fetch is better
-- Skip image optimization
-- Ignore bundle size
-- Use 'use client' everywhere
-- Hardcode API URLs
-- Skip error boundaries
-
-## Project Structure (App Router)
-
-```
-app/
-├── layout.tsx         # Root layout
-├── page.tsx           # Home page
-├── (routes)/
-│   ├── dashboard/
-│   │   ├── layout.tsx
-│   │   └── page.tsx
-│   └── api/
-│       └── users/
-│           └── route.ts
-├── components/
-├── lib/
-└── types/
-```
-
-## Server vs Client Components
-
-```typescript
-// Server Component (default)
-async function ServerComponent() {
-  const data = await fetch('https://api.example.com/data')
-  return <div>{data}</div>
-}
-
-// Client Component
-'use client'
-import { useState } from 'react'
-
-function ClientComponent() {
-  const [count, setCount] = useState(0)
-  return <button onClick={() => setCount(count + 1)}>{count}</button>
-}
-```
-
-## Route Handlers (API Routes)
-
-```typescript
-// app/api/users/route.ts
-import { NextRequest, NextResponse } from 'next/server'
-
-export async function GET(request: NextRequest) {
-  const searchParams = request.nextUrl.searchParams
-  const id = searchParams.get('id')
-  
-  return NextResponse.json({ id })
-}
-
-export async function POST(request: NextRequest) {
-  const body = await request.json()
-  // Handle POST
-  return NextResponse.json({ success: true })
-}
-```
-
-<!-- NEXTJS:END -->
-

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

@@ -1,50 +0,0 @@
----
-name: "Nuxt"
-description: "Nuxt 3 applications must keep these standards to ensure SSR quality."
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- NUXT:START -->
-# Nuxt Framework Rules
-
-**CRITICAL**: Nuxt 3 applications must keep these standards to ensure SSR quality.
-
-## Quality Commands
-- Lint: `npm run lint`
-- Type check: `npm run type-check`
-- Unit tests: `npm run test`
-- Build for production: `npm run build`
-- Generate static output (if applicable): `npm run generate`
-
-## Project Structure
-- Define routes with file-based routing under `pages/`
-- Keep server API handlers within `server/api/`
-- Organize composables in `composables/`
-- Place reusable UI components in `components/`
-- Store state via Pinia modules in `stores/`
-
-## Implementation Guidelines
-- Use runtime config via `useRuntimeConfig()` for secrets
-- SSR-safe operations only inside `onServerPrefetch`/server routes
-- Prefer `definePageMeta` to control page-level features
-- Maintain i18n messages in `/locales`
-- Cache heavy computations with Nitro storage if needed
-
-## Pre-Commit Commands
-```bash
-npm run lint
-npm run type-check
-npm run test
-npm run build
-```
-
-## Documentation
-- Keep `/docs/nuxt-architecture.md` current with route layout and middleware
-- Document server API contracts in `/docs/api.md`
-- Capture deployment steps (SSR vs static) in `/docs/deployment.md`
-
-<!-- NUXT:END -->

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

@@ -1,76 +0,0 @@
----
-name: "Rails"
-description: "Language: Ruby"
-version: "1.0.0"
-category: "frameworks"
-author: "Rulebook"
-tags: ["frameworks", "framework"]
-dependencies: []
-conflicts: []
----
-<!-- RAILS:START -->
-# Ruby on Rails Framework Rules
-
-**Language**: Ruby  
-**Version**: Rails 7.0+
-
-## Setup & Configuration
-
-```ruby
-# config/database.yml
-production:
-  url: <%= ENV['DATABASE_URL'] %>
-
-# config/environments/production.rb
-config.force_ssl = true
-config.log_level = :info
-```
-
-## Quality Gates
-
-```bash
-# Code quality
-bundle exec rubocop             # Lint
-bundle exec brakeman           # Security scan
-
-# Tests
-bundle exec rspec              # Run tests
-bundle exec rspec --format documentation  # Verbose
-
-# Type check (optional)
-bundle exec steep check        # Static typing
-```
-
-## Best Practices
-
-✅ **DO:**
-- Use strong parameters
-- Implement authentication (Devise/custom)
-- Use ActiveRecord callbacks sparingly
-- Write RSpec/Minitest tests
-- Use database migrations
-- Enable CSRF protection
-
-❌ **DON'T:**
-- Skip validations in models
-- Use `params` without permit
-- Store secrets in code
-- Skip database indexes
-- Ignore N+1 queries
-
-## Project Structure
-
-```
-app/
-├── controllers/
-├── models/
-├── views/
-├── jobs/
-└── mailers/
-config/
-db/
-spec/
-```
-
-<!-- RAILS:END -->
-

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

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

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