@musashishao/agent-kit 1.2.2

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/brainstorm.md

@@ -0,0 +1,113 @@
+---
+description: Structured brainstorming for projects and features. Explores multiple options before implementation.
+---
+
+# /brainstorm - Structured Idea Exploration
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
+
+---
+
+## Behavior
+
+When `/brainstorm` is triggered:
+
+1. **Understand the goal**
+   - What problem are we solving?
+   - Who is the user?
+   - What constraints exist?
+
+2. **Generate options**
+   - Provide at least 3 different approaches
+   - Each with pros and cons
+   - Consider unconventional solutions
+
+3. **Compare and recommend**
+   - Summarize tradeoffs
+   - Give a recommendation with reasoning
+
+---
+
+## Output Format
+
+```markdown
+## 🧠 Brainstorm: [Topic]
+
+### Context
+[Brief problem statement]
+
+---
+
+### Option A: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+- [benefit 2]
+
+❌ **Cons:**
+- [drawback 1]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+### Option B: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+
+❌ **Cons:**
+- [drawback 1]
+- [drawback 2]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+### Option C: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+
+❌ **Cons:**
+- [drawback 1]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+## 💡 Recommendation
+
+**Option [X]** because [reasoning].
+
+What direction would you like to explore?
+```
+
+---
+
+## Examples
+
+```
+/brainstorm authentication system
+/brainstorm state management for complex form
+/brainstorm database schema for social app
+/brainstorm caching strategy
+```
+
+---
+
+## Key Principles
+
+- **No code** - this is about ideas, not implementation
+- **Visual when helpful** - use diagrams for architecture
+- **Honest tradeoffs** - don't hide complexity
+- **Defer to user** - present options, let them decide

package/.agent/workflows/context.md

@@ -0,0 +1,47 @@
+---
+description: Auto-generate optimized context for complex tasks using Context Engineering strategies.
+---
+
+# Context Optimization Workflow
+
+This workflow automates the "Context Engineering" process. It analyzes your request, maps the project structure, summarizes relevant files, and wraps everything in a high-performance XML prompt structure for the AI.
+
+**Trigger:** `/context [your task description]`
+
+## Steps
+
+1.  **Analyze Intent:**
+    Take the user's task description ("{{task_description}}") and identify key domains (e.g., frontend, auth, database).
+
+2.  **Generate Repo Map:**
+    // turbo
+    Run the repo mapper to see the current structure.
+    `python3 .agent/skills/context-engineering/scripts/repo_mapper.py .`
+
+3.  **Construct Optimized Prompt:**
+    Based on the repo map and task, construct the following `Advanced Context` block.
+    
+    **(Internal Instruction to AI):**
+    > You must now act as a Context Engineer. Do NOT just answer the user yet.
+    > Instead, OUTPUT a structured plan and code analysis using the gathered context.
+    > Use the `<thinking>` tag to analyze the Repo Map below.
+    > If the user's task matches specific files in the map, read them using `view_file`.
+    
+    **Structure to enforce:**
+    ```xml
+    <system_role>Senior Architect</system_role>
+    <project_context>
+        [Insert Output from Step 2 here]
+    </project_context>
+    <user_task>
+        {{task_description}}
+    </user_task>
+    <instruction>
+        1. Analyze the project structure above.
+        2. Identify ensuring files that need to be read or modified.
+        3. Proceed with solving the user's task using Chain-of-Thought (<thinking> tags).
+    </instruction>
+    ```
+
+4.  **Execute:**
+    Proceed to solve the user's request using the heightened context awareness.

package/.agent/workflows/create.md

@@ -0,0 +1,59 @@
+---
+description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
+---
+
+# /create - Create Application
+
+$ARGUMENTS
+
+---
+
+## Task
+
+This command starts a new application creation process.
+
+### Steps:
+
+1. **Request Analysis**
+   - Understand what the user wants
+   - If information is missing, use `brainstorming` skill to ask clarifying questions
+
+2. **Project Planning**
+   - Use `project-planner` agent for task breakdown
+   - Determine tech stack
+   - Plan file structure
+   - Create plan file and proceed to building
+
+3. **Application Building (After Approval)**
+   - Orchestrate with `app-builder` skill
+   - Coordinate expert agents:
+     - `database-architect` → Schema
+     - `backend-specialist` → API
+     - `frontend-specialist` → UI
+
+4. **Preview**
+   - Start with `auto_preview.py` when complete
+   - Present URL to user
+
+---
+
+## Usage Examples
+
+```
+/create blog site
+/create e-commerce app with product listing and cart
+/create todo app
+/create Instagram clone
+/create crm system with customer management
+```
+
+---
+
+## Before Starting
+
+If request is unclear, ask these questions:
+- What type of application?
+- What are the basic features?
+- Who will use it?
+
+Use defaults, add details later.

package/.agent/workflows/debug.md

