@siliconoid/agentkit 0.1.0

package/templates/frameworks/nodejs/.ai/rules/02-architecture.md

@@ -0,0 +1,21 @@
+# Architecture
+
+## Overview
+
+**{{projectName}}** is a Node.js backend application.
+
+## API Design
+
+Describe your API design patterns (REST, GraphQL, etc.).
+
+## Database
+
+Describe your database setup and ORM/query builder.
+
+## Authentication
+
+Describe your authentication and authorization approach.
+
+## Error Handling
+
+Describe your error handling strategy.

package/templates/frameworks/nodejs/.ai/rules/07-react.md

@@ -0,0 +1,26 @@
+<!-- This file replaces the base 07-react.md for Node.js backend projects -->
+# Backend Patterns
+
+## Module Structure
+
+```
+src/
+├── routes/          # API route handlers
+├── services/        # Business logic
+├── models/          # Data models / ORM entities
+├── middleware/       # Express/Fastify middleware
+├── utils/           # Utility functions
+└── config/          # Configuration
+```
+
+## Error Handling
+
+Use typed errors and centralized error handling middleware.
+
+## Validation
+
+Validate all input at API boundaries. Use a validation library (zod, joi, etc.).
+
+## Logging
+
+Use structured logging. Never log sensitive data (passwords, tokens, PII).

package/templates/frameworks/react-spa/.ai/rules/01-project-overview.md

@@ -0,0 +1,49 @@
+# Project Overview
+
+**{{projectName}}** — {{projectDescription}}
+
+## Tech Stack
+
+| Category | Technology | Version |
+|----------|-----------|---------|
+| Framework | React | {{reactVersion}} |
+| Bundler | {{buildTool}} | — |
+| Language | {{primaryLanguage}} | {{typescriptVersion}} |
+| UI Components | {{uiLibrary}} | — |
+| State Management | {{stateManagement}} | — |
+| Styling | {{cssApproach}} | — |
+| HTTP Client | {{httpClient}} | — |
+| Testing | {{testingFramework}} | — |
+| Linter | {{linter}} | — |
+| Package Manager | {{packageManager}} | — |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `{{packageManager}} run dev` | Start dev server |
+| `{{packageManager}} run build` | Production build |
+| `{{packageManager}} run test` | Run tests |
+| `{{packageManager}} run lint` | Run linter |
+
+## Directory Structure
+
+```
+src/
+  assets/          # Static assets (images, SVGs)
+  components/      # Shared/reusable components
+  hooks/           # Custom React hooks
+  pages/           # Route-level page components
+  services/        # API functions & HTTP utilities
+  stores/          # State management
+  styles/          # Global styles & design tokens
+  types/           # Shared TypeScript declarations
+  utils/           # Pure utility functions
+  App.tsx          # Root component
+  main.tsx         # Entry point
+```
+
+## Environment Variables
+
+- All client-side env vars **must** be prefixed with `VITE_`.
+- Never commit `.env` files (they are gitignored).

package/templates/frameworks/react-spa/.ai/rules/02-architecture.md

@@ -0,0 +1,40 @@
+# Architecture
+
+## Overview
+
+**{{projectName}}** is a React single-page application built with Vite.
+
+## Routing
+
+Client-side routing via React Router. Use `React.lazy()` + `<Suspense>` for page-level code splitting.
+
+## API Services — Axios Wrapper & Typing
+
+- All HTTP requests go through the Axios wrapper at `src/services/http.ts`.
+- Domain-specific API functions go in `src/services/xxxApi.ts` (e.g., `userApi.ts`, `orderApi.ts`).
+- Always type request parameters and response data:
+
+```tsx
+// src/services/userApi.ts
+import http from '@/services/http';
+
+interface UserListParams {
+  page: number;
+  pageSize: number;
+}
+
+interface UserListResponse {
+  list: User[];
+  total: number;
+}
+
+export function getUserList(params: UserListParams) {
+  return http.get<UserListResponse>('/users', { params });
+}
+```
+
+## State Management
+
+- **Zustand** (recommended) for global state.
+- **React Context** acceptable for small-scale, component-tree-scoped state.
+- Store files go in `src/stores/` with `xxxStore.ts` naming.

package/templates/frameworks/react-spa/.ai/rules/03-coding-conventions.md

