@smicolon/ai-kit 0.1.0 → 0.2.0

package/.claude-plugin/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/.claude-plugin/marketplace.json

@@ -0,0 +1,373 @@
+{
+  "name": "smicolon-marketplace",
+  "version": "2.6.0",
+  "description": "Official marketplace for Smicolon development standards - 13 plugins with 28 agents, 40 skills, TanStack SPA, Better Auth, onboarding, and TDD dev loops",
+  "license": "MIT",
+  "metadata": {
+    "description": "Official marketplace for Smicolon development standards - 13 plugins with 28 specialized agents, 40 auto-enforcing skills, intelligent engineer onboarding, TanStack Router SPA development, Better Auth integration, Hono Edge framework, Flutter mobile, git worktree management, persistent failure memory, and TDD-based dev loops for Django, NestJS, Next.js, Nuxt.js, Hono, Flutter, TanStack, and system architecture"
+  },
+  "owner": {
+    "name": "Smicolon Development Team",
+    "email": "dev@smicolon.com",
+    "url": "https://github.com/smicolon"
+  },
+  "repository": "https://github.com/smicolon/ai-kit",
+  "plugins": [
+    {
+      "name": "dev-loop",
+      "version": "1.2.2",
+      "description": "Autonomous TDD development loops with planning phase and iterative coding",
+      "source": "./packs/dev-loop",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "automation",
+      "keywords": ["dev-loop", "automation", "tdd", "iterative", "ralph-wiggum", "planning"],
+      "commands": [
+        "./commands/dev-loop.md",
+        "./commands/dev-plan.md",
+        "./commands/cancel-dev.md"
+      ],
+      "skills": ["./skills/tdd-planner/SKILL.md"],
+      "hooks": ["./hooks/hooks.json"]
+    },
+    {
+      "name": "django",
+      "version": "2.1.1",
+      "description": "Django standards with 5 agents and 8 auto-enforcing skills",
+      "source": "./packs/django",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "backend",
+      "keywords": ["django", "python", "backend", "testing", "tdd", "architecture", "security", "performance"],
+      "agents": [
+        "./agents/django-architect.md",
+        "./agents/django-builder.md",
+        "./agents/django-feature-based.md",
+        "./agents/django-tester.md",
+        "./agents/django-reviewer.md"
+      ],
+      "commands": [
+        "./commands/model-create.md",
+        "./commands/api-endpoint.md",
+        "./commands/test-generate.md"
+      ],
+      "skills": [
+        "./skills/import-convention-enforcer/SKILL.md",
+        "./skills/model-entity-validator/SKILL.md",
+        "./skills/security-first-validator/SKILL.md",
+        "./skills/test-coverage-advisor/SKILL.md",
+        "./skills/performance-optimizer/SKILL.md",
+        "./skills/migration-safety-checker/SKILL.md",
+        "./skills/test-validity-checker/SKILL.md",
+        "./skills/red-phase-verifier/SKILL.md"
+      ]
+    },
+    {
+      "name": "nestjs",
+      "version": "2.1.1",
+      "description": "NestJS standards with 3 agents and 2 auto-enforcing skills",
+      "source": "./packs/nestjs",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "backend",
+      "keywords": ["nestjs", "typescript", "backend", "testing", "architecture", "barrel-exports"],
+      "agents": [
+        "./agents/nestjs-architect.md",
+        "./agents/nestjs-builder.md",
+        "./agents/nestjs-tester.md"
+      ],
+      "commands": ["./commands/module-create.md"],
+      "skills": [
+        "./skills/barrel-export-manager/SKILL.md",
+        "./skills/import-convention-enforcer/SKILL.md"
+      ]
+    },
+    {
+      "name": "nextjs",
+      "version": "2.1.1",
+      "description": "Next.js standards with 4 agents, 3 auto-enforcing skills, and visual QA",
+      "source": "./packs/nextjs",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "frontend",
+      "keywords": ["nextjs", "react", "frontend", "typescript", "visual-qa", "accessibility", "forms"],
+      "agents": [
+        "./agents/nextjs-architect.md",
+        "./agents/nextjs-modular.md",
+        "./agents/frontend-visual.md",
+        "./agents/frontend-tester.md"
+      ],
+      "commands": ["./commands/component-create.md"],
+      "skills": [
+        "./skills/accessibility-validator/SKILL.md",
+        "./skills/react-form-validator/SKILL.md",
+        "./skills/import-convention-enforcer/SKILL.md"
+      ]
+    },
+    {
+      "name": "nuxtjs",
+      "version": "2.1.1",
+      "description": "Nuxt.js standards with 3 agents, 3 auto-enforcing skills, and visual QA",
+      "source": "./packs/nuxtjs",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "frontend",
+      "keywords": ["nuxtjs", "vue", "vue3", "frontend", "typescript", "visual-qa", "accessibility", "forms"],
+      "agents": [
+        "./agents/nuxtjs-architect.md",
+        "./agents/frontend-visual.md",
+        "./agents/frontend-tester.md"
+      ],
+      "commands": ["./commands/component-create.md"],
+      "skills": [
+        "./skills/accessibility-validator/SKILL.md",
+        "./skills/veevalidate-form-validator/SKILL.md",
+        "./skills/import-convention-enforcer/SKILL.md"
+      ]
+    },
+    {
+      "name": "architect",
+      "version": "1.0.0",
+      "description": "System architecture and diagram-as-code with Eraser.io integration",
+      "source": "./packs/architect",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "architecture",
+      "keywords": ["architecture", "diagrams", "eraser", "erd", "flowchart", "cloud-architecture"],
+      "agents": ["./agents/system-architect.md"],
+      "commands": ["./commands/diagram-create.md"]
+    },
+    {
+      "name": "failure-log",
+      "version": "1.0.1",
+      "description": "Persistent failure memory that tracks mistakes and prevents repeating them across sessions",
+      "source": "./packs/failure-log",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "automation",
+      "keywords": ["failure-log", "memory", "learning", "mistakes", "conventions"],
+      "commands": [
+        "./commands/failure-add.md",
+        "./commands/failure-list.md"
+      ],
+      "skills": ["./skills/failure-log-manager/SKILL.md"],
+      "hooks": ["./hooks/hooks.json"]
+    },
+    {
+      "name": "flutter",
+      "version": "0.1.1",
+      "description": "Flutter development with Fastlane automation, store publishing, and architecture patterns",
+      "source": "./packs/flutter",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "mobile",
+      "keywords": ["flutter", "dart", "mobile", "ios", "android", "fastlane", "app-store", "google-play"],
+      "agents": [
+        "./agents/flutter-architect.md",
+        "./agents/flutter-builder.md",
+        "./agents/release-manager.md"
+      ],
+      "commands": [
+        "./commands/flutter-build.md",
+        "./commands/flutter-test.md",
+        "./commands/flutter-deploy.md",
+        "./commands/fastlane-setup.md",
+        "./commands/signing-setup.md"
+      ],
+      "skills": [
+        "./skills/flutter-architecture/SKILL.md",
+        "./skills/fastlane-knowledge/SKILL.md",
+        "./skills/store-publishing/SKILL.md"
+      ],
+      "hooks": ["./hooks/hooks.json"]
+    },
+    {
+      "name": "hono",
+      "version": "0.1.1",
+      "description": "Hono Edge framework standards with 4 agents and 4 auto-enforcing skills for Bun and Cloudflare Workers",
+      "source": "./packs/hono",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "backend",
+      "keywords": ["hono", "bun", "cloudflare-workers", "edge", "typescript", "api", "rpc"],
+      "agents": [
+        "./agents/hono-architect.md",
+        "./agents/hono-builder.md",
+        "./agents/hono-tester.md",
+        "./agents/hono-reviewer.md"
+      ],
+      "commands": [
+        "./commands/route-create.md",
+        "./commands/middleware-create.md",
+        "./commands/project-init.md",
+        "./commands/rpc-client.md"
+      ],
+      "skills": [
+        "./skills/hono-patterns/SKILL.md",
+        "./skills/cloudflare-bindings/SKILL.md",
+        "./skills/zod-validation/SKILL.md",
+        "./skills/rpc-typesafe/SKILL.md"
+      ],
+      "hooks": ["./hooks/hooks.json"]
+    },
+    {
+      "name": "tanstack-router",
+      "version": "0.1.0",
+      "description": "TanStack Router SPA development with 3 agents, 11 skills for React SPAs using TanStack ecosystem",
+      "source": "./packs/tanstack-router",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "frontend",
+      "keywords": ["tanstack", "react", "router", "query", "form", "table", "virtual", "spa", "typescript", "bun"],
+      "agents": [
+        "./agents/tanstack-architect.md",
+        "./agents/tanstack-builder.md",
+        "./agents/tanstack-tester.md"
+      ],
+      "commands": [
+        "./commands/route-create.md",
+        "./commands/query-create.md",
+        "./commands/form-create.md",
+        "./commands/table-create.md"
+      ],
+      "skills": [
+        "./skills/router-patterns/SKILL.md",
+        "./skills/query-patterns/SKILL.md",
+        "./skills/form-patterns/SKILL.md",
+        "./skills/table-patterns/SKILL.md",
+        "./skills/virtual-patterns/SKILL.md",
+        "./skills/store-patterns/SKILL.md",
+        "./skills/db-patterns/SKILL.md",
+        "./skills/ai-patterns/SKILL.md",
+        "./skills/pacer-patterns/SKILL.md",
+        "./skills/devtools-patterns/SKILL.md",
+        "./skills/tanstack-conventions/SKILL.md"
+      ]
+    },
+    {
+      "name": "better-auth",
+      "version": "0.1.1",
+      "description": "Better Auth integration with 1 agent, 2 skills, and MCP server for authentication",
+      "source": "./packs/better-auth",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "authentication",
+      "keywords": ["better-auth", "authentication", "oauth", "2fa", "passkeys", "social-login", "session"],
+      "agents": [
+        "./agents/auth-architect.md"
+      ],
+      "commands": [
+        "./commands/auth-setup.md",
+        "./commands/auth-provider-add.md"
+      ],
+      "skills": [
+        "./skills/better-auth-patterns/SKILL.md",
+        "./skills/auth-security/SKILL.md"
+      ],
+      "mcpServers": "./.mcp.json"
+    },
+    {
+      "name": "worktree",
+      "version": "0.1.1",
+      "description": "Git worktree manager for parallel development with automatic env copying and dependency installation",
+      "source": "./packs/worktree",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "automation",
+      "keywords": ["git", "worktree", "parallel-development", "branch-management", "monorepo"],
+      "commands": ["./commands/wt.md"],
+      "skills": ["./skills/worktree-manager/SKILL.md"]
+    },
+    {
+      "name": "onboard",
+      "version": "0.1.0",
+      "description": "Intelligent engineer onboarding with personalized guidance based on skills, project analysis, and first task",
+      "source": "./packs/onboard",
+      "author": {
+        "name": "Smicolon",
+        "email": "dev@smicolon.com",
+        "url": "https://github.com/smicolon"
+      },
+      "homepage": "https://github.com/smicolon/ai-kit",
+      "repository": "https://github.com/smicolon/ai-kit",
+      "license": "MIT",
+      "category": "onboarding",
+      "keywords": ["onboarding", "learning", "personalization", "guidance", "ramp-up"],
+      "agents": ["./agents/onboard-guide.md"],
+      "commands": ["./commands/onboard.md"],
+      "skills": ["./skills/onboard-context-provider/SKILL.md"]
+    }
+  ]
+}

