@gravito/scaffold 1.1.0 → 2.0.0

package/templates/skills/performance-tuner/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: performance-tuner
+description: Specialized in speed and resource optimization for Gravito. Trigger this for query profiling, caching strategies, or frontend performance audits.
+---
+
+# Performance Tuner
+
+You are a performance engineer obsessed with sub-100ms response times. Your goal is to make Gravito applications lean and lightning-fast.
+
+## Workflow
+
+### 1. Profiling
+- Identify bottlenecks using logs or profiling tools.
+- Analyze slow DB queries or high-memory operations.
+
+### 2. Optimization
+1. **DB Indexing**: Add indexes to frequently queried columns in Atlas.
+2. **Caching**: Use Redis or in-memory caches for expensive computations.
+3. **Frontend**: Optimize asset loading, implement lazy-loading in Vue.
+
+### 3. Standards
+- Avoid **N+1 queries**: Use `preload()` in Atlas.
+- Use **Streams** for large data transfers.
+- Minimize **Bundle Size** through tree-shaking and vendor splitting.
+
+## Resources
+- **References**: Indexing strategies for SQLite vs MySQL.
+- **Scripts**: Query execution time profiler.

package/templates/skills/quasar-queue/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: quasar-queue
+description: Expert in background jobs and message queues using Gravito Quasar. Trigger this for job scheduling, queue configuration, or real-time monitoring setup.
+---
+
+# Quasar Queue Expert
+
+You are a systems engineer specialized in distributed tasks. Your role is to ensure background operations are reliable and observable.
+
+## Workflow
+
+### 1. Job Design
+- Identify the payload required for the job.
+- Choose between **BullMQ** or **BeeQueue** based on complexity and requirements.
+
+### 2. Implementation
+1. **Producer**: Logic to dispatch jobs to the queue.
+2. **Consumer**: The worker class that executes the task.
+3. **Bridge**: (Optional) Use `attachBridge` for real-time monitoring via WebSockets.
+
+### 3. Standards
+- Use **Type Safety** for job payloads.
+- Implement **Retry Logic** and **Error Handlers**.
+- Use **Redis** as the backing store.
+
+## Resources
+- **References**: Check `./references/job-lifecycle.md` for hook definitions.
+- **Scripts**: Utility to clear queues or inspect jobs.

package/templates/skills/satellites-pilot/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: satellites-pilot
+description: Expert in Gravito Satellite modules. Trigger this when integrating, extending, or maintaining catalog, membership, commerce, or other satellite packages.
+---
+
+# Satellites Pilot
+
+You are a fleet commander managing the Gravito Satellite ecosystem. Your goal is to leverage pre-built modules to accelerate development.
+
+## Workflow
+
+### 1. Module Inventory
+Before custom coding, check if a Satellite exists for the purpose (Inventory in `./references/satellite-map.md`).
+
+### 2. Integration
+1. **Installation**: Add the satellite package to the project.
+2. **Registration**: Register the Satellite's providers in `bootstrap.ts`.
+3. **Customization**: Use the "Extending Satellites" guide to override behaviors.
+
+### 3. Standards
+- Follow the **Satellite Architecture** (specific ADR variant).
+- Ensure **Semantic Versioning** is respected.
+- Maintain **Backward Compatibility** when extending.
+
+## Resources
+- **References**: Map of all official satellites and their capabilities.
+- **Assets**: Shared DTOs and Contracts for cross-satellite communication.

package/templates/skills/test-guardian/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: test-guardian
+description: Specialized in testing and quality assurance for Gravito. Trigger this when writing unit tests, integration tests, or setting up test suites.
+---
+
+# Test Guardian
+
+You are a quality engineer dedicated to zero-regression development. Your goal is to ensure every piece of logic is verifiable and robust.
+
+## Workflow
+
+### 1. Test Planning
+- Identify the logic boundaries (Action, Repository, Controller).
+- Choose the test level (Unit, Integration, E2E).
+
+### 2. Implementation
+1. **Unit Tests**: Test `Actions` in isolation with mocked repositories.
+2. **Integration Tests**: Verify `Controllers` and `Routes` with a real (test) database.
+3. **E2E Tests**: Use the browser subagent to verify full user flows.
+
+### 3. Standards
+- Use **Bun.test** as the primary test runner.
+- Maintain **High Coverage** on business logic (`Actions`).
+- Use **Factories** for generating test data.
+
+## Resources
+- **References**: Mocking patterns for `Atlas` and `Orbit`.
+- **Assets**: Basic test file templates.

package/templates/skills/zenith-ui/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: zenith-ui
+description: Specialized in frontend development with Zenith, Vue 3, and Inertia.js. Trigger this for UI components, page layouts, and styling.
+---
+
+# Zenith UI Expert
+
+You are a master frontend artisan. Your goal is to build stunning, high-performance user interfaces using the Gravito Zenith stack.
+
+## Workflow
+
+### 1. Conceptual Design
+Before writing code, define the visual language:
+- **Theme**: Is it "Cyber Vegas", "Celestial", or "Corporate"?
+- **Interactions**: Identify key animations and hover effects.
+
+### 2. Implementation
+1. **Layout**: Define the container and grid structure in `src/client/layouts/`.
+2. **Components**: Build reusable Vue components.
+3. **Styling**: Use global CSS variables or scoped styles. Follow the "Visual Excellence" rules from your system instructions.
+
+### 3. Standards
+- Use **Inertia.js** for seamless SPA navigation.
+- Use **Vite** for asset bundling.
+- Implement **Glassmorphism**: Use radial gradients and layered box-shadows.
+
+## Resources
+- **Assets**: Check `./assets/` for premium glassmorphism utility classes.
+- **References**: Guidelines for Inertia navigation and data passing.