create-inox-app 0.1.0

package/dist/templates/claude-config/app/.claude/skills/skill-rules.json.hbs

@@ -0,0 +1,309 @@
+{
+  "version": "1.0",
+  "skills": {
+    "turborepo": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "turbo.json",
+          "monorepo",
+          "turborepo",
+          "turbo run",
+          "turbo cache",
+          "dependson",
+          "turbo pipeline"
+        ],
+        "intentPatterns": [
+          "(task|pipeline|cache).*(turbo|monorepo)",
+          "(add|create).*(package|workspace)"
+        ]
+      }
+    },
+    "docker-expert": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "dockerfile",
+          "docker-compose",
+          "docker",
+          "container",
+          "docker build",
+          "docker image"
+        ],
+        "intentPatterns": [
+          "(build|optimize|secure).*(image|container|docker)",
+          "(create|write).*(dockerfile|docker-compose)"
+        ]
+      }
+    },
+    "gitlab-ci-patterns": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "gitlab-ci",
+          ".gitlab-ci.yml",
+          "gitlab pipeline",
+          "gitlab runner",
+          "gitlab ci"
+        ],
+        "intentPatterns": [
+          "(create|setup|fix).*(ci|pipeline|gitlab)",
+          "(optimize|speed).*(pipeline|ci)"
+        ]
+      }
+    },
+    "git-commit": {
+      "type": "domain",
+      "priority": "low",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": ["/commit"],
+        "intentPatterns": ["(commit|stage).*(change|file)"]
+      }
+    },
+    "find-skills": {
+      "type": "domain",
+      "priority": "low",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": ["find skill", "install skill", "search skill", "available skills"],
+        "intentPatterns": [
+          "(find|search|install).*(skill|plugin|extension)",
+          "(what|which).*(skill|plugin).*(available|exist)"
+        ]
+      }
+    },
+    "skill-creator": {
+      "type": "domain",
+      "priority": "low",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": ["create skill", "new skill", "update skill", "build skill"],
+        "intentPatterns": ["(create|build|make|update).*(skill)"]
+      }
+    },
+    "tdd": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": ["tdd", "red-green-refactor", "test-driven", "test first"],
+        "intentPatterns": [
+          "(write|add).*(test).*(first|before|driven)",
+          "(use|follow).*(tdd|test-driven)"
+        ]
+      }
+    },
+{{#if isAiChatApp}}
+    "ai-sdk": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "ai sdk",
+          "generatetext",
+          "streamtext",
+          "usechat",
+          "usecompletion",
+          "tool calling",
+          "vercel ai sdk"
+        ],
+        "intentPatterns": [
+          "(add|build|implement).*(ai|llm|chat|agent)",
+          "(stream|generate).*(text|object|response)"
+        ]
+      }
+    },
+    "ai-elements": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "ai-elements",
+          "ai chat",
+          "chat component",
+          "chat interface"
+        ],
+        "intentPatterns": [
+          "(create|add|build).*(chat|conversation).*(component|ui)",
+          "(add|create).*(ai).*(element|component)"
+        ]
+      }
+    },
+    "vercel-react-best-practices": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "react performance",
+          "bundle size",
+          "waterfall",
+          "re-render",
+          "react optimization",
+          "lazy loading"
+        ],
+        "intentPatterns": [
+          "(optimize|improve|fix).*(performance|render|bundle)",
+          "(reduce|minimize).*(re-render|bundle|waterfall)"
+        ]
+      }
+    },
+    "vercel-composition-patterns": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "compound component",
+          "composition pattern",
+          "boolean prop",
+          "render prop",
+          "component api"
+        ],
+        "intentPatterns": [
+          "(refactor|redesign).*(component|props)",
+          "(replace|remove).*(boolean).*(prop)"
+        ]
+      }
+    },
+    "frontend-design": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "frontend design",
+          "build ui",
+          "design system",
+          "landing page",
+          "web component"
+        ],
+        "intentPatterns": [
+          "(create|build|design).*(page|interface|landing|ui)",
+          "(style|beautify).*(component|page)"
+        ]
+      }
+    },
+    "web-design-guidelines": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "review ui",
+          "check accessibility",
+          "audit design",
+          "review ux",
+          "web interface guidelines"
+        ],
+        "intentPatterns": [
+          "(review|audit|check).*(ui|ux|accessibility|design)",
+          "(evaluate|assess).*(interface|usability)"
+        ]
+      }
+    },
+{{/if}}
+{{#if hasLangfuse}}
+    "langfuse-observability": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": ["langfuse", "tracing", "llm observability", "llm tracing"],
+        "intentPatterns": [
+          "(add|setup|instrument).*(trace|observability|langfuse)",
+          "(monitor|observe).*(llm|ai)"
+        ]
+      }
+    },
+{{/if}}
+{{#if hasDatabase}}
+    "postgres-drizzle": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "drizzle",
+          "database",
+          "schema",
+          "migration",
+          "postgresql",
+          "postgres",
+          "sql"
+        ],
+        "intentPatterns": [
+          "(create|add|modify).*(table|schema|migration|column)",
+          "(query|join|index).*(database|table)"
+        ]
+      }
+    },
+{{/if}}
+{{#if hasAuth}}
+    "better-auth-best-practices": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "better-auth",
+          "authentication",
+          "auth",
+          "login",
+          "signup",
+          "session"
+        ],
+        "intentPatterns": [
+          "(add|setup|implement).*(auth|login|signup)",
+          "(configure|fix).*(session|token)"
+        ]
+      }
+    },
+    "email-and-password-best-practices": {
+      "type": "domain",
+      "priority": "medium",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "email password",
+          "password validation",
+          "email auth",
+          "credential"
+        ],
+        "intentPatterns": [
+          "(implement|add).*(email|password).*(auth|login)",
+          "(validate|check).*(password|email)"
+        ]
+      }
+    },
+{{/if}}
+    "next-best-practices": {
+      "type": "domain",
+      "priority": "high",
+      "enforcement": "suggest",
+      "promptTriggers": {
+        "keywords": [
+          "next.js",
+          "nextjs",
+          "app router",
+          "server component",
+          "route handler",
+          "middleware"
+        ],
+        "intentPatterns": [
+          "(create|add).*(page|route|api|component)",
+          "(optimize|fix).*(next|ssr|hydration)"
+        ]
+      }
+    }
+  }
+}

