@musashishao/agent-kit 1.1.5 → 1.1.6

package/.agent/templates/AGENTS.web.md

@@ -0,0 +1,192 @@
+# AGENTS.md - Web Application
+
+> **[PROJECT_NAME]** - Modern web application built with Agent Kit standards.
+
+---
+
+## 🚀 Project Overview
+
+[Brief description of your web application]
+
+### Tech Stack
+
+| Layer | Technology | Version |
+|-------|------------|---------|
+| **Framework** | Next.js (App Router) | 15.x |
+| **UI Library** | React | 19.x |
+| **Language** | TypeScript | 5.x |
+| **Styling** | Tailwind CSS | 4.x |
+| **Database** | PostgreSQL + Prisma | - |
+| **Auth** | NextAuth.js | 5.x |
+
+---
+
+## 🛠️ Setup Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Setup database
+npx prisma generate
+npx prisma migrate dev
+
+# Start development server
+npm run dev
+
+# Build for production
+npm run build
+
+# Run linting
+npm run lint
+
+# Run tests
+npm test
+```
+
+---
+
+## 📏 Code Style & Standards
+
+### TypeScript
+- Strict mode enabled
+- No `any` types - use proper typing
+- Interfaces for props, Types for unions
+
+### React Patterns
+- Functional components only
+- Custom hooks for logic reuse
+- Server Components by default, "use client" only when needed
+- Composition over inheritance
+
+### File Naming
+- Components: `PascalCase.tsx`
+- Utilities: `camelCase.ts`
+- Styles: `kebab-case.css`
+
+### Imports
+```typescript
+// Use absolute imports with @/ alias
+import { Button } from "@/components/ui/button";
+import { cn } from "@/lib/utils";
+```
+
+---
+
+## 📁 Project Structure
+
+```
+src/
+├── app/                    # Next.js App Router
+│   ├── (marketing)/       # Marketing pages group
+│   ├── (dashboard)/       # Dashboard pages group
+│   ├── api/               # API routes
+│   ├── layout.tsx         # Root layout
+│   ├── page.tsx           # Home page
+│   └── globals.css        # Global styles
+│
+├── components/
+│   ├── ui/                # Reusable UI components
+│   ├── forms/             # Form components
+│   └── layout/            # Layout components
+│
+├── lib/
+│   ├── db.ts              # Database client
+│   ├── auth.ts            # Auth configuration
+│   └── utils.ts           # Utility functions
+│
+├── hooks/                  # Custom React hooks
+├── types/                  # TypeScript types
+└── services/              # External service integrations
+```
+
+---
+
+## 🔒 Security Guidelines
+
+### Environment Variables
+```bash
+# Required variables (never commit these)
+DATABASE_URL=
+NEXTAUTH_SECRET=
+NEXTAUTH_URL=
+```
+
+### Best Practices
+- Never hardcode secrets in code
+- Validate all user inputs (server-side)
+- Use CSRF protection for forms
+- Implement rate limiting on API routes
+- External links: `rel="noopener noreferrer"`
+
+---
+
+## 🧪 Testing
+
+```bash
+# Unit tests
+npm test
+
+# E2E tests with Playwright
+npm run test:e2e
+
+# Coverage report
+npm run test:coverage
+```
+
+### Test Structure
+```
+__tests__/
+├── unit/           # Unit tests
+├── integration/    # Integration tests
+└── e2e/            # End-to-end tests
+```
+
+---
+
+## 🚀 Deployment
+
+```bash
+# Production build
+npm run build
+
+# Preview production locally
+npm start
+
+# Deploy (example: Vercel)
+npx vercel
+```
+
+---
+
+## 🤖 AI Agent Configuration
+
+### Quick Commands
+
+| Command | Description |
+|---------|-------------|
+| `/create dashboard` | Create dashboard components |
+| `/debug login issue` | Debug authentication |
+| `/test UserProfile` | Generate tests for component |
+| `/ui-ux-pro-max hero section` | Design premium hero |
+
+### Agent Mentions
+
+- `@frontend-specialist` - React/Next.js development
+- `@backend-specialist` - API routes, Prisma
+- `@database-architect` - Schema design
+- `@security-auditor` - Security review
+- `@test-engineer` - Test generation
+
+---
+
+## 📚 Additional Resources
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [React Documentation](https://react.dev)
+- [Tailwind CSS](https://tailwindcss.com/docs)
+- [Prisma Documentation](https://www.prisma.io/docs)
+
+---
+
+*Built with Agent Kit - AI-enhanced development*

package/.agent/workflows/quality.md

@@ -0,0 +1,89 @@
+---
+description: Optimize context and output quality for Codex CLI. Use for complex tasks requiring high-quality results.
+---
+
+# /quality - Quality Optimization Workflow
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+This workflow optimizes AI output quality by:
+1. Loading relevant skills
+2. Applying context engineering
+3. Ensuring production-ready output
+
+---
+
+## Steps
+
+### Step 1: Analyze Request
+Determine the task type and required skills:
+
+| Task Type | Skills to Load |
+|-----------|----------------|
+| Frontend | `react-patterns`, `nextjs-best-practices`, `tailwind-patterns` |
+| Backend | `api-patterns`, `nodejs-best-practices`, `database-design` |
+| Mobile | `mobile-design`, `react-patterns` |
+| Security | `vulnerability-scanner`, `red-team-tactics` |
+| UI/UX | `ui-ux-pro-max`, `frontend-design` |
+| Debug | `systematic-debugging`, `problem-solving` |
+
+### Step 2: Load Context
+// turbo
+Read the relevant skill files:
+```
+Read .agent/skills/{skill-name}/SKILL.md
+```
+
+### Step 3: Apply Quality Standards
+Ensure output follows these rules:
+
+**Code Quality:**
+- [ ] No placeholder code (`// TODO`)
+- [ ] No generic variable names (`data`, `temp`)
+- [ ] Proper error handling
+- [ ] TypeScript strict types
+- [ ] Clean code principles
+
+**Output Format:**
+- [ ] Well-structured markdown
+- [ ] Code blocks with language tags
+- [ ] Clear step-by-step instructions
+- [ ] Actionable recommendations
+
+### Step 4: Validate Output
+Before delivering, check:
+
+```markdown
+## Quality Checklist
+- [ ] Code compiles without errors
+- [ ] All edge cases handled
+- [ ] Security best practices followed
+- [ ] Performance optimized
+- [ ] Documentation included
+```
+
+---
+
+## Usage Examples
+
+```
+/quality create a login form
+/quality review this API endpoint
+/quality debug the authentication flow
+```
+
+---
+
+## When to Use
+
+Use `/quality` when:
+- Building production features
+- Creating code for open source
+- Implementing security-sensitive features
+- Need highest quality output
+
+For quick tasks, use direct commands instead.