package/README.md

@@ -5,7 +5,7 @@ AI coding tool pack manager. Install convention packs (agents, skills, commands,
 ## Quick Start
 
 ```bash
-npx @smicolon/ai-kit init
+npx @smicolon/ai-kit@latest init
 ```
 
 This walks you through selecting your AI tools and stack, then installs the right files in the right places.
@@ -17,8 +17,8 @@ This walks you through selecting your AI tools and stack, then installs the righ
 Interactive first-time setup. Prompts for your AI tools, stack, and component preferences.
 
 ```bash
-npx @smicolon/ai-kit init
-npx @smicolon/ai-kit init --cwd apps/web  # monorepo sub-package
+npx @smicolon/ai-kit@latest init
+npx @smicolon/ai-kit@latest init --cwd apps/web  # monorepo sub-package
 ```
 
 ### `add <pack>`
@@ -26,11 +26,11 @@ npx @smicolon/ai-kit init --cwd apps/web  # monorepo sub-package
 Add a pack to your project.
 
 ```bash
-npx @smicolon/ai-kit add django
-npx @smicolon/ai-kit add django --skills-only
-npx @smicolon/ai-kit add django --agents-only
-npx @smicolon/ai-kit add django --rules-only
-npx @smicolon/ai-kit add django --tools claude-code,cursor
+npx @smicolon/ai-kit@latest add django
+npx @smicolon/ai-kit@latest add django --skills-only
+npx @smicolon/ai-kit@latest add django --agents-only
+npx @smicolon/ai-kit@latest add django --rules-only
+npx @smicolon/ai-kit@latest add django --tools claude-code,cursor
 ```
 
 ### `list`
@@ -38,8 +38,8 @@ npx @smicolon/ai-kit add django --tools claude-code,cursor
 Show available or installed packs.
 
 ```bash
-npx @smicolon/ai-kit list              # available packs
-npx @smicolon/ai-kit list --installed   # installed packs
+npx @smicolon/ai-kit@latest list              # available packs
+npx @smicolon/ai-kit@latest list --installed   # installed packs
 ```
 
 ### `remove <pack>`
@@ -47,7 +47,17 @@ npx @smicolon/ai-kit list --installed   # installed packs
 Remove a pack and all its installed files.
 
 ```bash
-npx @smicolon/ai-kit remove django
+npx @smicolon/ai-kit@latest remove django
+```
+
+### `search <query>`
+
+Search packs by name or keyword.
+
+```bash
+npx @smicolon/ai-kit@latest search auth
+npx @smicolon/ai-kit@latest search frontend
+npx @smicolon/ai-kit@latest search tdd
 ```
 
 ### `update [pack]`
@@ -55,8 +65,8 @@ npx @smicolon/ai-kit remove django
 Update installed packs to latest versions.
 
 ```bash
-npx @smicolon/ai-kit update          # update all
-npx @smicolon/ai-kit update django   # update one
+npx @smicolon/ai-kit@latest update          # update all
+npx @smicolon/ai-kit@latest update django   # update one
 ```
 
 ## Supported AI Tools
@@ -116,15 +126,15 @@ your-project/
 └── .gitignore               # auto-updated
 ```
 
-Config is stored in `.ai-kit.json` which tracks installed packs and all created files for clean removal.
+Tool preferences are stored globally at `~/.config/ai-kit/config.json` (pick once, works in all projects). Local `.ai-kit.json` tracks installed packs and files for clean removal — it's auto-added to `.gitignore`.
 
 ## Monorepo Support
 
 Use `--cwd` to target a sub-package. Both the sub-package and root `.gitignore` are updated.
 
 ```bash
-npx @smicolon/ai-kit init --cwd apps/web
-npx @smicolon/ai-kit add django --cwd apps/web
+npx @smicolon/ai-kit@latest init --cwd apps/web
+npx @smicolon/ai-kit@latest add django --cwd apps/web
 ```
 
 ## License