@cogito.ai/cli 0.4.2 → 0.4.4

package/README.md

@@ -41,23 +41,29 @@ Scaffold a new project from a template. Auto-detects the environment:
 - **TTY** → interactive prompts (human mode)
 - **Non-TTY / `--silent` / `--json`** → headless execution (agent/CI mode)
 
-| Flag | Type | Default | Description |
-| ---- | ---- | ------- | ----------- |
-| `--name` | string | required | Project name and target directory name |
-| `--template` | string | required | Template ID (e.g. `web-nextjs`) |
-| `--pm` | string | `pnpm` | Package manager: `pnpm` / `npm` / `yarn` / `bun` |
-| `--dir` | string | `./<name>` | Target directory (absolute or relative to cwd) |
-| `--json` | boolean | `false` | Output NDJSON result to stdout |
-| `--silent` | boolean | `false` | Suppress all output |
+| Flag         | Type    | Default    | Description                                      |
+| ------------ | ------- | ---------- | ------------------------------------------------ |
+| `--name`     | string  | required   | Project name and target directory name           |
+| `--template` | string  | required   | Template ID (e.g. `web-nextjs`)                  |
+| `--pm`       | string  | `pnpm`     | Package manager: `pnpm` / `npm` / `yarn` / `bun` |
+| `--dir`      | string  | `./<name>` | Target directory (absolute or relative to cwd)   |
+| `--json`     | boolean | `false`    | Output NDJSON result to stdout                   |
+| `--silent`   | boolean | `false`    | Suppress all output                              |
 
 **JSON output (success):**
+
 ```json
-{"ok":true,"targetDir":"/path/to/my-app","name":"my-app","template":"web-nextjs"}
+{ "ok": true, "targetDir": "/path/to/my-app", "name": "my-app", "template": "web-nextjs" }
 ```
 
 **JSON output (failure):**
+
 ```json
-{"ok":false,"error":"TARGET_DIR_EXISTS","message":"Directory already exists: /path/to/my-app"}
+{
+  "ok": false,
+  "error": "TARGET_DIR_EXISTS",
+  "message": "Directory already exists: /path/to/my-app"
+}
 ```
 
 **Error codes:** `MISSING_ARG` · `TEMPLATE_NOT_FOUND` · `TARGET_DIR_EXISTS` · `CLI_VERSION_OUTDATED` · `SCAFFOLD_FAILED`
@@ -74,12 +80,13 @@ agentdock mcp
 
 **Available tools:**
 
-| Tool | Description |
-| ---- | ----------- |
-| `list_templates` | List all available project templates |
+| Tool               | Description                                |
+| ------------------ | ------------------------------------------ |
+| `list_templates`   | List all available project templates       |
 | `scaffold_project` | Scaffold a project into a target directory |
 
 **VS Code Copilot MCP config (`.vscode/mcp.json`):**