package/.agent/workflows/ui-ux-pro-max.md

@@ -4,6 +4,25 @@ description: Plan and implement UI
 
 # UI/UX Pro Max - Design Intelligence
 
+$ARGUMENTS
+
+---
+
+## ⚠️ MANDATORY: Before Starting (Socratic Gate)
+
+**DO NOT execute any search commands until you understand the user's requirements.**
+
+If the user only typed `/ui-ux-pro-max` without additional context, you MUST ask:
+
+1. **What are you building?** (landing page, dashboard, e-commerce, SaaS, mobile app, etc.)
+2. **What industry/domain?** (healthcare, fintech, beauty, gaming, education, etc.)
+3. **Any style preferences?** (minimal, dark mode, playful, professional, glassmorphism, etc.)
+4. **What tech stack?** (html-tailwind, React, Next.js, Vue, or other)
+
+**Only proceed to Step 1 after receiving answers.**
+
+---
+
 Searchable database of UI styles, color palettes, font pairings, chart types, product recommendations, UX guidelines, and stack-specific best practices.
 
 ## Prerequisites

package/README.md

@@ -1,8 +1,13 @@
 # Agent Kit
 
-> 🚀 AI Agent templates với Skills, Agents, và Workflows
+> 🚀 The Ultimate AI Agent System for Modern Development
+> 
+> **16 Agents** • **42 Skills** • **13 Workflows** • **Multi-Platform Support**
 