@@ -0,0 +1,26 @@
+# Coding Conventions
+
+## Path Aliases
+
+- **`@/` alias is mandatory** for all `src/` imports — never use relative `../` paths.
+- Relative `./` is allowed only within the same component directory (e.g., `./UserCard.module.scss`).
+
+## Import Order
+
+Auto-sorted by import organizer:
+
+1. `react` / `react-dom`
+2. Third-party libraries (`antd`, `axios`, `zustand`, etc.)
+3. `@/` aliased imports
+4. Relative imports (`./`)
+5. Style / asset imports
+
+## API Request Pattern
+
+Use the Axios wrapper at `src/services/http.ts`. Never use raw `axios` or `fetch`.
+
+Domain-specific API functions go in `src/services/xxxApi.ts`.
+
+## Internationalization
+
+If applicable, use `react-i18next` with `useTranslation()` hook. Never hardcode user-facing strings.

package/templates/frameworks/react-spa/.ai/rules/06-typescript.md

@@ -0,0 +1,30 @@
+# TypeScript
+
+## Compiler Configuration
+
+| Setting | Value | Notes |
+|---------|-------|-------|
+| `strict` | `true` | All strict checks enabled |
+| `target` | `ESNext` | Vite handles transpilation |
+
+## Strict Rules
+
+- **Strict mode** is enabled — respect all strict checks.
+- Prefer `interface` for object shapes; use `type` for unions, intersections, and mapped types.
+- **Never use `any`** — use `unknown` and narrow with type guards.
+- No non-null assertion (`!`) except for `document.getElementById()` where the element is guaranteed.
+- Always type function parameters and return types for exported functions.
+- Use `as const` for literal tuples and fixed arrays.
+- No `// @ts-ignore` — use `// @ts-expect-error` with an explanation comment if absolutely necessary.
+
+## Interface vs Type
+
+| Use Case | Keyword |
+|----------|---------|
+| Object shapes, component props | `interface` |
+| Union types, mapped types, primitives | `type` |
+
+## `any` Strategy
+
+- **Never use `any`** in new code.
+- Use `unknown` + type guards, generics, or specific types.

package/templates/frameworks/react-spa/.ai/rules/07-react.md

@@ -0,0 +1,60 @@
+# React — Components, Hooks, Error Handling, Performance
+
+## Component Patterns
+
+- **Functional components only** — no class components.
+- Props defined via `interface XxxProps {}` above the component.
+- **Pages** (route-level): `export default function XxxPage()` — default export.
+- **Shared components**: named export — `export function Button()`.
+- Co-locate styles as `Xxx.module.scss` in the same directory.
+- Co-locate tests as `Xxx.test.tsx` in the same directory.
+- Use `index.ts` barrel files only at the component/page directory level.
+
+```tsx
+// src/components/UserCard/UserCard.tsx
+import styles from './UserCard.module.scss';
+
+interface UserCardProps {
+  name: string;
+  avatar: string;
+}
+
+export function UserCard({ name, avatar }: UserCardProps) {
+  return (
+    <div className={styles.wrapper}>
+      <img src={avatar} alt={name} />
+      <span>{name}</span>
+    </div>
+  );
+}
+```
+
+## Hooks
+
+- Name: always `useXxx`.
+- Place reusable hooks in `src/hooks/`.
+- Component-specific hooks can live in the component file if small, or in a dedicated `useXxx.ts` alongside the component.
+- Always specify dependency arrays for `useEffect`, `useMemo`, `useCallback`.
+- Always return cleanup functions from `useEffect` when subscribing to events, timers, or external resources.
+
+## Event Handler Naming
+
+| Type | Prefix | Example |
+|------|--------|---------|
+| Internal handler | `handle` | `handleClick`, `handleSubmit` |
+| Prop callback | `on` | `onClick`, `onSubmit` |
+
+## Error Handling
+
+- Wrap route-level components with `ErrorBoundary`.
+- Use `try-catch` in all async service calls.
+- **Never swallow errors silently** — at minimum, log to a monitoring service or re-throw.
+- Display user-friendly error messages via Ant Design's `message` or `notification` components.
+
+## Performance
+
+- **Route splitting**: Use `React.lazy()` + `<Suspense>` for page-level code splitting.
+- Use `useMemo` / `useCallback` only when there is a measured performance need — do not apply prematurely.
+- Avoid creating new object/array literals in JSX props (causes unnecessary re-renders).
+- Use Ant Design's virtual scroll for long lists.
+- Images: prefer SVG for icons (via `vite-plugin-svgr`), use WebP/AVIF for photos with fallback.

package/templates/frameworks/react-spa/.ai/rules/08-styling.md