+
 ```json
 {
   "servers": {
@@ -96,8 +103,8 @@ agentdock mcp
 
 ## Available Templates
 
-| Template ID | Description |
-| ----------- | ----------- |
+| Template ID  | Description                                                                                           |
+| ------------ | ----------------------------------------------------------------------------------------------------- |
 | `web-nextjs` | Next.js 16 + Supabase + next-intl + Tailwind CSS v4 + Vitest + Fumadocs — full-stack monorepo starter |
 
 ---
@@ -125,13 +132,13 @@ All adapters share the same Core Executor (scaffold + registry)
 
 **Tech stack:**
 
-| Component | Role |
-| --------- | ---- |
-| [Bun](https://github.com/oven-sh/bun) | Build: single-file Node.js executable |
-| [Citty](https://github.com/unjs/citty) | Command modeling: sub-commands, flag schema, lazy loading |
-| [Clack](https://github.com/bombshell-dev/clack) | Human interaction: TTY prompts |
-| [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) | Agent protocol: MCP Stdio server |
-| [Changesets](https://github.com/changesets/changesets) | Release governance: semantic versioning + changelog |
+| Component                                                                    | Role                                                      |
+| ---------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [Bun](https://github.com/oven-sh/bun)                                        | Build: single-file Node.js executable                     |
+| [Citty](https://github.com/unjs/citty)                                       | Command modeling: sub-commands, flag schema, lazy loading |
+| [Clack](https://github.com/bombshell-dev/clack)                              | Human interaction: TTY prompts                            |
+| [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) | Agent protocol: MCP Stdio server                          |
+| [Changesets](https://github.com/changesets/changesets)                       | Release governance: semantic versioning + changelog       |
 
 ---
 

package/dist/index.js

@@ -868,7 +868,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@cogito.ai/cli",
-    version: "0.4.2",
+    version: "0.4.4",
     type: "module",
     description: "AgentDock CLI – scaffold projects for humans and AI agents",
     publishConfig: {
@@ -913,14 +913,7 @@ var init_version = __esm(() => {
 });
 
 // src/core/scaffold.ts
-import {
-  cpSync,
-  existsSync as existsSync2,
-  mkdirSync,
-  readdirSync,
-  readFileSync as readFileSync2,
-  writeFileSync
-} from "fs";
+import { cpSync, existsSync as existsSync2, mkdirSync, readdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join2, dirname as dirname2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { execSync } from "child_process";
@@ -16329,7 +16322,12 @@ var init_tools = __esm(() => {
       required: ["name", "template"]
     },
     async handler(input) {
-      const { name, template: templateId, targetDir, packageManager } = input;
+      const {
+        name,
+        template: templateId,
+        targetDir,
+        packageManager
+      } = input;
       const template = getTemplate(templateId);
       if (!template) {
         return {
@@ -16373,11 +16371,7 @@ var init_tools = __esm(() => {
       return { ok: true, template };
     }
   };
-  ALL_TOOLS = [
-    listTemplatesTool,
-    scaffoldProjectTool,
-    getTemplateSchemaTool
-  ];
+  ALL_TOOLS = [listTemplatesTool, scaffoldProjectTool, getTemplateSchemaTool];
 });
 
 // src/adapters/mcp/server.ts

package/dist/templates/web-nextjs/.github/copilot-instructions.md

@@ -6,11 +6,11 @@
 
 This project is a turborepo + pnpm monorepo with two applications:
 
-| Directory    | Purpose                                                              |
-| ------------ | -------------------------------------------------------------------- |
-| `apps/web/`  | Main Next.js 16 application (four-layer contract, features, i18n)    |
-| `apps/docs/` | Fumadocs documentation site (features, decisions, changelog, roadmap)|
-| `packages/`  | Shared tooling packages (eslint-config, tsconfig)                    |
+| Directory    | Purpose                                                               |
+| ------------ | --------------------------------------------------------------------- |
+| `apps/web/`  | Main Next.js 16 application (four-layer contract, features, i18n)     |
+| `apps/docs/` | Fumadocs documentation site (features, decisions, changelog, roadmap) |
+| `packages/`  | Shared tooling packages (eslint-config, tsconfig)                     |
 
 Run all commands from the monorepo root: `pnpm build`, `pnpm lint`, `pnpm test`, `pnpm check-types`.
 
@@ -62,4 +62,3 @@ When adding a new feature `apps/web/src/features/<name>/`:
 6. Create `apps/docs/content/docs/features/<name>.mdx` — feature documentation.
 
 Reference implementation: `apps/web/src/features/hello/`.
-

package/dist/templates/web-nextjs/README.md

@@ -8,18 +8,18 @@ Designed for both human developers and AI coding agents.
 
 ## Tech Stack
 
-| Layer | Technology |
-|-------|-----------|
-| Framework | [Next.js 16](https://nextjs.org) (App Router) |
-| Language | [TypeScript 5+](https://www.typescriptlang.org) (strict mode) |
-| Styling | [Tailwind CSS v4](https://tailwindcss.com) |
-| Database / Auth | [Supabase](https://supabase.com) (`@supabase/ssr`) |
-| i18n | [next-intl](https://next-intl.dev) (en / zh out of the box) |
-| Testing | [Vitest](https://vitest.dev) |
-| Package manager | [pnpm](https://pnpm.io) ≥ 9 |
-| Runtime | Node.js ≥ 18 |
-| Governance | [OpenSpec](https://github.com/fission-ai/openspec) (`@fission-ai/openspec`) |
-| Monorepo | [Turborepo](https://turbo.build/repo) + pnpm workspaces |
+| Layer           | Technology                                                                  |
+| --------------- | --------------------------------------------------------------------------- |
+| Framework       | [Next.js 16](https://nextjs.org) (App Router)                               |
+| Language        | [TypeScript 5+](https://www.typescriptlang.org) (strict mode)               |
+| Styling         | [Tailwind CSS v4](https://tailwindcss.com)                                  |
+| Database / Auth | [Supabase](https://supabase.com) (`@supabase/ssr`)                          |
+| i18n            | [next-intl](https://next-intl.dev) (en / zh out of the box)                 |
+| Testing         | [Vitest](https://vitest.dev)                                                |
+| Package manager | [pnpm](https://pnpm.io) ≥ 9                                                 |
+| Runtime         | Node.js ≥ 18                                                                |
+| Governance      | [OpenSpec](https://github.com/fission-ai/openspec) (`@fission-ai/openspec`) |
+| Monorepo        | [Turborepo](https://turbo.build/repo) + pnpm workspaces                     |
 
 ## Directory Structure
 
@@ -64,12 +64,12 @@ cp .env.example .env.local
 
 Open `.env.local` and fill in your values:
 
-| Variable | Where to find it |
-|----------|-----------------|
-| `NEXT_PUBLIC_SUPABASE_URL` | Supabase Dashboard → Project Settings → API → Project URL |
-| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase Dashboard → Project Settings → API → anon / public |
-| `SUPABASE_SERVICE_ROLE_KEY` | Supabase Dashboard → Project Settings → API → service_role (server only) |
-| `NEXT_PUBLIC_APP_URL` | `http://localhost:3000` for local dev |
+| Variable                        | Where to find it                                                         |
+| ------------------------------- | ------------------------------------------------------------------------ |
+| `NEXT_PUBLIC_SUPABASE_URL`      | Supabase Dashboard → Project Settings → API → Project URL                |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase Dashboard → Project Settings → API → anon / public              |
+| `SUPABASE_SERVICE_ROLE_KEY`     | Supabase Dashboard → Project Settings → API → service_role (server only) |
+| `NEXT_PUBLIC_APP_URL`           | `http://localhost:3000` for local dev                                    |
 
 ### 4. Set up Supabase Auth (required for login / signup)
 
