@jhm1909/ag-kit 0.1.0

package/README.md

@@ -0,0 +1,258 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/Antigravity_Kit-v3.0-8B5CF6?style=for-the-badge&labelColor=1a1a2e" alt="Antigravity Kit" />
+</p>
+
+<h1 align="center">Antigravity Kit</h1>
+
+<p align="center">
+  <strong>Modular AI Agent Capability Kit</strong><br/>
+  <em>21 skills · 15 workflows · 10 rules — plug into any AI coding assistant</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@jhm1909/ag-kit"><img src="https://img.shields.io/npm/v/@jhm1909/ag-kit?style=flat-square&color=CB3837&label=npm" alt="npm" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License" /></a>
+  <a href="https://agentskills.io"><img src="https://img.shields.io/badge/spec-agentskills.io-7c3aed?style=flat-square" alt="Agent Skills Spec" /></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="#skills">Skills</a> ·
+  <a href="#workflows">Workflows</a> ·
+  <a href="#profiles">Profiles</a> ·
+  <a href="#architecture">Architecture</a>
+</p>
+
+---
+
+## Why Antigravity Kit?
+
+Most AI coding assistants have **zero memory** between sessions. They forget your stack, your conventions, your patterns. You end up re-explaining everything, every time.
+
+**Antigravity Kit** solves this by giving your AI assistant a persistent, structured brain:
+
+- **Skills** — Domain expertise (frontend, backend, AI, security...) loaded on-demand
+- **Workflows** — Step-by-step process chains for common tasks (brainstorm → implement → test → commit)
+- **Rules** — Always-on guardrails (coding standards, git conventions, research protocols)
+- **Manifest routing** — The right skill gets loaded at the right time, automatically
+
+> Think of it as a USB drive of expertise you plug into any AI assistant.
+
+---
+
+## Quick Start
+
+```bash
+# Install everything
+npx @jhm1909/ag-kit init
+
+# Or pick a profile
+npx @jhm1909/ag-kit init --profile fullstack-saas
+```
+
+That's it. Your `.agent/` directory is now populated with skills, workflows, and rules.
+
+---
+
+## Skills
+
+21 production-grade skills across 8 domains. Each skill includes expert knowledge, reference materials, and executable patterns.
+
+### Core Engineering
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **frontend-developer** | 292K | React/Vue/Angular, performance optimization, accessibility. *Includes Vercel React rules (65 patterns)* |
+| `react-nextjs` | 180K | Server Components, App Router, Next.js 16 |
+| `threejs` | 520K | WebGL, 3D scenes, camera systems |
+| **backend-developer** | 36K | API design, system architecture, security (Node/Python/Go/Java) |
+| **mobile-developer** | 236K | React Native, Expo, native features, 9 sub-skills |
+| **devops-engineer** | 40K | CI/CD, Docker, Kubernetes, Terraform, AWS/GCP |
+
+### Design & UX
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **designer** | 640K | BM25 searchable database: 50+ styles, 161 palettes, 57 fonts, 99 UX rules. *Anti-AI-slop aesthetic guide (Anthropic)* |
+| **app-builder** | 80K | Full-stack scaffolding orchestrator, 13 project templates |
+
+### Quality & Security
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **qa-tester** | 72K | Unit/E2E/Security/Performance testing. *Trail of Bits security audit methodology* |
+| **code-review** | 32K | Verification gates, differential review. *Trail of Bits blast-radius analysis* |
+| **debugging** | 28K | Scientific debugging: root cause analysis, 4 sub-methodologies |
+| **modern-python** | 16K | uv + ruff + ty + pytest. *Trail of Bits standard toolchain* |
+
+### AI & Integrations
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **ai-engineer** | 24K | GenAI, RAG, agentic systems, evaluation pipelines |
+| **mcp-builder** | 92K | MCP server development (TS/Python). *Anthropic official guide + eval framework* |
+| **prompt-engineer** | 12K | System prompts, few-shot, chain-of-thought |
+| **context-engineering** | 36K | Token optimization, progressive disclosure, multi-agent coordination |
+
+### Planning & Management
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **project-manager** | 96K | PRDs, roadmaps, RICE/Kano prioritization. *Dean Peters PM frameworks (discovery, JTBD)* |
+| **business-analysis** | 80K | Requirements analysis, specs, agile documentation |
+| **lead-architect** | 48K | System design, ADRs, RFCs, scalability decisions |
+
+### Specialized
+
+| Skill | Size | Key Features |
+|-------|------|--------------|
+| **blockchain-engineer** | 20K | Smart contracts, DeFi, tokenomics, EVM/Solana |
+| **game-development** | 48K | Game dev orchestrator, 10 platform sub-skills |
+| **marketer** | 80K | SEO, content strategy, video production (Remotion) |
+| **research-first** | 4K | Meta-skill: always check docs via context7 MCP before coding |
+
+---
+
+## Workflows
+
+15 chainable workflows that guide you from idea to deployment:
+
+```
+New Project    /brainstorm -> /documentation -> /break-tasks -> /implement-feature -> /commit
+New Feature    /break-tasks -> /implement-feature -> /gen-tests -> /commit
+Bug Fix        /development -> /gen-tests -> /commit
+Deep Debug     /debug -> /commit
+UI/UX          /ui-ux-design -> /break-tasks -> /implement-feature -> /commit
+Study Kit      /absorb -> /break-tasks -> /implement-feature -> /commit
+MVP Sprint     /brainstorm -> /documentation -> [/break-tasks -> /implement -> /commit] x N
+```
+
+| Workflow | Purpose |
+|----------|---------|
+| `/guide` | Interactive discovery — finds the right workflow for your task |
+| `/brainstorm` | Idea analysis, high-level roadmap + PRD |
+| `/documentation` | Architecture docs, API specs, technical specs |
+| `/break-tasks` | Requirements to actionable task breakdown |
+| `/implement-feature` | Spec-to-code implementation |
+| `/development` | Quick fixes and minor changes |
+| `/debug` | Scientific debugging with hypothesis testing |
+| `/ui-ux-design` | Requirements to comprehensive UI/UX deliverables |
+| `/qa` | Test plans and test case documents |
+| `/gen-tests` | Auto-generate unit, E2E, security, and perf tests |
+| `/absorb` | Study reference projects and extract best practices |
+| `/commit` | 3-mode git workflow (Quick / Safe / Custom) |
+| `/bootstrap` | Project scaffolding from architectural specs |
+| `/install-skill` | Install skills from GitHub repos or registries |
+| `/custom-behavior` | Modify agent rules and workflows |
+
+---
+
+## Profiles
+
+Install only what you need:
+
+```bash
+npx @jhm1909/ag-kit init --profile <name>
+```
+
+| Profile | Included Skills | Optional |
+|---------|----------------|----------|
+| **web-frontend** | frontend-developer, designer | react-nextjs, threejs |
+| **fullstack-saas** | frontend, backend, devops, PM, QA | react-nextjs, ai-engineer, lead-architect |
+| **mobile-app** | mobile-developer, designer, QA | backend, devops |
+| **ai-powered-app** | ai-engineer, frontend, backend | lead-architect, prompt-engineer |
+| **video-content** | marketer, frontend, remotion | threejs, designer |
+| **blockchain-dapp** | blockchain, frontend, backend | devops, lead-architect |
+
+---
+
+## Architecture
+
+```
+USER -> /guide (Discovery)
+  -> Workflow Chain (Orchestration)
+    -> Invoke [skill] (Expertise)
+      -> skills-manifest.json (Routing)
+        -> Rules (Guardrails)
+```
+
+### Project Structure
+
+```
+.agent/
+├── skills-manifest.json      <- Single source of truth
+├── ARCHITECTURE.md            <- Detailed architecture docs
+├── skills/                    <- 21 expert skills
+│   ├── frontend-developer/
+│   │   ├── SKILL.md
+│   │   ├── react-nextjs/      <- Sub-skill
+│   │   ├── threejs/           <- Sub-skill
+│   │   └── references/        <- Vercel React performance rules
+│   ├── mcp-builder/
+│   │   ├── SKILL.md
+│   │   └── references/        <- Anthropic MCP guides (TS, Python, eval)
+│   ├── designer/
+│   │   ├── SKILL.md
+│   │   ├── scripts/           <- BM25 search engine
+│   │   └── references/        <- Anti-AI-slop aesthetics guide
+│   └── ...
+├── workflows/                 <- 15 chainable workflows
+├── rules/                     <- 10 always-on rules
+└── known-registries.json      <- External skill sources
+```
+
+---
+
+## Absorbed Methodologies
+
+This kit integrates production-grade methodologies from industry leaders:
+
+| Source | License | Skills Enhanced |
+|--------|---------|----------------|
+| [Trail of Bits](https://www.trailofbits.com/) | — | `qa-tester` v3 (security audit), `code-review` v2 (differential review), `modern-python` (uv/ruff/ty) |
+| [Vercel](https://vercel.com/) | — | `frontend-developer` v4 (65 React performance patterns, composition rules) |
+| [Dean Peters](https://deanpeters.net/) | — | `project-manager` v5 (discovery process, PRD framework, Jobs-to-be-Done) |
+| [Anthropic](https://github.com/anthropics/skills) | Apache 2.0 | `mcp-builder` (MCP server guide + eval), `designer` v4 (anti-AI-slop aesthetics) |
+
+---
+
+## Compatibility
+
+Works with any AI coding assistant that reads `.agent/` directories:
+
+| Platform | Status |
+|----------|--------|
+| Claude Code (Anthropic) | Supported |
+| Gemini CLI (Google) | Supported |
+| Cursor (Anysphere) | Supported |
+| GitHub Copilot (Microsoft) | Supported |
+
+Skills follow the [agentskills.io](https://agentskills.io) specification.
+
+---
+
+## CLI Reference
+
+```bash
+ag-kit init                       # Install full kit
+ag-kit init --profile <name>      # Install specific profile
+ag-kit init --force               # Overwrite existing installation
+ag-kit list                       # Show available profiles and skills
+ag-kit status                     # Check installed version
+ag-kit help                       # Show all commands
+```
+
+---
+
+## Stats
+
+```
+21 skills · 15 workflows · 10 rules · 6 profiles
+4 absorbed sources · 2,600K+ knowledge base
+```
+
+---
+
+## License
+
+MIT — [jhm1909](https://github.com/jhm1909)

package/cli/index.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+
+/**
+ * @jhm1909/ag-kit — AI Agent Kit CLI
+ * 
+ * Commands:
+ *   init [--profile <name>] [--force]  Install the agent kit
+ *   list                               Show available profiles
+ *   status                             Check installed kit version
+ *   verify                             Run kit integrity checks
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ─── Constants ───────────────────────────────────────────────────────
+const VERSION = '0.1.0';
+const KIT_NAME = '@jhm1909/ag-kit';
+const AGENT_DIR = '.agent';
+
+// Package root (where this CLI lives)
+const PACKAGE_ROOT = path.join(__dirname, '..');
+const SOURCE_AGENT_DIR = path.join(PACKAGE_ROOT, AGENT_DIR);
+
+// Colors for terminal output
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+  white: '\x1b[37m',
+  bgBlue: '\x1b[44m',
+};
+
+// ─── Utilities ───────────────────────────────────────────────────────
+
+function log(msg = '') { console.log(msg); }
+function info(msg) { console.log(`${c.cyan}ℹ${c.reset} ${msg}`); }
+function success(msg) { console.log(`${c.green}✓${c.reset} ${msg}`); }
+function warn(msg) { console.log(`${c.yellow}⚠${c.reset} ${msg}`); }
+function error(msg) { console.error(`${c.red}✗${c.reset} ${msg}`); }
+
+function banner() {
+  log();
+  log(`${c.bold}${c.magenta}  ⚡ Antigravity Kit${c.reset} ${c.dim}v${VERSION}${c.reset}`);
+  log(`${c.dim}  AI Agent Skills, Workflows & Knowledge Graph${c.reset}`);
+  log();
+}
+
+/**
+ * Recursively copy directory, optionally filtering by allowed dirs
+ */
+function copyDir(src, dest, allowedDirs = null, depth = 0) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  let fileCount = 0;
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip tmp/ directory always
+    if (entry.name === 'tmp') continue;
+
+    // At skills level (depth 1, parent is "skills"), filter by allowed dirs
+    if (depth === 1 && allowedDirs && entry.isDirectory()) {
+      if (!allowedDirs.includes(entry.name)) continue;
+    }
+
+    if (entry.isDirectory()) {
+      const isSkillsDir = entry.name === 'skills';
+      fileCount += copyDir(srcPath, destPath, allowedDirs, isSkillsDir ? 1 : depth);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      fileCount++;
+    }
+  }
+
+  return fileCount;
+}
+
+/**
+ * Load skills-manifest.json from package
+ */
+function loadManifest() {
+  const manifestPath = path.join(SOURCE_AGENT_DIR, 'skills-manifest.json');
+  if (!fs.existsSync(manifestPath)) {
+    error('skills-manifest.json not found in package');
+    process.exit(1);
+  }
+  return JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+}
+
+/**
+ * Get all skill names needed for a profile (including sub-skills)
+ */
+function getProfileSkills(manifest, profileName) {
+  const profile = manifest.profiles[profileName];
+  if (!profile) return null;
+
+  const skillNames = [...profile.skills];
+  if (profile.optional) {
+    skillNames.push(...profile.optional);
+  }
+
+  // Add core skills always
+  if (manifest.core) {
+    for (const core of manifest.core) {
+      if (!skillNames.includes(core)) {
+        skillNames.push(core);
+      }
+    }
+  }
+
+  // Resolve sub-skills: for each skill, include its directory (which contains sub-skills)
+  // No extra resolution needed since we copy entire skill directories
+  return skillNames;
+}
+
+// ─── Commands ────────────────────────────────────────────────────────
+
+function cmdInit(args) {
+  const targetDir = process.cwd();
+  const targetAgentDir = path.join(targetDir, AGENT_DIR);
+  const profile = args.profile;
+  const force = args.force;
+
+  // Check if .agent/ already exists
+  if (fs.existsSync(targetAgentDir) && !force) {
+    error(`${AGENT_DIR}/ already exists in this directory.`);
+    log(`  Use ${c.bold}ag-kit init --force${c.reset} to overwrite.`);
+    process.exit(1);
+  }
+
+  // Check source exists
+  if (!fs.existsSync(SOURCE_AGENT_DIR)) {
+    error('Agent kit source not found. Package may be corrupted.');
+    process.exit(1);
+  }
+
+  // Profile-based install
+  let allowedSkills = null;
+  if (profile) {
+    const manifest = loadManifest();
+    allowedSkills = getProfileSkills(manifest, profile);
+    if (!allowedSkills) {
+      error(`Profile "${profile}" not found.`);
+      log(`  Run ${c.bold}ag-kit list${c.reset} to see available profiles.`);
+      process.exit(1);
+    }
+    info(`Installing profile: ${c.bold}${profile}${c.reset}`);
+    info(`Skills: ${allowedSkills.join(', ')}`);
+  } else {
+    info('Installing full agent kit...');
+  }
+
+  // Remove existing if force
+  if (force && fs.existsSync(targetAgentDir)) {
+    fs.rmSync(targetAgentDir, { recursive: true, force: true });
+    warn('Removed existing .agent/ directory');
+  }
+
+  // Copy .agent/ directory
+  const fileCount = copyDir(SOURCE_AGENT_DIR, targetAgentDir, allowedSkills);
+  
+  log();
+  success(`${c.bold}Agent kit installed!${c.reset} (${fileCount} files)`);
+  log();
+  log(`${c.dim}  Installed to: ${targetAgentDir}${c.reset}`);
+  log();
+  log(`${c.bold}  What's included:${c.reset}`);
+  log(`  ${c.cyan}|${c.reset} Skills      ${c.dim}Expert AI skill definitions${c.reset}`);
+  log(`  ${c.cyan}|${c.reset} Workflows   ${c.dim}Chainable task automations${c.reset}`);
+  log(`  ${c.cyan}|${c.reset} Rules       ${c.dim}Coding standards & guardrails${c.reset}`);
+  log(`  ${c.cyan}|${c.reset} Manifest    ${c.dim}Skill routing & profiles${c.reset}`);
+  log();
+  log(`${c.dim}  Works with: Claude Code, Cursor, Gemini CLI, GitHub Copilot${c.reset}`);
+  log();
+}
+
+function cmdList() {
+  const manifest = loadManifest();
+  const profiles = manifest.profiles;
+
+  log(`${c.bold}Available Profiles${c.reset}`);
+  log(`${c.dim}${'─'.repeat(64)}${c.reset}`);
+  log();
+
+  for (const [key, profile] of Object.entries(profiles)) {
+    const skills = profile.skills.join(', ');
+    const optional = profile.optional ? ` ${c.dim}+ optional: ${profile.optional.join(', ')}${c.reset}` : '';
+    
+    log(`  ${c.bold}${c.cyan}${key}${c.reset}`);
+    log(`  ${profile.description}`);
+    log(`  ${c.dim}Skills: ${skills}${optional}${c.reset}`);
+    log();
+  }
+
+  log(`${c.dim}Usage: ag-kit init --profile <name>${c.reset}`);
+  log();
+
+  // Also show all skills
+  log(`${c.bold}All Skills (${Object.keys(manifest.skills).length})${c.reset}`);
+  log(`${c.dim}${'─'.repeat(64)}${c.reset}`);
+  log();
+
+  for (const [key, skill] of Object.entries(manifest.skills)) {
+    const parent = skill.parent ? ` ${c.dim}(sub of ${skill.parent})${c.reset}` : '';
+    log(`  ${c.green}●${c.reset} ${c.bold}${key}${c.reset}${parent} — ${skill.description}`);
+  }
+  log();
+}
+
+function cmdStatus() {
+  const targetDir = process.cwd();
+  const targetAgentDir = path.join(targetDir, AGENT_DIR);
+  const manifestPath = path.join(targetAgentDir, 'skills-manifest.json');
+
+  if (!fs.existsSync(targetAgentDir)) {
+    warn('Agent kit is ${c.bold}not installed${c.reset} in this directory.');
+    log(`  Run ${c.bold}ag-kit init${c.reset} to install.`);
+    return;
+  }
+
+  // Count installed items
+  const skillsDir = path.join(targetAgentDir, 'skills');
+  const workflowsDir = path.join(targetAgentDir, 'workflows');
+  const rulesDir = path.join(targetAgentDir, 'rules');
+
+  const skillCount = fs.existsSync(skillsDir) 
+    ? fs.readdirSync(skillsDir, { withFileTypes: true }).filter(d => d.isDirectory()).length 
+    : 0;
+  const workflowCount = fs.existsSync(workflowsDir) 
+    ? fs.readdirSync(workflowsDir).filter(f => f.endsWith('.md')).length 
+    : 0;
+  const ruleCount = fs.existsSync(rulesDir) 
+    ? fs.readdirSync(rulesDir).filter(f => f.endsWith('.md')).length 
+    : 0;
+
+  const hasManifest = fs.existsSync(manifestPath);
+
+  log(`${c.bold}Agent Kit Status${c.reset}`);
+  log(`${c.dim}${'─'.repeat(40)}${c.reset}`);
+  log(`  ${c.cyan}Version:${c.reset}    ${VERSION}`);
+  log(`  ${c.cyan}Location:${c.reset}   ${targetAgentDir}`);
+  log(`  ${c.cyan}Skills:${c.reset}     ${skillCount}`);
+  log(`  ${c.cyan}Workflows:${c.reset}  ${workflowCount}`);
+  log(`  ${c.cyan}Rules:${c.reset}      ${ruleCount}`);
+  log(`  ${c.cyan}Manifest:${c.reset}   ${hasManifest ? 'yes' : 'no'}`);
+  log();
+}
+
+function cmdVerify() {
+  // Delegate to verify.js
+  const verifyPath = path.join(__dirname, 'verify.js');
+  require(verifyPath);
+}
+
+
+function cmdHelp() {
+  banner();
+  log(`${c.bold}Usage:${c.reset} ag-kit <command> [options]`);
+  log();
+  log(`${c.bold}Commands:${c.reset}`);
+  log(`  ${c.cyan}init${c.reset}                    Install the agent kit in current directory`);
+  log(`  ${c.cyan}init --profile <name>${c.reset}   Install specific profile (e.g., web-frontend)`);
+  log(`  ${c.cyan}init --force${c.reset}             Overwrite existing installation`);
+  log(`  ${c.cyan}list${c.reset}                     Show available profiles and skills`);
+  log(`  ${c.cyan}status${c.reset}                   Check installed kit version and stats`);
+  log(`  ${c.cyan}verify${c.reset}                   Run kit integrity checks`);
+  log(`  ${c.cyan}help${c.reset}                     Show this help message`);
+  log();
+  log(`${c.bold}Examples:${c.reset}`);
+  log(`  ${c.dim}$ npx ${KIT_NAME} init${c.reset}`);
+  log(`  ${c.dim}$ npx ${KIT_NAME} init --profile fullstack-saas${c.reset}`);
+  log(`  ${c.dim}$ npx ${KIT_NAME} list${c.reset}`);
+  log();
+}
+
+// ─── Argument Parser ─────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const result = { command: null, profile: null, force: false };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--help' || arg === '-h') {
+      result.command = 'help';
+    } else if (arg === '--version' || arg === '-v') {
+      console.log(VERSION);
+      process.exit(0);
+    } else if (arg === '--force' || arg === '-f') {
+      result.force = true;
+    } else if (arg === '--profile' || arg === '-p') {
+      result.profile = args[++i];
+    } else if (!arg.startsWith('-')) {
+      result.command = arg;
+    }
+  }
+
+  return result;
+}
+
+// ─── Main ────────────────────────────────────────────────────────────
+
+function main() {
+  const args = parseArgs(process.argv);
+
+  banner();
+
+  switch (args.command) {
+    case 'init':
+      cmdInit(args);
+      break;
+    case 'list':
+      cmdList();
+      break;
+    case 'status':
+      cmdStatus();
+      break;
+    case 'verify':
+      cmdVerify();
+      break;
+    case 'help':
+    case null:
+      cmdHelp();
+      break;
+    default:
+      error(`Unknown command: ${args.command}`);
+      log(`  Run ${c.bold}ag-kit help${c.reset} for usage.`);
+      process.exit(1);
+  }
+}
+
+main();