@@ -0,0 +1,22 @@
+# Styling — CSS Modules, SCSS, Theming
+
+- **Component styles**: `Xxx.module.scss` (CSS Modules) — import as `import styles from './Xxx.module.scss'`.
+- **Global styles**: `src/styles/global.scss` — imported once in `main.tsx`.
+- **Design tokens**: `src/styles/_variables.scss` — auto-injected via Vite `additionalData`, no manual `@use` needed in component files.
+- **Theming**: Prefer Ant Design's `ConfigProvider` token system for theming. Use SCSS variables for non-Ant custom tokens only.
+- **No inline styles** — use CSS Modules or Ant Design's `style` prop for dynamic values only when CSS Modules cannot achieve the result.
+- Class composition: use `composes` in CSS Modules or `classnames`/`clsx` utility for conditional classes.
+
+## Class Name Conventions
+
+Use **camelCase** in CSS Modules (matches JS object property access):
+
+```scss
+.wrapper { ... }
+.cardTitle { ... }
+.isActive { ... }
+```
+
+## Responsive Breakpoints
+
+Common breakpoints: `768px` (tablet), `1200px` (desktop).

package/templates/frameworks/react-spa/.ai/rules/09-naming.md

@@ -0,0 +1,25 @@
+# Naming Conventions
+
+| Target | Convention | Example |
+|--------|-----------|---------|
+| Component files | PascalCase | `UserProfile.tsx` |
+| Component directories | PascalCase | `UserProfile/` |
+| Hook files | camelCase, `use` prefix | `useAuth.ts` |
+| Utility files | camelCase | `formatDate.ts` |
+| API service files | camelCase, `Api` suffix | `userApi.ts` |
+| Store files | camelCase, `Store` suffix | `authStore.ts` |
+| Style modules | PascalCase, `.module.scss` | `UserProfile.module.scss` |
+| Test files | Match source + `.test` | `UserProfile.test.tsx` |
+| Variables & functions | camelCase | `const userName = ...` |
+| Constants | UPPER_SNAKE_CASE | `const MAX_RETRY = 3` |
+| Types | PascalCase | `type UserRole = ...` |
+| Interfaces | PascalCase | `interface UserProps {}` |
+| Enums | PascalCase (members too) | `enum Status { Active }` |
+| CSS class names | camelCase (via CSS Modules) | `styles.cardWrapper` |
+
+## Anti-Patterns
+
+- **No Hungarian notation**: Don't prefix with type indicators
+- **No obscure abbreviations**: Use `info` not `inf`
+- **No single-letter variables**: Except `i`, `j`, `k` in loops
+- **No numbered suffixes**: Don't use `data2`, `handleClick2`

package/templates/frameworks/react-spa/.ai/rules/10-git-workflow.md

@@ -0,0 +1,7 @@
+# Git Workflow
+
+- **Branch naming**: `feat/xxx`, `fix/xxx`, `chore/xxx`, `refactor/xxx`, `docs/xxx`
+- **Commit messages**: Conventional Commits enforced by commitlint.
+  - Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+- **Pull requests**: Squash merge into `main`.
+- **Before pushing**: Ensure `npm run lint`, `npm run lint:css`, and `npm run build` all pass.

package/templates/frameworks/react-spa/.ai/rules/11-testing.md

@@ -0,0 +1,8 @@
+# Testing — Vitest, MSW, Component Testing
+
+- **Framework**: Vitest (Vite-native, zero-config with this setup).
+- **Test files**: Co-located as `Xxx.test.tsx` next to the source file.
+- **Pattern**: `describe` → `it` / `test` blocks.
+- **API mocking**: Use MSW (Mock Service Worker) for intercepting network requests.
+- **Component testing**: Use `@testing-library/react` for rendering and assertions.
+- Name test cases descriptively: `it('should display error when API fails')`.

package/templates/frameworks/react-spa/.ai/rules/12-forbidden-patterns.md

@@ -0,0 +1,16 @@
+# Forbidden Patterns
+
+The following are **not allowed** in this codebase:
+
+| Pattern | Reason |
+|---------|--------|
+| Class components | Use functional components with hooks |
+| `any` type | Use `unknown` + type guards |
+| `var` keyword | Use `const` / `let` |
+| Relative `../` imports | Use `@/` alias |
+| Inline `style={}` props | Use CSS Modules |
+| Committed `console.log` | Removed in production build; use proper logging |
+| `// @ts-ignore` | Use `// @ts-expect-error` with explanation |
+| Non-null assertion `!` (except DOM) | Use proper null checks |
+| `enum` (runtime) without justification | Prefer `as const` objects or union types for simple cases |
+| Barrel `index.ts` re-exporting everything | Only at component/page directory level |

package/templates/frameworks/vue/.ai/rules/01-project-overview.md