@@ -129,6 +129,7 @@ apps/web/src/features/<your-feature>/
 ```
 
 Rules:
+
 - Features import from `apps/web/src/core/` (domain interfaces) — never from `apps/web/src/infra/` directly.
 - Every feature directory **must** have `__contract__.ts` (ESLint enforces this).
 - Add translations to `apps/web/messages/en.json` and `apps/web/messages/zh.json`.
@@ -193,12 +194,12 @@ See `openspec/config.yaml` for project-specific governance rules.
 
 ## Environment Variables Reference
 
-| Variable | Required | Exposed to browser | Description |
-|----------|----------|--------------------|-------------|
-| `NEXT_PUBLIC_SUPABASE_URL` | ✅ | ✅ | Supabase project URL |
-| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | ✅ | ✅ | Supabase anon key (RLS protected) |
-| `SUPABASE_SERVICE_ROLE_KEY` | Optional | ❌ | Admin key, bypasses RLS |
-| `NEXT_PUBLIC_APP_URL` | Optional | ✅ | Canonical app URL |
+| Variable                        | Required | Exposed to browser | Description                       |
+| ------------------------------- | -------- | ------------------ | --------------------------------- |
+| `NEXT_PUBLIC_SUPABASE_URL`      | ✅       | ✅                 | Supabase project URL              |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | ✅       | ✅                 | Supabase anon key (RLS protected) |
+| `SUPABASE_SERVICE_ROLE_KEY`     | Optional | ❌                 | Admin key, bypasses RLS           |
+| `NEXT_PUBLIC_APP_URL`           | Optional | ✅                 | Canonical app URL                 |
 
 > Variables prefixed with `NEXT_PUBLIC_` are bundled into client-side JavaScript.  
 > Never put secrets in `NEXT_PUBLIC_*` variables.

package/dist/templates/web-nextjs/apps/docs/.source/browser.ts

@@ -7,6 +7,6 @@ const create = browser<typeof Config, import("fumadocs-mdx/runtime/types").Inter
   }
 }>();
 const browserCollections = {
-  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "decisions/turbo-package-manager.mdx": () => import("../content/docs/decisions/turbo-package-manager.mdx?collection=docs"), "features/auth.mdx": () => import("../content/docs/features/auth.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), }),
+  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "features/auth.mdx": () => import("../content/docs/features/auth.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), "decisions/turbo-package-manager.mdx": () => import("../content/docs/decisions/turbo-package-manager.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), }),
 };
 export default browserCollections;

package/dist/templates/web-nextjs/apps/docs/.source/server.ts

@@ -1,13 +1,13 @@
 // @ts-nocheck
 import * as __fd_glob_10 from "../content/docs/roadmap/index.mdx?collection=docs"
-import * as __fd_glob_9 from "../content/docs/features/hello.mdx?collection=docs"
-import * as __fd_glob_8 from "../content/docs/features/auth.mdx?collection=docs"
-import * as __fd_glob_7 from "../content/docs/decisions/turbo-package-manager.mdx?collection=docs"
+import * as __fd_glob_9 from "../content/docs/decisions/turbo-package-manager.mdx?collection=docs"
+import * as __fd_glob_8 from "../content/docs/features/hello.mdx?collection=docs"
+import * as __fd_glob_7 from "../content/docs/features/auth.mdx?collection=docs"
 import * as __fd_glob_6 from "../content/docs/changelog/index.mdx?collection=docs"
 import * as __fd_glob_5 from "../content/docs/index.mdx?collection=docs"
 import { default as __fd_glob_4 } from "../content/docs/roadmap/meta.json?collection=docs"
-import { default as __fd_glob_3 } from "../content/docs/decisions/meta.json?collection=docs"
-import { default as __fd_glob_2 } from "../content/docs/features/meta.json?collection=docs"
+import { default as __fd_glob_3 } from "../content/docs/features/meta.json?collection=docs"
+import { default as __fd_glob_2 } from "../content/docs/decisions/meta.json?collection=docs"
 import { default as __fd_glob_1 } from "../content/docs/changelog/meta.json?collection=docs"
 import { default as __fd_glob_0 } from "../content/docs/meta.json?collection=docs"
 import { server } from 'fumadocs-mdx/runtime/server';
@@ -18,4 +18,4 @@ const create = server<typeof Config, import("fumadocs-mdx/runtime/types").Intern
   }
 }>({"doc":{"passthroughs":["extractedReferences"]}});
 
-export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "changelog/meta.json": __fd_glob_1, "features/meta.json": __fd_glob_2, "decisions/meta.json": __fd_glob_3, "roadmap/meta.json": __fd_glob_4, }, {"index.mdx": __fd_glob_5, "changelog/index.mdx": __fd_glob_6, "decisions/turbo-package-manager.mdx": __fd_glob_7, "features/auth.mdx": __fd_glob_8, "features/hello.mdx": __fd_glob_9, "roadmap/index.mdx": __fd_glob_10, });
+export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "changelog/meta.json": __fd_glob_1, "decisions/meta.json": __fd_glob_2, "features/meta.json": __fd_glob_3, "roadmap/meta.json": __fd_glob_4, }, {"index.mdx": __fd_glob_5, "changelog/index.mdx": __fd_glob_6, "features/auth.mdx": __fd_glob_7, "features/hello.mdx": __fd_glob_8, "decisions/turbo-package-manager.mdx": __fd_glob_9, "roadmap/index.mdx": __fd_glob_10, });

package/dist/templates/web-nextjs/apps/docs/app/docs/[[...slug]]/page.tsx

@@ -1,10 +1,5 @@
 import { source } from '@/lib/source'
-import {
-  DocsBody,
-  DocsDescription,
-  DocsPage,
-  DocsTitle,
-} from 'fumadocs-ui/layouts/docs/page'
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page'
 import { notFound } from 'next/navigation'
 
 export default async function Page(props: { params: Promise<{ slug?: string[] }> }) {

package/dist/templates/web-nextjs/apps/docs/app/docs/layout.tsx

@@ -4,10 +4,7 @@ import type { ReactNode } from 'react'
 
 export default function Layout({ children }: { children: ReactNode }) {
   return (
-    <DocsLayout
-      tree={source.getPageTree()}
-      nav={{ title: 'Docs' }}
-    >
+    <DocsLayout tree={source.getPageTree()} nav={{ title: 'Docs' }}>
       {children}
     </DocsLayout>
   )

package/dist/templates/web-nextjs/apps/docs/app/llms-full.txt/route.ts

@@ -5,7 +5,9 @@ export const revalidate = false
 export async function GET() {
   const pages = source.getPages()
   const texts = await Promise.all(
-    pages.map(async (page) => `# ${page.data.title} (${page.url})\n\n${page.data.description ?? ''}`)
+    pages.map(
+      async (page) => `# ${page.data.title} (${page.url})\n\n${page.data.description ?? ''}`,
+    ),
   )
   return new Response(texts.join('\n\n'))
 }