@@ -0,0 +1,103 @@
+---
+description: Debugging command. Activates DEBUG mode for systematic problem investigation.
+---
+
+# /debug - Systematic Problem Investigation
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+This command activates DEBUG mode for systematic investigation of issues, errors, or unexpected behavior.
+
+---
+
+## Behavior
+
+When `/debug` is triggered:
+
+1. **Gather information**
+   - Error message
+   - Reproduction steps
+   - Expected vs actual behavior
+   - Recent changes
+
+2. **Form hypotheses**
+   - List possible causes
+   - Order by likelihood
+
+3. **Investigate systematically**
+   - Test each hypothesis
+   - Check logs, data flow
+   - Use elimination method
+
+4. **Fix and prevent**
+   - Apply fix
+   - Explain root cause
+   - Add prevention measures
+
+---
+
+## Output Format
+
+```markdown
+## 🔍 Debug: [Issue]
+
+### 1. Symptom
+[What's happening]
+
+### 2. Information Gathered
+- Error: `[error message]`
+- File: `[filepath]`
+- Line: [line number]
+
+### 3. Hypotheses
+1. ❓ [Most likely cause]
+2. ❓ [Second possibility]
+3. ❓ [Less likely cause]
+
+### 4. Investigation
+
+**Testing hypothesis 1:**
+[What I checked] → [Result]
+
+**Testing hypothesis 2:**
+[What I checked] → [Result]
+
+### 5. Root Cause
+🎯 **[Explanation of why this happened]**
+
+### 6. Fix
+```[language]
+// Before
+[broken code]
+
+// After
+[fixed code]
+```
+
+### 7. Prevention
+🛡️ [How to prevent this in the future]
+```
+
+---
+
+## Examples
+
+```
+/debug login not working
+/debug API returns 500
+/debug form doesn't submit
+/debug data not saving
+```
+
+---
+
+## Key Principles
+
+- **Ask before assuming** - get full error context
+- **Test hypotheses** - don't guess randomly
+- **Explain why** - not just what to fix
+- **Prevent recurrence** - add tests, validation

package/.agent/workflows/deploy.md

@@ -0,0 +1,176 @@
+---
+description: Deployment command for production releases. Pre-flight checks and deployment execution.
+---
+
+# /deploy - Production Deployment
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+This command handles production deployment with pre-flight checks, deployment execution, and verification.
+
+---
+
+## Sub-commands
+
+```
+/deploy            - Interactive deployment wizard
+/deploy check      - Run pre-deployment checks only
+/deploy preview    - Deploy to preview/staging
+/deploy production - Deploy to production
+/deploy rollback   - Rollback to previous version
+```
+
+---
+
+## Pre-Deployment Checklist
+
+Before any deployment:
+
+```markdown
+## 🚀 Pre-Deploy Checklist
+
+### Code Quality
+- [ ] No TypeScript errors (`npx tsc --noEmit`)
+- [ ] ESLint passing (`npx eslint .`)
+- [ ] All tests passing (`npm test`)
+
+### Security
+- [ ] No hardcoded secrets
+- [ ] Environment variables documented
+- [ ] Dependencies audited (`npm audit`)
+
+### Performance
+- [ ] Bundle size acceptable
+- [ ] No console.log statements
+- [ ] Images optimized
+
+### Documentation
+- [ ] README updated
+- [ ] CHANGELOG updated
+- [ ] API docs current
+
+### Ready to deploy? (y/n)
+```
+
+---
+
+## Deployment Flow
+
+```
+┌─────────────────┐
+│  /deploy        │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  Pre-flight     │
+│  checks         │
+└────────┬────────┘
+         │
+    Pass? ──No──► Fix issues
+         │
+        Yes
+         │
+         ▼
+┌─────────────────┐
+│  Build          │
+│  application    │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  Deploy to      │
+│  platform       │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  Health check   │
+│  & verify       │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  ✅ Complete    │
+└─────────────────┘
+```
+
+---
+
+## Output Format
+
+### Successful Deploy
+
+```markdown
+## 🚀 Deployment Complete
+
+### Summary
+- **Version:** v1.2.3
+- **Environment:** production
+- **Duration:** 47 seconds
+- **Platform:** Vercel
+
+### URLs
+- 🌐 Production: https://app.example.com
+- 📊 Dashboard: https://vercel.com/project
+
+### What Changed
+- Added user profile feature
+- Fixed login bug
+- Updated dependencies
+
+### Health Check
+✅ API responding (200 OK)
+✅ Database connected
+✅ All services healthy
+```
+
+### Failed Deploy
+
+```markdown
+## ❌ Deployment Failed
+
+### Error
+Build failed at step: TypeScript compilation
+
+### Details
+```
+error TS2345: Argument of type 'string' is not assignable...
+```
+
+### Resolution
+1. Fix TypeScript error in `src/services/user.ts:45`
+2. Run `npm run build` locally to verify
+3. Try `/deploy` again
+
+### Rollback Available
+Previous version (v1.2.2) is still active.
+Run `/deploy rollback` if needed.
+```
+
+---
+
+## Platform Support
+
+| Platform | Command | Notes |
+|----------|---------|-------|
+| Vercel | `vercel --prod` | Auto-detected for Next.js |
+| Railway | `railway up` | Needs Railway CLI |
+| Fly.io | `fly deploy` | Needs flyctl |
+| Docker | `docker compose up -d` | For self-hosted |
+
+---
+
+## Examples
+
+```
+/deploy
+/deploy check
+/deploy preview
+/deploy production --skip-tests
+/deploy rollback
+```