@@ -0,0 +1,25 @@
+# Project Overview
+
+**{{projectName}}** — {{projectDescription}}
+
+## Tech Stack
+
+| Category | Technology | Version |
+|----------|-----------|---------|
+| Framework | Vue | {{frameworkVersion}} |
+| Build Tool | {{buildTool}} | — |
+| Language | {{primaryLanguage}} | {{typescriptVersion}} |
+| State Management | {{stateManagement}} | — |
+| UI Components | {{uiLibrary}} | — |
+| Styling | {{cssApproach}} | — |
+| HTTP Client | {{httpClient}} | — |
+| Router | Vue Router | — |
+| Testing | {{testingFramework}} | — |
+| Linter | {{linter}} | — |
+| Package Manager | {{packageManager}} | — |
+
+## Technology Constraints
+
+- Vue 3 Composition API preferred over Options API
+- TypeScript strict mode for new files
+- Single File Components (`.vue`) for all components

package/templates/frameworks/vue/.ai/rules/02-architecture.md

@@ -0,0 +1,47 @@
+# Architecture
+
+## Application Structure
+
+Vue 3 single-page application with Composition API and TypeScript.
+
+### Key Directories
+
+| Directory | Purpose |
+|-----------|---------|
+| `src/components/` | Reusable Vue components |
+| `src/views/` or `src/pages/` | Route-level page components |
+| `src/composables/` | Composition API composables (`use*`) |
+| `src/stores/` | Pinia stores |
+| `src/router/` | Vue Router configuration |
+| `src/services/` or `src/api/` | API service layer |
+| `src/types/` | TypeScript type definitions |
+| `src/assets/` | Static assets (images, fonts) |
+| `src/styles/` | Global styles |
+
+## State Management
+
+Use **Pinia** for global state. Use component-local `ref()`/`reactive()` for local state.
+
+```typescript
+// stores/user.ts
+export const useUserStore = defineStore('user', () => {
+  const user = ref<User | null>(null)
+  const isLoggedIn = computed(() => !!user.value)
+
+  async function login(credentials: LoginParams) { ... }
+  function logout() { user.value = null }
+
+  return { user, isLoggedIn, login, logout }
+})
+```
+
+## Routing
+
+Use Vue Router with lazy-loaded route components:
+
+```typescript
+const routes = [
+  { path: '/', component: () => import('@/views/Home.vue') },
+  { path: '/about', component: () => import('@/views/About.vue') },
+]
+```

package/templates/frameworks/vue/.ai/rules/07-react.md

@@ -0,0 +1,90 @@
+# Vue Components
+
+## Composition API (Preferred)
+
+Use `<script setup lang="ts">` for all new components:
+
+```vue
+<script setup lang="ts">
+import { ref, computed, onMounted } from 'vue'
+
+interface Props {
+  title: string
+  count?: number
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  count: 0,
+})
+
+const emit = defineEmits<{
+  update: [value: number]
+}>()
+
+const localCount = ref(props.count)
+const doubled = computed(() => localCount.value * 2)
+
+function increment() {
+  localCount.value++
+  emit('update', localCount.value)
+}
+
+onMounted(() => {
+  console.log('Component mounted')
+})
+</script>
+
+<template>
+  <div>
+    <h2>{{ title }}</h2>
+    <button @click="increment">{{ localCount }}</button>
+  </div>
+</template>
+```
+
+## Component File Structure
+
+```
+components/
+├── BaseButton/
+│   ├── BaseButton.vue
+│   └── index.ts           # re-export
+├── UserCard/
+│   ├── UserCard.vue
+│   └── index.ts
+```
+
+## Naming Conventions
+
+| Item | Convention | Example |
+|------|-----------|---------|
+| Component file | PascalCase `.vue` | `UserCard.vue` |
+| Component usage | PascalCase in template | `<UserCard />` |
+| Composable | `use` prefix, camelCase | `useAuth.ts` |
+| Store | `use` prefix + `Store` | `useUserStore` |
+| Event handler (emit) | camelCase verb | `@update`, `@submit` |
+| Props | camelCase | `:userName`, `:isActive` |
+
+## Composables
+
+Extract reusable logic into composables in `src/composables/`:
+
+```typescript
+// composables/useAuth.ts
+export function useAuth() {
+  const user = ref<User | null>(null)
+  const isAuthenticated = computed(() => !!user.value)
+
+  async function login(params: LoginParams) { ... }
+  function logout() { ... }
+
+  return { user, isAuthenticated, login, logout }
+}
+```
+
+## Anti-Patterns
+
+- **No Options API** in new components — use `<script setup>` exclusively
+- **No `this`** — Composition API does not use `this`
+- **No mixins** — use composables instead
+- **No global event bus** — use Pinia stores or provide/inject