package/dist/templates/web-nextjs/apps/docs/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import './.next/types/routes.d.ts'
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/dist/templates/web-nextjs/apps/web/.env.example

@@ -24,3 +24,38 @@ NEXT_PUBLIC_APP_URL=http://localhost:3000
 # Default locale used for root redirects and i18n fallback
 # Allowed values: en, zh
 APP_DEFAULT_LOCALE=zh
+
+# ──────────────────────────────────────────────────────────────────────────────
+# Alipay Payment (Optional)
+# Get these from: Alipay Open Platform → App Center → your app
+# Sandbox: https://open.alipay.com/develop/sandbox
+# ──────────────────────────────────────────────────────────────────────────────
+ALIPAY_APP_ID=<your-app-id>
+ALIPAY_PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----
+<your-private-key>
+-----END RSA PRIVATE KEY-----
+ALIPAY_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----
+<your-public-key>
+-----END PUBLIC KEY-----
+# Sandbox gateway (uncomment for sandbox testing):
+# ALIPAY_GATEWAY=https://openapi-sandbox.dl.alipaydev.com/gateway.do
+ALIPAY_NOTIFY_URL=https://your-domain.com/api/payments/alipay/notify
+
+# ──────────────────────────────────────────────────────────────────────────────
+# WeChat Pay (Optional)
+# Get these from: WeChat Pay Merchant Platform
+# ──────────────────────────────────────────────────────────────────────────────
+WECHAT_PAY_APP_ID=wx<your-app-id>
+WECHAT_PAY_MCH_ID=<your-mch-id>
+WECHAT_PAY_API_V3_KEY=<your-32-char-apiv3-key>
+WECHAT_PAY_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----
+<your-private-key>
+-----END PRIVATE KEY-----
+WECHAT_PAY_SERIAL_NO=<your-cert-serial-no>
+# Platform public key (download from GET /v3/certificates)
+WECHAT_PAY_PLATFORM_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----
+<platform-public-key>
+-----END PUBLIC KEY-----
+# Domestic: https://api.mch.weixin.qq.com; Overseas: https://apihk.mch.weixin.qq.com
+WECHAT_PAY_BASE_URL=https://api.mch.weixin.qq.com
+WECHAT_PAY_NOTIFY_URL=https://your-domain.com/api/payments/wechat/notify

