@musashishao/agent-kit 1.0.0

package/.agent/ARCHITECTURE.md

@@ -0,0 +1,225 @@
+# Antigravity Kit Architecture
+
+> **Version 5.0** - Comprehensive AI Agent Capability Expansion Toolkit
+
+---
+
+## 📋 Overview
+
+Antigravity Kit is a modular system consisting of:
+- **16 Specialist Agents** - Role-based AI personas
+- **40 Skills** - Domain-specific knowledge modules
+- **11 Workflows** - Slash command procedures
+
+---
+
+## 🏗️ Directory Structure
+
+```
+.agent/
+├── ARCHITECTURE.md          # This file
+├── agents/                  # 16 Specialist Agents
+├── skills/                  # 40 Skills
+├── workflows/               # 11 Slash Commands
+├── rules/                   # Global Rules
+└── .shared/                 # Shared Resources
+```
+
+---
+
+## 🤖 Agents (16)
+
+Specialist AI personas for different domains.
+
+| Agent | Focus | Skills Used |
+|-------|-------|-------------|
+| `orchestrator` | Multi-agent coordination | parallel-agents, behavioral-modes |
+| `project-planner` | Discovery, task planning | brainstorming, plan-writing, architecture |
+| `frontend-specialist` | Web UI/UX | frontend-design, react-patterns, tailwind-patterns |
+| `backend-specialist` | API, business logic | api-patterns, nodejs-best-practices, database-design |
+| `database-architect` | Schema, SQL | database-design, prisma-expert |
+| `mobile-developer` | iOS, Android, RN | mobile-design |
+| `game-developer` | Game logic, mechanics | game-development |
+| `devops-engineer` | CI/CD, Docker | deployment-procedures, docker-expert |
+| `security-auditor` | Security compliance | vulnerability-scanner, red-team-tactics |
+| `penetration-tester` | Offensive security | red-team-tactics |
+| `test-engineer` | Testing strategies | testing-patterns, tdd-workflow, webapp-testing |
+| `debugger` | Root cause analysis | systematic-debugging |
+| `performance-optimizer` | Speed, Web Vitals | performance-profiling |
+| `seo-specialist` | Ranking, visibility | seo-fundamentals, geo-fundamentals |
+| `documentation-writer` | Manuals, docs | documentation-templates |
+| `explorer-agent` | Codebase analysis | - |
+
+---
+
+## 🧠 Skills (40)
+
+Domain-specific knowledge modules. Skills are loaded on-demand based on task context.
+
+### Frontend & UI
+| Skill | Description |
+|-------|-------------|
+| `react-patterns` | React hooks, state, performance |
+| `nextjs-best-practices` | App Router, Server Components |
+| `tailwind-patterns` | Tailwind CSS v4 utilities |
+| `frontend-design` | UI/UX patterns, design systems |
+| `ui-ux-pro-max` | 50 styles, 21 palettes, 50 fonts |
+
+### Backend & API
+| Skill | Description |
+|-------|-------------|
+| `api-patterns` | REST, GraphQL, tRPC |
+| `nestjs-expert` | NestJS modules, DI, decorators |
+| `nodejs-best-practices` | Node.js async, modules |
+| `python-patterns` | Python standards, FastAPI |
+
+### Database
+| Skill | Description |
+|-------|-------------|
+| `database-design` | Schema design, optimization |
+| `prisma-expert` | Prisma ORM, migrations |
+
+### TypeScript/JavaScript
+| Skill | Description |
+|-------|-------------|
+| `typescript-expert` | Type-level programming, performance |
+
+### Cloud & Infrastructure
+| Skill | Description |
+|-------|-------------|
+| `docker-expert` | Containerization, Compose |
+| `deployment-procedures` | CI/CD, deploy workflows |
+| `server-management` | Infrastructure management |
+
+### Testing & Quality
+| Skill | Description |
+|-------|-------------|
+| `testing-patterns` | Jest, Vitest, strategies |
+| `webapp-testing` | E2E, Playwright |
+| `tdd-workflow` | Test-driven development |
+| `code-review-checklist` | Code review standards |
+| `lint-and-validate` | Linting, validation |
+
+### Security
+| Skill | Description |
+|-------|-------------|
+| `vulnerability-scanner` | Security auditing, OWASP |
+| `red-team-tactics` | Offensive security |
+
+### Architecture & Planning
+| Skill | Description |
+|-------|-------------|
+| `app-builder` | Full-stack app scaffolding |
+| `architecture` | System design patterns |
+| `plan-writing` | Task planning, breakdown |
+| `brainstorming` | Socratic questioning |
+
+### Mobile
+| Skill | Description |
+|-------|-------------|
+| `mobile-design` | Mobile UI/UX patterns |
+
+### Game Development
+| Skill | Description |
+|-------|-------------|
+| `game-development` | Game logic, mechanics |
+
+### SEO & Growth
+| Skill | Description |
+|-------|-------------|
+| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals |
+| `geo-fundamentals` | GenAI optimization |
+
+### Shell/CLI
+| Skill | Description |
+|-------|-------------|
+| `bash-linux` | Linux commands, scripting |
+| `powershell-windows` | Windows PowerShell |
+
+### Other
+| Skill | Description |
+|-------|-------------|
+| `clean-code` | Coding standards (Global) |
+| `behavioral-modes` | Agent personas |
+| `parallel-agents` | Multi-agent patterns |
+| `mcp-builder` | Model Context Protocol |
+| `documentation-templates` | Doc formats |
+| `i18n-localization` | Internationalization |
+| `performance-profiling` | Web Vitals, optimization |
+| `systematic-debugging` | Troubleshooting |
+
+---
+
+## 🔄 Workflows (11)
+
+Slash command procedures. Invoke with `/command`.
+
+| Command | Description |
+|---------|-------------|
+| `/brainstorm` | Socratic discovery |
+| `/create` | Create new features |
+| `/debug` | Debug issues |
+| `/deploy` | Deploy application |
+| `/enhance` | Improve existing code |
+| `/orchestrate` | Multi-agent coordination |
+| `/plan` | Task breakdown |
+| `/preview` | Preview changes |
+| `/status` | Check project status |
+| `/test` | Run tests |
+| `/ui-ux-pro-max` | Design with 50 styles |
+
+---
+
+## 🎯 Skill Loading Protocol
+
+```
+User Request → Skill Description Match → Load SKILL.md
+                                            ↓
+                                    Read references/
+                                            ↓
+                                    Read scripts/
+```
+
+### Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # (Required) Metadata & instructions
+├── scripts/           # (Optional) Python/Bash scripts
+├── references/        # (Optional) Templates, docs
+└── assets/            # (Optional) Images, logos
+```
+
+### Enhanced Skills (with scripts/references)
+
+| Skill | Files | Coverage |
+|-------|-------|----------|
+| `typescript-expert` | 5 | Utility types, tsconfig, cheatsheet |
+| `ui-ux-pro-max` | 27 | 50 styles, 21 palettes, 50 fonts |
+| `app-builder` | 20 | Full-stack scaffolding |
+
+---
+
+## 📊 Statistics
+
+| Metric | Value |
+|--------|-------|
+| **Total Agents** | 16 |
+| **Total Skills** | 40 |
+| **Total Workflows** | 11 |
+| **Coverage** | ~90% web/mobile development |
+
+---
+
+## 🔗 Quick Reference
+
+| Need | Agent | Skills |
+|------|-------|--------|
+| Web App | `frontend-specialist` | react-patterns, nextjs-best-practices |
+| API | `backend-specialist` | api-patterns, nodejs-best-practices |
+| Mobile | `mobile-developer` | mobile-design |
+| Database | `database-architect` | database-design, prisma-expert |
+| Security | `security-auditor` | vulnerability-scanner |
+| Testing | `test-engineer` | testing-patterns, webapp-testing |
+| Debug | `debugger` | systematic-debugging |
+| Plan | `project-planner` | brainstorming, plan-writing |

package/.agent/CONTEXT.md

@@ -0,0 +1,229 @@
+# Antigravity Kit - AI Development Context
+
+> **Version:** 2.0.0  
+> **Last Updated:** 2026-01-21  
+> **Purpose:** Context prompt cho AI Agent phát triển dự án
+
+---
+
+## 🎯 Project Overview
+
+**Antigravity Kit** là một bộ AI Agent templates bao gồm Skills, Agents, và Workflows để tăng cường khả năng của AI coding assistants.
+
+### Tech Stack
+| Layer | Technology |
+|-------|------------|
+| **Framework** | Next.js 16.1.3 (App Router) |
+| **Language** | TypeScript 5.x |
+| **UI Library** | React 19.2.3 |
+| **Styling** | Tailwind CSS 4.x |
+| **Components** | @base-ui/react, lucide-react |
+| **Theme** | next-themes (dark/light mode) |
+
+### Project Structure
+```
+antigravity-kit/
+├── .agent/                    # 🧠 AI Agent System (CORE)
+│   ├── agents/               # 16 Specialist Agents
+│   ├── skills/               # 40 Domain Skills
+│   ├── workflows/            # 11 Slash Commands
+│   ├── rules/                # Global Rules
+│   └── ARCHITECTURE.md       # Full documentation
+│
+├── web/                       # 🌐 Documentation Website
+│   ├── src/
+│   │   ├── app/             # Next.js App Router pages
+│   │   │   ├── docs/        # Documentation pages
+│   │   │   ├── layout.tsx   # Root layout
+│   │   │   ├── page.tsx     # Homepage
+│   │   │   └── globals.css  # Global styles
+│   │   ├── components/      # React components
+│   │   │   ├── ui/          # 51 UI components
+│   │   │   ├── layout/      # Header, Footer, etc.
+│   │   │   └── docs/        # Docs-specific components
+│   │   ├── lib/             # Utilities
+│   │   └── hooks/           # Custom hooks
+│   ├── public/              # Static assets
+│   ├── package.json
+│   ├── next.config.ts
+│   └── tsconfig.json
+│
+├── package.json               # Root package
+├── README.md                  # Main documentation
+└── LICENSE                    # MIT License
+```
+
+---
+
+## 🔧 Development Guidelines
+
+### Code Style
+- **TypeScript:** Strict mode, explicit types
+- **Components:** Functional components, React hooks
+- **Styling:** Tailwind CSS classes, CSS variables for theming
+- **Imports:** Absolute imports with `@/` alias
+
+### Component Pattern
+```tsx
+// Standard component structure
+"use client"; // Only if client-side features needed
+
+import { cn } from "@/lib/utils";
+
+interface ComponentProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export function Component({ className, children }: ComponentProps) {
+  return (
+    <div className={cn("base-classes", className)}>
+      {children}
+    </div>
+  );
+}
+```
+
+### Theming
+- Uses CSS variables defined in `globals.css`
+- Dark mode: `.dark` class on root element
+- Color tokens: `--background`, `--foreground`, `--primary`, etc.
+
+---
+
+## 📋 Current Features
+
+### Documentation Site
+- [x] Homepage with hero section
+- [x] Documentation layout with sidebar
+- [x] Pages: Installation, CLI, Agents, Skills, Workflows
+- [x] Dark/Light mode toggle
+- [x] Responsive design
+- [x] Donate dialog (Buy Me Coffee + Bank Transfer)
+
+### Agent System
+- [x] 16 Specialist Agents (orchestrator, frontend-specialist, etc.)
+- [x] 40 Skills (react-patterns, api-patterns, etc.)
+- [x] 11 Workflows (/create, /debug, /deploy, etc.)
+- [x] GEMINI.md rules file
+- [x] Modular skill loading
+
+---
+
+## 🚀 Roadmap / TODO
+
+### Priority 1 - Security
+- [ ] Add security headers to `next.config.ts`
+- [ ] Add CSP (Content Security Policy)
+
+### Priority 2 - New Features
+- [ ] Interactive playground for testing agents
+- [ ] Search functionality for docs
+- [ ] Skill comparison tool
+- [ ] Agent workflow visualizer
+
+### Priority 3 - Improvements
+- [ ] Add more code examples to docs
+- [ ] Add API reference section
+- [ ] Add contribution guide page
+- [ ] Performance optimization
+
+---
+
+## 🎨 Design System
+
+### Colors (CSS Variables)
+```css
+/* Light Mode */
+--background: white
+--foreground: neutral-800
+--primary: neutral-800
+--accent: rgba(0,0,0,0.04)
+
+/* Dark Mode */
+--background: #0a0a0a
+--foreground: neutral-100
+--primary: neutral-100
+```
+
+### Typography
+- **Sans:** Geist Sans (--font-geist-sans)
+- **Mono:** Geist Mono (--font-geist-mono)
+
+### Components Available
+51 UI components in `/web/src/components/ui/`:
+Button, Card, Dialog, Input, Select, Sidebar, Tabs, Toast, etc.
+
+---
+
+## 🔗 Key Files Reference
+
+| Purpose | File |
+|---------|------|
+| Homepage | `web/src/app/page.tsx` |
+| Docs Layout | `web/src/app/docs/layout.tsx` |
+| Global Styles | `web/src/app/globals.css` |
+| Next Config | `web/next.config.ts` |
+| Utils | `web/src/lib/utils.ts` |
+| Docs Config | `web/src/lib/docs-config.ts` |
+| Agent Rules | `.agent/rules/GEMINI.md` |
+| Architecture | `.agent/ARCHITECTURE.md` |
+
+---
+
+## 📦 Dependencies
+
+### Production
+```json
+{
+  "next": "16.1.3",
+  "react": "19.2.3",
+  "@base-ui/react": "^1.1.0",
+  "lucide-react": "^0.562.0",
+  "next-themes": "^0.4.6",
+  "tailwind-merge": "^3.4.0",
+  "class-variance-authority": "^0.7.1"
+}
+```
+
+### Dev
+```json
+{
+  "typescript": "^5",
+  "tailwindcss": "^4",
+  "eslint": "^9",
+  "eslint-config-next": "16.1.3"
+}
+```
+
+---
+
+## 🛠️ Commands
+
+```bash
+# Development
+cd web && npm run dev    # Start dev server at localhost:3000
+
+# Build
+cd web && npm run build  # Production build
+
+# Lint
+cd web && npm run lint   # ESLint check
+```
+
+---
+
+## 💡 Usage Instructions
+
+When working on this project:
+
+1. **For Documentation Pages:** Edit files in `web/src/app/docs/`
+2. **For UI Components:** Check `web/src/components/ui/` first
+3. **For Agent/Skill Updates:** Edit files in `.agent/agents/` or `.agent/skills/`
+4. **For Styling:** Use Tailwind classes, reference `globals.css` for tokens
+
+### Important Notes
+- This is a **static documentation site** - no backend/API
+- The `.agent/` folder contains the actual product (AI templates)
+- The `web/` folder is just the marketing/docs website
+- All external links should have `rel="noopener noreferrer"`