-## Quick Install
+[![npm version](https://badge.fury.io/js/@musashishao%2Fagent-kit.svg)](https://www.npmjs.com/package/@musashishao/agent-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ⚡ Quick Install
 
 ```bash
 npx @musashishao/agent-kit init
@@ -22,20 +27,120 @@ This installs the `.agent` folder containing all templates into your project.
 | Component | Count | Description |
 |-----------|-------|-------------|
 | **Agents** | 16 | Specialist AI personas (frontend, backend, security, etc.) |
-| **Skills** | 40 | Domain-specific knowledge modules |
-| **Workflows** | 11 | Slash command procedures |
+| **Skills** | 42 | Domain-specific knowledge modules |
+| **Workflows** | 13 | Slash command procedures |
+| **Templates** | 4 | Project templates (web, mobile, backend) |
+
+## 🔗 Multi-Platform Support
+
+Agent Kit works seamlessly with multiple AI coding assistants:
+
+| Platform | Status | Config File |
+|----------|--------|-------------|
+| **Codex CLI** | ✅ Full Support | `AGENTS.md` |
+| **Gemini CLI** | ✅ Full Support | `GEMINI.md` |
+| **Cursor** | ✅ Compatible | `.cursor/rules` |
+| **Claude Code** | ✅ Compatible | `CLAUDE.md` |
+| **Aider** | ✅ Compatible | `AGENTS.md` |
+
+---
+
+## 🎯 Codex CLI Integration
+
+### Quick Setup
+
+```bash
+# Step 1: Install Agent Kit
+npx @musashishao/agent-kit init
+
+# Step 2: Generate AGENTS.md for your project
+npx @musashishao/agent-kit codex --template web
+
+# Step 3: Sync workflows as slash commands
+npx @musashishao/agent-kit setup-codex
+
+# Step 4: Verify installation
+npx @musashishao/agent-kit doctor
+```
+
+### Available Templates
 
-## 📁 Structure
+| Template | Command | Use Case |
+|----------|---------|----------|
+| **Web** | `codex --template web` | Next.js, React, Tailwind |
+| **Mobile** | `codex --template mobile` | React Native, Flutter |
+| **Backend** | `codex --template backend` | Node.js, Express, APIs |
+| **Default** | `codex` | Generic projects |
+
+### Using Workflows in Codex CLI
+
+After running `setup-codex`, use Agent Kit workflows as slash commands:
+
+```bash
+# Create new features
+/kit-create blog with authentication
+
+# Debug issues
+/kit-debug why login returns 401
+
+# Design premium UI
+/kit-ui-ux-pro-max dashboard with glassmorphism
+
+# Quality optimization
+/kit-quality create production-ready checkout
+```
+
+---
+
+## 🛠 CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Install `.agent` folder into your project |
+| `codex` | Generate AGENTS.md for Codex CLI |
+| `setup-codex` | Sync workflows with Codex CLI slash commands |
+| `agents` | List all available agents |
+| `skills` | List all skills by category |
+| `workflows` | List all workflows |
+| `doctor` | Health check and diagnostics |
+| `update` | Update to the latest version |
+| `status` | Check installation status |
+
+### Options
+
+```bash
+# Codex template options
+agent-kit codex --template web      # Web application
+agent-kit codex --template mobile   # Mobile app
+agent-kit codex --template backend  # Backend API
+agent-kit codex --force             # Overwrite existing
+
+# Init options
+agent-kit init --force              # Overwrite existing .agent folder
+agent-kit init --path ./myapp       # Install in specific directory
+
+# Setup-codex options
+agent-kit setup-codex --prefix my-  # Custom prefix for slash commands
+```
+
+---
+
+## 📁 Project Structure
 
 ```
 .agent/
 ├── agents/          # 16 Specialist Agents
-├── skills/          # 40 Skills
-├── workflows/       # 11 Slash Commands
-├── rules/           # Workspace Rules
+├── skills/          # 42 Skills
+├── workflows/       # 13 Slash Commands
+├── rules/           # Platform-specific rules
+│   ├── CODEX.md    # Codex CLI rules
+│   └── GEMINI.md   # Gemini CLI rules
+├── templates/       # Project templates
 └── ARCHITECTURE.md  # Full documentation
 ```
 
+---
+
 ## 🎯 Usage
 
 ### Using Agents
@@ -43,8 +148,9 @@ This installs the `.agent` folder containing all templates into your project.
 Mention an agent by name to invoke specialized expertise:
 
 ```
-Use the security-auditor agent to review authentication
-Use the frontend-specialist to analyze React components
+Use the @security-auditor to review authentication
+Use the @frontend-specialist to analyze React components
+Use the @debugger to fix the login issue
 ```
 
 ### Using Skills
@@ -65,8 +171,10 @@ Invoke workflows with slash commands:
 | `/orchestrate` | Multi-agent coordination |
 | `/plan` | Create task breakdown |
 | `/preview` | Preview changes locally |
+| `/quality` | **NEW** Optimize output quality |
 | `/status` | Check project status |
 | `/test` | Generate and run tests |
+| `/context` | Context optimization |
 | `/ui-ux-pro-max` | Design with 50 styles |
 
 Example:
@@ -74,60 +182,80 @@ Example:
 /brainstorm authentication system
 /create landing page with hero section
 /debug why login fails
+/quality create production-ready API
 ```
 
-### Using Rules
+---
 
-Rules in `.agent/rules/` are automatically applied. The main configuration file is `GEMINI.md`.
+## 🌐 Platform Setup Guides
 
-## 🛠 CLI Commands
+### Gemini CLI
 
-| Command | Description |
-|---------|-------------|
-| `agent-kit init` | Install `.agent` folder into your project |
-| `agent-kit setup-codex` | Sync workflows with Codex CLI slash commands |
-| `agent-kit update` | Update to the latest version |
-| `agent-kit status` | Check installation status |
+```bash
+# Install Agent Kit
+npx @musashishao/agent-kit init
 
-### Options
+# Configure Gemini settings
+echo '{ "contextFileName": ".agent/rules/GEMINI.md" }' > .gemini/settings.json
+```
+
+### Cursor IDE
 
 ```bash
-agent-kit init --force           # Overwrite existing .agent folder
-agent-kit init --path ./myapp    # Install in specific directory
-agent-kit setup-codex --prefix my-  # Custom prefix for slash commands
-agent-kit init --quiet           # Suppress output
+# Install Agent Kit
+npx @musashishao/agent-kit init
+
+# Copy rules to Cursor
+mkdir -p .cursor/rules
+cp .agent/rules/GEMINI.md .cursor/rules/agent-kit.md
 ```
 
-## 🔗 Multi-Platform Support
+### Claude Code
 
-Agent Kit works with multiple AI coding assistants:
+```bash
+# Install Agent Kit
+npx @musashishao/agent-kit init
+
+# Copy rules for Claude
+cp .agent/rules/GEMINI.md CLAUDE.md
+```
 
-| Platform | Config | Setup |
-|----------|--------|-------|
-| **Codex CLI** | `AGENTS.md` | `npx @musashishao/agent-kit setup-codex` |
-| **Gemini CLI** | `.gemini/settings.json` | `{ "contextFileName": ".agent/rules/GEMINI.md" }` |
-| **Cursor** | `.cursor/rules` | Copy from `.agent/rules/` |
-| **Aider** | `.aider.conf.yml` | `read: AGENTS.md` |
+---
 
-### Codex CLI Integration
+## 📊 Quality Validation
 
-After installing Agent Kit, integrate with OpenAI Codex CLI:
+Ensure your setup is optimal:
 
 ```bash
-# Step 1: Install Agent Kit
-npx @musashishao/agent-kit init
+# Run health check
+npx @musashishao/agent-kit doctor
 
-# Step 2: Sync workflows to Codex CLI
-npx @musashishao/agent-kit setup-codex
+# Run quality validator
+python3 .agent/skills/context-engineering/scripts/quality_validator.py .
 ```
 
-Now you can use Agent Kit workflows as slash commands in Codex:
-- `/kit-create` - Create new apps
-- `/kit-debug` - Debug issues  
-- `/kit-brainstorm` - Explore options
-- ... and all 12 workflows!
+Expected output:
+```
+📊 Summary
+  Passed: 32/32 (100%)
+  ✓ Excellent! Agent Kit is fully configured for Codex CLI.
+```
+
+---
+
+## 📚 Documentation
+
+- **Website**: [agent-kit.musashi.works](https://agent-kit.musashi.works)
+- **AGENTS.md**: Project root
+- **ARCHITECTURE.md**: `.agent/ARCHITECTURE.md`
+- **Platform Guides**: `/docs/platforms/`
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see `.agent/ARCHITECTURE.md` for guidelines.
 
 ## License
 
 MIT © Musa (musashishao)
-