package/dist/templates/web-nextjs/apps/web/.github/copilot-instructions.md

@@ -6,11 +6,11 @@
 
 This project is a turborepo + pnpm monorepo with two applications:
 
-| Directory    | Purpose                                                              |
-| ------------ | -------------------------------------------------------------------- |
-| `apps/web/`  | Main Next.js 16 application (four-layer contract, features, i18n)    |
-| `apps/docs/` | Fumadocs documentation site (features, decisions, changelog, roadmap)|
-| `packages/`  | Shared tooling packages (eslint-config, tsconfig)                    |
+| Directory    | Purpose                                                               |
+| ------------ | --------------------------------------------------------------------- |
+| `apps/web/`  | Main Next.js 16 application (four-layer contract, features, i18n)     |
+| `apps/docs/` | Fumadocs documentation site (features, decisions, changelog, roadmap) |
+| `packages/`  | Shared tooling packages (eslint-config, tsconfig)                     |
 
 Run all commands from the monorepo root: `pnpm build`, `pnpm lint`, `pnpm test`, `pnpm check-types`.
 
@@ -34,6 +34,53 @@ Four rules are enforced at `error` severity in `apps/web/src/features/**`. Viola
 3. **`no-cross-feature`** — Features must not directly import from sibling feature internals. Import through the feature's `index.ts` only.
 4. **`no-core-mutation`** — `apps/web/src/core/` is read-only. Features and infra must not modify core types or interfaces in-place.
 
