ai-qakit 1.0.0

package/templates/.cursor/commands/devkit/config/init-backend.md

@@ -0,0 +1,219 @@
+# Initialize Backend Project
+
+## Overview
+
+This command initializes backend-specific commands by:
+1. Running `/docs:init` to generate project documentation
+2. Customizing all backend commands to match project conventions
+
+## Usage
+
+`/config:init-backend [optional context about the project]`
+
+## Context
+
+- Project context: $ARGUMENTS
+- This command relies on `/docs:init` to analyze the codebase
+- Then customizes backend commands based on generated docs
+
+---
+
+## Process
+
+### Phase 1: Generate Project Documentation
+
+Run the docs initialization command first:
+
+```
+/docs:init
+```
+
+Wait for `/docs:init` to complete before proceeding.
+
+---
+
+### Phase 2: Extract Project Configuration
+
+After docs are generated, read the following files to extract project configuration:
+
+1. **Read `./docs/codebase-summary.md`** - Extract:
+   - Test framework and test paths
+   - ORM/database migration tool
+   - API type (REST/GraphQL/Hybrid)
+   - File naming conventions
+   - Directory structure
+
+2. **Read `./docs/code-standards.md`** (if exists) - Extract:
+   - Coding conventions
+   - Naming patterns
+   - Project-specific patterns
+
+3. **Read `./docs/system-architecture.md`** (if exists) - Extract:
+   - Architecture patterns
+   - Module organization
+   - API design patterns
+
+---
+
+### Phase 3: Copy Backend Commands
+
+Copy backend commands from template folder to root commands folder:
+
+```bash
+# Copy backend commands to root level for direct access
+cp .cursor/commands/backend/create-api.md .cursor/commands/
+cp .cursor/commands/backend/create-migration.md .cursor/commands/
+cp .cursor/commands/backend/create-schema.md .cursor/commands/
+cp .cursor/commands/backend/design-rest-api.md .cursor/commands/
+cp .cursor/commands/backend/design-graphql-api.md .cursor/commands/
+```
+
+---
+
+### Phase 4: Detect API Type and Clean Up
+
+Based on documentation analysis:
+
+**If REST only (no GraphQL detected):**
+```bash
+rm -f .cursor/commands/design-graphql-api.md
+```
+
+**If GraphQL only (no REST detected):**
+```bash
+rm -f .cursor/commands/design-rest-api.md
+```
+
+**If Hybrid:** Keep both commands.
+
+---
+
+### Phase 5: Customize Commands
+
+Rewrite each command to match project-specific configuration:
+
+| Command | Customize For |
+|---------|---------------|
+| `create-test.md` | Detected test framework, actual test paths, coverage commands, naming conventions |
+| `create-migration.md` | Detected ORM, actual migration paths, migration commands |
+| `create-api.md` | Detected API type ONLY - remove references to other types |
+| `create-schema.md` | Detected ORM, actual entity paths, detected patterns |
+| `design-rest-api.md` | Project's REST conventions (if applicable) |
+| `design-graphql-api.md` | Project's GraphQL conventions (if applicable) |
+
+### Customization Guidelines
+
+For each command:
+
+1. **Read the copied command** from `.cursor/commands/`
+2. **Extract project-specific values** from generated docs:
+   - Test framework and commands
+   - ORM and migration tool
+   - API type (REST/GraphQL)
+   - File naming conventions
+   - Directory structure
+3. **Rewrite the command** to include ONLY:
+   - The specific framework detected (remove all others)
+   - Actual directory paths from this project
+   - Actual commands from this project
+   - Reference to `./docs/` for context
+4. **Remove generic examples** and replace with project-specific ones
+
+### Example Customization
+
+**Before (generic create-test.md):**
+```markdown
+## Multi-Framework Support
+- Jest (JavaScript/TypeScript)
+- JUnit (Java)
+- Pytest (Python)
+- RSpec (Ruby)
+```
+
+**After (customized for NestJS project):**
+```markdown
+## Testing Framework: Jest
+
+Reference: `./docs/codebase-summary.md` for project conventions
+
+### Test Location
+- Tests: `src/**/*.spec.ts`
+- E2E: `test/*.e2e-spec.ts`
+
+### Commands
+```bash
+pnpm test              # Run unit tests
+pnpm test:cov          # Run with coverage
+pnpm test:e2e          # Run E2E tests
+```
+```
+
+---
+
+### Phase 6: Final Summary
+
+Display summary of customized commands:
+
+```
+════════════════════════════════════════════════════════════════════
+                    ✅ BACKEND INITIALIZATION COMPLETE
+════════════════════════════════════════════════════════════════════
+
+📝 CUSTOMIZED COMMANDS:
+   ✅ create-test.md       → [test framework] + actual paths
+   ✅ create-migration.md  → [ORM] + actual commands
+   ✅ create-api.md        → [API type] only
+   ✅ create-schema.md     → [ORM] + entity patterns
+
+🆕 API-SPECIFIC:
+   [✅/❌] design-rest-api.md
+   [✅/❌] design-graphql-api.md
+
+📂 DOCUMENTATION GENERATED:
+   ✅ ./docs/codebase-summary.md
+   ✅ ./docs/code-standards.md (if applicable)
+   ✅ ./docs/system-architecture.md (if applicable)
+
+════════════════════════════════════════════════════════════════════
+```
+
+---
+
+### Phase 7: Validation
+
+Ask user: "Do you have any additional requirements or corrections for the customized commands?"
+
+**If yes:** Wait for input, update relevant commands, and ask again.
+
+**If no:**
+
+```
+════════════════════════════════════════════════════════════════════
+                         🎉 SETUP COMPLETE!
+════════════════════════════════════════════════════════════════════
+
+🚀 QUICK START:
+   /create-schema User with email, name, password
+   /create-migration add users table
+   /create-api CRUD for users
+   /create-test src/modules/users/users.service.ts
+
+💡 All commands use YOUR project's actual paths, conventions, and tools.
+   Reference ./docs/ for project documentation.
+
+════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## Begin Now
+
+Execute the phases in order:
+
+1. **Phase 1**: Run `/devkit:docs:init` to generate project documentation
+2. **Phase 2**: Read generated docs to extract project configuration
+3. **Phase 3**: Copy backend commands to root commands folder
+4. **Phase 4**: Clean up API-specific commands based on detected API type
+5. **Phase 5**: Customize all commands for this project's specific stack
+6. **Phase 6**: Display final summary
+7. **Phase 7**: Handle any additional requirements

package/templates/.cursor/commands/devkit/config/init-frontend.md

@@ -0,0 +1,114 @@
+---
+description: Initialize frontend project with AI context and community rules
+---
+
+# Initialize Frontend Project
+
+Analyze frontend project and generate AI context files with community rules from cursor.directory.
+
+## Usage
+
+`@config/init-frontend`
+
+## Process
+
+### Phase 1: Detect Stack
+
+Analyze project for:
+- **Framework**: Next.js, React, Vue, Nuxt, Svelte, Angular
+- **Styling**: Tailwind, CSS Modules, Styled Components, Emotion
+- **UI Library**: Shadcn, Radix, MUI, Chakra, Ant Design
+- **State**: Zustand, Redux, MobX, Pinia, Jotai
+- **Data Fetching**: TanStack Query, SWR, RTK Query
+- **Forms**: React Hook Form, Formik, Zod, Yup
+- **Testing**: Jest, Vitest, Playwright, Cypress
+
+### Phase 2: Fetch Community Rules
+
+From cursor.directory:
+- Search: "[framework] [TypeScript] Cursor Rules"
+- Filter: Remove non-applicable sections
+- Save: `.cursor/rules/community-rules.mdc`
+
+### Phase 3: Generate Project Profile
+
+Create `.cursor/rules/project-profile.mdc`:
+
+```markdown
+# Project Profile
+
+## Stack
+- Framework: [detected]
+- Styling: [detected]
+- State: [detected]
+- Testing: [detected]
+
+## Conventions
+- Component Pattern: [functional/class]
+- File Naming: [kebab-case/PascalCase]
+- Import Style: [absolute/relative]
+
+## Commands Available
+- @create-component
+- @create-page
+- @create-form
+- @create-table
+- @create-api-integration
+- @create-storybook
+```
+
+### Phase 4: Customize Commands
+
+Adapt frontend commands for detected patterns:
+- Component structure
+- Styling approach
+- State management
+- Data fetching patterns
+- Form handling
+
+### Phase 5: Cleanup Rules
+
+Remove non-applicable rules:
+- If no Tailwind → remove tailwind rules
+- If no Redux → remove redux sections
+- If React, not Vue → remove vue rules
+
+## Output
+
+```
+════════════════════════════════════════
+✅ FRONTEND INITIALIZED
+════════════════════════════════════════
+
+DETECTED STACK:
+  Framework:  Next.js 14
+  Styling:    Tailwind + Shadcn
+  State:      Zustand
+  Forms:      React Hook Form + Zod
+  Testing:    Vitest + Playwright
+
+FILES CREATED:
+  📄 .cursor/rules/project-profile.mdc
+  📄 .cursor/rules/community-rules.mdc
+
+COMMANDS CUSTOMIZED:
+  ✓ @create-component
+  ✓ @create-page
+  ✓ @create-form
+  ✓ @create-table
+
+NEXT STEPS:
+  @create-component Button
+  @create-page dashboard
+════════════════════════════════════════
+```
+
+## Community Rules Applied
+
+| Stack | Rule Applied |
+|-------|--------------|
+| Next.js + TS | "Next.js React TypeScript Cursor Rules" |
+| Next.js + Tailwind | "Optimized Next.js TypeScript Best Practices" |
+| React + Vite | "React Vite TypeScript Cursor Rules" |
+| Vue 3 / Nuxt 3 | "Nuxt 3 TypeScript with Nuxt UI Rules" |
+

package/templates/.cursor/commands/devkit/create-api-integration.md

@@ -0,0 +1,196 @@
+---
+description: Generate API integration layer with types, services, and hooks
+---
+
+# Create API Integration
+
+Generate complete API integration: types, services, and TanStack Query/SWR hooks.
+
+## Usage
+
+`@create-api-integration [resource-name]`
+
+## Ask First
+
+- Base URL? (e.g., `/api/v1/users`)
+- HTTP methods? (GET, POST, PUT, DELETE)
+- Response shape?
+- TanStack Query or SWR or fetch?
+- Authentication headers needed?
+- Optimistic updates for mutations?
+- Query params for filtering/pagination?
+
+## Generated Files
+
+```
+src/
+├── types/
+│   └── [resource].types.ts      # TypeScript interfaces
+├── services/
+│   └── [resource].service.ts    # API service functions
+└── hooks/
+    └── use[Resource].ts         # Query/mutation hooks
+```
+
+## Types Template
+
+```typescript
+// types/[resource].types.ts
+export interface [Resource] {
+  id: string;
+  // ... fields from response shape
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface [Resource]CreateInput {
+  // ... required fields
+}
+
+export interface [Resource]UpdateInput {
+  // ... optional fields
+}
+
+export interface [Resource]ListParams {
+  page?: number;
+  limit?: number;
+  search?: string;
+  // ... filters
+}
+
+export interface [Resource]ListResponse {
+  data: [Resource][];
+  total: number;
+  page: number;
+  limit: number;
+}
+```
+
+## Service Template
+
+```typescript
+// services/[resource].service.ts
+import { api } from '@/lib/api';
+import type { 
+  [Resource], 
+  [Resource]CreateInput,
+  [Resource]ListParams 
+} from '@/types/[resource].types';
+
+const BASE_URL = '/api/v1/[resources]';
+
+export const [resource]Service = {
+  list: (params?: [Resource]ListParams) =>
+    api.get<[Resource]ListResponse>(BASE_URL, { params }),
+
+  get: (id: string) =>
+    api.get<[Resource]>(`${BASE_URL}/${id}`),
+
+  create: (data: [Resource]CreateInput) =>
+    api.post<[Resource]>(BASE_URL, data),
+
+  update: (id: string, data: [Resource]UpdateInput) =>
+    api.patch<[Resource]>(`${BASE_URL}/${id}`, data),
+
+  delete: (id: string) =>
+    api.delete(`${BASE_URL}/${id}`),
+};
+```
+
+## Hooks Template (TanStack Query)
+
+```typescript
+// hooks/use[Resource].ts
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { [resource]Service } from '@/services/[resource].service';
+
+export const [resource]Keys = {
+  all: ['[resources]'] as const,
+  lists: () => [...[resource]Keys.all, 'list'] as const,
+  list: (params) => [...[resource]Keys.lists(), params] as const,
+  details: () => [...[resource]Keys.all, 'detail'] as const,
+  detail: (id: string) => [...[resource]Keys.details(), id] as const,
+};
+
+export function use[Resource]List(params?: [Resource]ListParams) {
+  return useQuery({
+    queryKey: [resource]Keys.list(params),
+    queryFn: () => [resource]Service.list(params),
+  });
+}
+
+export function use[Resource](id: string) {
+  return useQuery({
+    queryKey: [resource]Keys.detail(id),
+    queryFn: () => [resource]Service.get(id),
+    enabled: !!id,
+  });
+}
+
+export function useCreate[Resource]() {
+  const queryClient = useQueryClient();
+  
+  return useMutation({
+    mutationFn: [resource]Service.create,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ 
+        queryKey: [resource]Keys.lists() 
+      });
+    },
+  });
+}
+
+export function useUpdate[Resource]() {
+  const queryClient = useQueryClient();
+  
+  return useMutation({
+    mutationFn: ({ id, data }) => [resource]Service.update(id, data),
+    onSuccess: (_, { id }) => {
+      queryClient.invalidateQueries({ 
+        queryKey: [resource]Keys.detail(id) 
+      });
+      queryClient.invalidateQueries({ 
+        queryKey: [resource]Keys.lists() 
+      });
+    },
+  });
+}
+
+export function useDelete[Resource]() {
+  const queryClient = useQueryClient();
+  
+  return useMutation({
+    mutationFn: [resource]Service.delete,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ 
+        queryKey: [resource]Keys.lists() 
+      });
+    },
+  });
+}
+```
+
+## Output
+
+```
+════════════════════════════════════════
+✅ API INTEGRATION CREATED
+════════════════════════════════════════
+
+RESOURCE: [name]
+BASE URL: /api/v1/[resources]
+
+FILES CREATED:
+  📄 src/types/[resource].types.ts
+  📄 src/services/[resource].service.ts
+  📄 src/hooks/use[Resource].ts
+
+HOOKS AVAILABLE:
+  • use[Resource]List(params)
+  • use[Resource](id)
+  • useCreate[Resource]()
+  • useUpdate[Resource]()
+  • useDelete[Resource]()
+════════════════════════════════════════
+```
+

package/templates/.cursor/commands/devkit/create-component.md

@@ -0,0 +1,104 @@
+---
+description: Generate React/Vue/Svelte components with tests and stories
+---
+
+# Create Component
+
+Generate UI components following project conventions.
+
+## Usage
+
+`@create-component [component-name] [type]`
+
+## Component Types
+
+| Type | Description |
+|------|-------------|
+| `ui` | Pure presentational component |
+| `feature` | Component with business logic |
+| `layout` | Page layout component |
+| `form` | Form with validation |
+| `data` | Data fetching component |
+
+## Process
+
+1. **Analyze** - Detect framework and conventions
+2. **Plan** - Show file structure
+3. **Generate** - Create component files
+4. **Verify** - Run lint and type checks
+
+## Generated Files
+
+```
+components/[ComponentName]/
+├── [ComponentName].tsx       # Component
+├── [ComponentName].test.tsx  # Tests
+├── [ComponentName].stories.tsx # Storybook
+├── [ComponentName].module.css # Styles
+└── index.ts                  # Export
+```
+
+## Component Patterns
+
+### React Functional Component
+```tsx
+interface ComponentNameProps {
+  // props
+}
+
+export function ComponentName({ ...props }: ComponentNameProps) {
+  return (
+    <div className={styles.container}>
+      {/* content */}
+    </div>
+  );
+}
+```
+
+### With forwardRef
+```tsx
+export const ComponentName = forwardRef<HTMLDivElement, Props>(
+  (props, ref) => {
+    return <div ref={ref} {...props} />;
+  }
+);
+```
+
+### With Data Fetching
+```tsx
+export function ComponentName() {
+  const { data, isLoading, error } = useQuery({
+    queryKey: ['key'],
+    queryFn: fetchData,
+  });
+  
+  if (isLoading) return <Skeleton />;
+  if (error) return <ErrorBoundary error={error} />;
+  return <div>{/* render data */}</div>;
+}
+```
+
+## Styling Options
+
+- CSS Modules (default)
+- Tailwind CSS
+- styled-components
+- Vanilla CSS
+
+## Output
+
+```
+✅ COMPONENT CREATED
+════════════════════════════════
+
+📦 ButtonGroup
+├── ButtonGroup.tsx
+├── ButtonGroup.test.tsx
+├── ButtonGroup.stories.tsx
+├── ButtonGroup.module.css
+└── index.ts
+
+COMMANDS:
+• Run tests: npm test ButtonGroup
+• View story: npm run storybook
+```