package/dist/templates/claude-config/app/AGENTS.md.hbs

@@ -0,0 +1,185 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents working with code in this repository.
+
+## Commands
+
+```bash
+# Package manager: bun (enforced via packageManager field — pnpm/npm won't work)
+bun install
+
+# Dev (all apps via turbo, Next.js on port 3000)
+bun run dev
+
+# Build
+bun run build
+
+# Validate (lint + format + type-check — same as CI)
+bun run check
+
+# Individual checks
+{{#if hasOxlint}}
+bun run lint          # oxlint
+{{/if}}
+{{#if hasOxfmt}}
+bun run format        # oxfmt --check
+{{/if}}
+bun run check-types   # turbo type-check
+{{#if hasOxlint}}
+
+# Fix lint/format
+bun run lint:fix
+{{/if}}
+{{#if hasOxfmt}}
+bun run format:fix
+{{/if}}
+{{#if hasDatabase}}
+
+# Database (runs in apps/web context via turbo)
+bun run db:generate   # drizzle-kit generate migration
+bun run db:migrate    # run migrations
+bun run db:push       # push schema directly (dev only)
+bun run db:studio     # drizzle-kit studio
+
+# Seed users (run from apps/web)
+cd apps/web && bun run db:seed   # requires DATABASE_URL + SEED_EMAILS env vars
+{{/if}}
+
+# Docker
+bun run docker:dev               # dev profile (mounts source, hot reload)
+bun run docker:dev:down           # tear down dev
+bun run docker:prod              # prod profile (builds image)
+```
+
+## Architecture
+
+{{#if hasTurborepo}}
+Turborepo monorepo with a single Next.js{{#if isAiChatApp}} 16{{/if}} app and shared TypeScript config.
+{{else}}
+Next.js{{#if isAiChatApp}} 16{{/if}} application with shared TypeScript config.
+{{/if}}
+
+```
+apps/web/          # Next.js{{#if isAiChatApp}} 16{{/if}}, App Router, standalone output{{#if isAiChatApp}}, React Compiler, Turbopack{{/if}}
+packages/typescript-config/   # Shared TS configs (base, nextjs, react-library)
+```
+
+### Tech Stack
+
+{{#if isAiChatApp}}
+- **Framework**: Next.js 16 (App Router, RSC, `after()` hook)
+- **AI**: Vercel AI SDK v6 + OpenRouter (models: `gpt-oss-120b`, `gpt-oss-20b`)
+{{#if hasDatabase}}
+- **DB**: PostgreSQL (ParadeDB) + Drizzle ORM (`pg` driver)
+{{/if}}
+{{#if hasAuth}}
+- **Auth**: Better Auth (email+password, sign-up disabled, users seeded)
+{{/if}}
+{{#if hasLangfuse}}
+- **Observability**: Langfuse via OpenTelemetry span processor
+{{/if}}
+- **UI**: shadcn/ui + Tailwind v4 (oklch color system) + Lucide icons
+- **Markdown**: Streamdown with code/math/mermaid/cjk plugins
+- **Styling**: Tailwind v4 only, `cn()` utility (clsx + tailwind-merge)
+- **Forms**: react-hook-form + Zod
+- **Env validation**: @t3-oss/env-nextjs (see `apps/web/env.ts`)
+{{else}}
+- **Framework**: Next.js (App Router, RSC)
+{{#if hasDatabase}}
+- **DB**: PostgreSQL (ParadeDB) + Drizzle ORM (`pg` driver)
+{{/if}}
+{{#if hasAuth}}
+- **Auth**: Better Auth
+{{/if}}
+{{#if hasLangfuse}}
+- **Observability**: Langfuse via OpenTelemetry span processor
+{{/if}}
+- **UI**: Tailwind v4
+- **Env validation**: @t3-oss/env-nextjs (see `apps/web/env.ts`)
+{{/if}}
+
+{{#if isAiChatApp}}
+### Key Directories (apps/web)
+
+- `app/api/chat/route.ts` — streaming chat endpoint (AI SDK `streamText` + `createUIMessageStream`)
+- `app/api/chat/input-guardrail.ts` — safety classifier (structured output)
+- `app/api/chat/sessions/` — CRUD for chat sessions/messages
+{{#if hasAuth}}
+- `app/api/auth/[...all]/` — Better Auth catch-all
+{{/if}}
+- `app/chat/` — main UI ({{#if hasAuth}}auth-guarded in layout, {{/if}}`useChat` hook)
+- `components/ai-elements/` — AI chat UI primitives (conversation, message, prompt-input, code-block)
+- `components/ui/` — shadcn/ui components
+{{#if hasDatabase}}
+- `lib/db/schema.ts` — Drizzle schema (user, session, account, verification, chatSession, chatMessage)
+{{/if}}
+{{#if hasAuth}}
+- `lib/auth.ts` / `lib/auth-client.ts` — Better Auth server/client instances
+{{/if}}
+- `lib/openrouter.ts` — OpenRouter provider setup
+- `env.ts` — type-safe env validation (all required server vars)
+
+### Patterns
+
+{{#if hasAuth}}
+- **API routes**: auth check via `auth.api.getSession({ headers: req.headers })` at top of every handler
+{{/if}}
+- **Chat streaming**: `streamText()` → `createUIMessageStream()` → `createUIMessageStreamResponse()`
+- **Message persistence**: user message saved before streaming, assistant message saved in `onFinish`
+- **Title generation**: auto-generated on first message via second LLM call, streamed as data parts
+- **Logging**: structured JSON to stdout/stderr (wide events with `logger.info(ctx)` at request end)
+- **Import alias**: `@/` maps to `apps/web/` root
+{{/if}}
+
+## Tooling
+
+{{#if hasOxfmt}}
+- **Formatter**: `oxfmt` (not biome/prettier). Fix: `bunx oxfmt <files>`
+{{/if}}
+{{#if hasOxlint}}
+- **Linter**: `oxlint`. Fix: `bunx oxlint --fix <files>`
+{{/if}}
+{{#if hasLefthook}}
+- **Git hooks**: Lefthook — pre-commit ({{#if hasOxlint}}oxlint{{/if}}{{#if (and hasOxlint hasOxfmt)}} + {{/if}}{{#if hasOxfmt}}oxfmt{{/if}}), {{#if hasCommitlint}}commit-msg (commitlint), {{/if}}pre-push (type-check)
+{{/if}}
+{{#if hasCommitlint}}
+- **Commits**: Conventional commits enforced by commitlint
+{{/if}}
+
+## Local Dev Setup
+
+{{#if hasDatabase}}
+Docker Compose provides PostgreSQL (ParadeDB on port 5432, creds: `app/app/app`){{#if hasRedis}} and Redis (port 6379){{/if}}.
+{{else}}
+{{#if hasRedis}}
+Docker Compose provides Redis (port 6379).
+{{/if}}
+{{/if}}
+
+```bash
+{{#if (or hasDatabase hasRedis)}}
+# Start infra only
+docker compose --profile dev up{{#if hasDatabase}} postgres{{/if}}{{#if hasRedis}} redis{{/if}}
+
+{{/if}}
+# Copy env
+cp apps/web/.env.example apps/web/.env
+# Fill in required env vars (see apps/web/env.ts)
+{{#if hasDatabase}}
+
+# Run migrations + seed
+cd apps/web && bun run db:migrate && SEED_EMAILS=user@example.com bun run db:seed
+{{/if}}
+
+# Start dev
+bun run dev
+```
+
+## CI/CD
+
+GitLab CI with 3 stages: `validate` → `build` → `deploy`.
+- **validate**: `bun run check` (lint + format + type-check)
+- **build**: Docker buildx with registry cache (main branch + tags only)
+{{#each environments}}
+- **deploy**: manual trigger to {{name}}
+{{/each}}

package/dist/templates/claude-config/app/CLAUDE.md.hbs

@@ -0,0 +1,5 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+See [AGENTS.md](./AGENTS.md) for commands, architecture, tooling, and development setup.

package/dist/templates/claude-config/kustomize/.agents/skills/git-commit/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: git-commit
+description: 'Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping'
+license: MIT
+allowed-tools: Bash
+---
+
+# Git Commit with Conventional Commits
+
+## Overview
+
+Create standardized, semantic git commits using the Conventional Commits specification. Analyze the actual diff to determine appropriate type, scope, and message.
+
+## Conventional Commit Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+## Commit Types
+
+| Type       | Purpose                        |
+| ---------- | ------------------------------ |
+| `feat`     | New feature                    |
+| `fix`      | Bug fix                        |
+| `docs`     | Documentation only             |
+| `style`    | Formatting/style (no logic)    |
+| `refactor` | Code refactor (no feature/fix) |
+| `perf`     | Performance improvement        |
+| `test`     | Add/update tests               |
+| `build`    | Build system/dependencies      |
+| `ci`       | CI/config changes              |
+| `chore`    | Maintenance/misc               |
+| `revert`   | Revert commit                  |
+
+## Breaking Changes
+
+```
+# Exclamation mark after type/scope
+feat!: remove deprecated endpoint
+
+# BREAKING CHANGE footer
+feat: allow config to extend other configs
+
+BREAKING CHANGE: `extends` key behavior changed
+```
+
+## Workflow
+
+### 1. Analyze Diff
+
+```bash
+# If files are staged, use staged diff
+git diff --staged
+
+# If nothing staged, use working tree diff
+git diff
+
+# Also check status
+git status --porcelain
+```
+
+### 2. Stage Files (if needed)
+
+If nothing is staged or you want to group changes differently:
+
+```bash
+# Stage specific files
+git add path/to/file1 path/to/file2
+
+# Stage by pattern
+git add *.test.*
+git add src/components/*
+
+# Interactive staging
+git add -p
+```
+
+**Never commit secrets** (.env, credentials.json, private keys).
+
+### 3. Generate Commit Message
+
+Analyze the diff to determine:
+
+- **Type**: What kind of change is this?
+- **Scope**: What area/module is affected?
+- **Description**: One-line summary of what changed (present tense, imperative mood, <72 chars)
+
+### 4. Execute Commit
+
+```bash
+# Single line
+git commit -m "<type>[scope]: <description>"
+
+# Multi-line with body/footer
+git commit -m "$(cat <<'EOF'
+<type>[scope]: <description>
+
+<optional body>
+
+<optional footer>
+EOF
+)"
+```
+
+## Best Practices
+
+- One logical change per commit
+- Present tense: "add" not "added"
+- Imperative mood: "fix bug" not "fixes bug"
+- Reference issues: `Closes #123`, `Refs #456`
+- Keep description under 72 characters
+
+## Git Safety Protocol
+
+- NEVER update git config
+- NEVER run destructive commands (--force, hard reset) without explicit request
+- NEVER skip hooks (--no-verify) unless user asks
+- NEVER force push to main/master
+- If commit fails due to hooks, fix and create NEW commit (don't amend)