+## CSS Design System
+
+This project uses a token-based CSS design system. **Always use semantic tokens**, not arbitrary Tailwind values.
+
+### Token Usage Rules
+
+| Rule            | Do This                                 | Not This                  |
+| --------------- | --------------------------------------- | ------------------------- |
+| Background      | `bg-surface`, `bg-surface-elevated`     | `bg-gray-100`, `bg-white` |
+| Text muted      | `text-muted-foreground`                 | `text-gray-500`           |
+| Border          | `border-border`                         | `border-gray-200`         |
+| Primary         | `bg-primary`, `text-primary-foreground` | `bg-blue-500`             |
+| Section padding | `p-[var(--space-section)]` or `clamp()` | Hardcoded `px-16 py-24`   |
+
+### Tailwind `@theme` Registration
+
+The following semantic tokens are registered in `globals.css` `@theme` and available as Tailwind utilities:
+
+- `--color-surface`, `--color-surface-elevated`
+- `--color-muted-custom`, `--color-muted-foreground-custom`
+- `--color-border-custom`
+- `--color-primary-custom`, `--color-primary-foreground-custom`
+
+## Responsive Design Rules (Mobile-First)
+
+- **DEFAULT**: Write mobile styles first (unprefixed Tailwind classes)
+- **ENHANCEMENT**: Add desktop styles with `md:` / `lg:` prefixes
+- **FORBIDDEN**: Never use `max-md:` / `max-lg:` downgrade patterns
+- **Section spacing**: Use `clamp(32px, 8vw, 80px)` for section padding
+- **Hero font**: Use `clamp(2rem, 5vw + 1rem, 4rem)` for hero titles
+- **Touch targets**: All buttons and links must be at least `min-h-[44px] min-w-[44px]`
+- **Container queries**: Use `@container` for component-level responsiveness (e.g., feature cards)
+
+## UI Anti-Patterns (AI Slop)
+
+The following patterns are **strictly forbidden**. AI must self-check before generating UI:
+
+1. **Inter + Roboto font dominance** — Geist is the primary font.
+2. **Purple-to-blue gradients** — `from-purple-* to-blue-*` is banned.
+3. **Nested rounded cards** — No `rounded-xl` inside `rounded-xl`.
+4. **Pure black / pure gray text** — All neutrals must carry subtle hue.
+5. **Bounce / elastic easing** — No bounce or spring animations.
+6. **Neon glowing header text** — No text-shadow glow on dark backgrounds.
+7. **Icon tile above every heading** — No rounded square icon tiles above section headings.
+
+Reference: `DESIGN.md` for full design system context.
+
 ## Docs Co-evolution
 
 Documentation lives alongside the application and grows with it:
@@ -49,6 +96,7 @@ Documentation lives alongside the application and grows with it:
 3. **Conventional commits** — `type(scope): summary` format required.
 4. **pnpm only** — Do not use `npm install` or `yarn`. Always `pnpm add`.
 5. **ESLint config** — Architecture rules come from `packages/eslint-config/features.js`.
+6. **Design system** — Use semantic tokens from `tokens.css`. Never hardcode colors or spacing.
 
 ## Feature Development Pattern
 
@@ -62,4 +110,3 @@ When adding a new feature `apps/web/src/features/<name>/`:
 6. Create `apps/docs/content/docs/features/<name>.mdx` — feature documentation.
 
 Reference implementation: `apps/web/src/features/hello/`.
-

package/dist/templates/web-nextjs/apps/web/.github/skills/impeccable/SKILL.md

@@ -0,0 +1,55 @@
+# Impeccable Design Skill
+
+> Skill for enforcing high-quality UI design and catching AI Slop in AI-generated code.
+
+## Overview
+
+Impeccable is a design quality assurance skill that helps AI Coding Agents produce refined, non-generic UI by enforcing design system constraints and catching common AI-generated anti-patterns.
+
+## Commands
+
+### `/impeccable init`
+
+Initialize design context. Reads `DESIGN.md` and `PRODUCT.md` (if exists) to establish design baseline.
+
+### `/impeccable craft <component>`
+
+Generate a component following the design system in `DESIGN.md`. Uses semantic tokens, OKLCH colors, and mobile-first responsive patterns.
+
+### `/impeccable critique <area>`
+
+Review UI for design quality issues: spacing, color consistency, typography, contrast, accessibility.
+
+### `/impeccable polish`
+
+Apply spacing/typography/color fixes based on DESIGN.md constraints. Fixes minor inconsistencies.
+
+### `/impeccable adapt`
+
+Check and fix responsive behavior at 375px, 768px, and 1280px breakpoints.
+
+## Installation
+
+```bash
+npx impeccable skills install
+```
+
+This creates `.github/skills/impeccable/` with this SKILL.md.
+
+## Anti-Patterns Detected
+
+1. Inter/Roboto font dominance
+2. Purple-to-blue gradients
+3. Nested rounded cards
+4. Pure black/gray text
+5. Bounce/elastic animations
+6. Neon glowing header text
+7. Icon tile above every heading
+
+## CI Integration
+
+```bash
+npx impeccable detect src/ --fast --json
+```
+
+Run in CI to detect AI Slop. Returns JSON report with findings.

package/dist/templates/web-nextjs/apps/web/DESIGN.md

@@ -0,0 +1,65 @@
+# AgentDock Web Template — Design System
+
+> This document serves as the design context anchor for AI Coding Agents. Every UI generation must reference this file before producing components.
+
+## Project Type & Design Positioning
+
+- **Type**: SaaS starter template (B2B/B2C universal)
+- **Style**: Clean / Professional / Modern
+- **Philosophy**: Not minimal, not flashy. Purposeful, trustworthy, and easy to extend.
+
+## Typography System
+
+| Token            | Value                     | Usage                     |
+| ---------------- | ------------------------- | ------------------------- |
+| `--font-heading` | Geist Sans                | Headlines, hero text, nav |
+| `--font-body`    | Geist Sans                | Body text, UI labels      |
+| Fallback         | `system-ui`, `sans-serif` | Geist loading failure     |
+
+- **Font scale**: `--text-xs` (0.75rem) → `--text-4xl` (2.25rem)
+- **Hero title**: `clamp(2rem, 5vw + 1rem, 4rem)` — responsive, fluid
+- **Body line-height**: 1.6 for readability
+
+## Color Strategy (OKLCH)
+
+Brand color is defined via OKLCH hue/chroma/lightness variables:
+
+- `--color-brand-h: 262`, `--color-brand-c: 0.26`, `--color-brand-l: 0.56`
+- Override these three variables to retheme the entire application.
+
+### Semantic Tokens
+
+| Token                      | Light            | Dark            | Usage                  |
+| -------------------------- | ---------------- | --------------- | ---------------------- |
+| `--color-surface`          | oklch(0.985 ...) | oklch(0.13 ...) | Page backgrounds       |
+| `--color-surface-elevated` | oklch(1 ...)     | oklch(0.18 ...) | Cards, modals          |
+| `--color-muted`            | oklch(0.94 ...)  | oklch(0.22 ...) | Secondary backgrounds  |
+| `--color-muted-foreground` | oklch(0.52 ...)  | oklch(0.62 ...) | Placeholder, meta text |
+| `--color-border`           | oklch(0.88 ...)  | oklch(0.28 ...) | Dividers, borders      |
+
+## Spacing System
+
+- **Baseline**: 4px (`--space-1`)
+- **Section spacing**: `clamp(64px, 10vw, 120px)` — never hardcode section padding
+- **Touch targets**: Minimum `44px x 44px` for all interactive elements
+
+## 7 AI Slop Anti-Patterns (FORBIDDEN)
+
+When generating or reviewing UI, the following patterns are **strictly forbidden**:
+
+1. **Inter + Roboto font dominance** — Geist is the primary font. Do not fall back to Inter as the main font.
+2. **Purple-to-blue gradients** — `from-purple-* to-blue-*` is banned. Use `--color-primary` or solid colors.
+3. **Nested rounded cards** — Do not place `rounded-xl` cards inside `rounded-xl` cards. One level of radius is enough.
+4. **Pure black / pure gray text** — All grays must carry a subtle hue (our neutrals are tinted).
+5. **Bounce / elastic easing** — No `bounce`, `elastic`, or spring animations. Use `ease-out` or `cubic-bezier(0.4, 0, 0.2, 1)`.
+6. **Neon glowing header text on dark backgrounds** — No text-shadow glow effects. Keep it clean.
+7. **Icon tile above every heading** — Do not place a rounded square icon tile above every section heading. Use icon + heading inline or omit.
+
+## Impeccable Workflow
+
+When designing new pages or sections, follow this workflow:
+
+1. **Craft** (`/impeccable craft`) — Generate initial design based on DESIGN.md context
+2. **Critique** (`/impeccable critique`) — Review for spacing, color, typography consistency
+3. **Polish** (`/impeccable polish`) — Fix spacing, font sizes, color values
+4. **Adapt** (`/impeccable adapt`) — Ensure responsive at 375px / 768px / 1280px