@agentskillkit/agent-skills 1.0.1 → 3.2.2

package/.agent/ARCHITECTURE.md

@@ -6,11 +6,12 @@
 
 ## 📋 Overview
 
-Antigravity Kit is a modular system consisting of:
+Agent Skills Kit is a modular system consisting of:
 
-- **20 Specialist Agents** - Role-based AI personas
-- **48 Skills** - Domain-specific knowledge modules
-- **14 Workflows** - Slash command procedures
+- **25 Specialist Agents** - Role-based AI personas (20 domain + 5 meta)
+- **45 Skills** - Domain-specific knowledge modules
+- **24 Workflows** - Slash command procedures
+- **5 Workflow Chains** - Multi-skill execution sequences
 
 ---
 
@@ -19,175 +20,298 @@ Antigravity Kit is a modular system consisting of:
 ```plaintext
 .agent/
 ├── ARCHITECTURE.md          # This file
+├── GEMINI.md                # Global AI rules & protocols
 ├── agents/                  # 20 Specialist Agents
-├── skills/                  # 48 Skills
-├── workflows/               # 14 Slash Commands
-├── rules/                   # Global Rules
-└── scripts/                 # Master Validation Scripts
+├── config/                  # Configuration files
+├── docs/                    # Additional documentation
+├── knowledge/               # Learning patterns & lessons
+├── scripts-js/              # Master Validation Scripts (JS)
+├── skills/                  # 45 Skills + registry.json
+├── studio/                  # Studio design system tools
+└── workflows/               # 18 Slash Commands
 ```
 
 ---
 
-## 🤖 Agents (20)
+## 🔄 Hybrid Runtime Architecture
+
+### 2-Tier Design
+
+Agent Skills Kit uses a **hybrid architecture** combining JavaScript and Python:
+
+```
+┌──────────────────────────────────┐
+│ TIER 1: Master Scripts (JS)      │
+│ - Orchestration & workflow       │
+│ - User-facing CLI commands       │
+│ - Project management             │
+└──────────────┬───────────────────┘
+               │ child_process.spawn()
+               ↓
+┌──────────────────────────────────┐
+│ TIER 2: Skill Scripts (Python)   │
+│ - Specialized validation (34)    │
+│ - Security scanning              │
+│ - Performance auditing           │
+│ - E2E testing automation         │
+└──────────────────────────────────┘
+```
+
+### Runtime Requirements
+
+- **Node.js 18+** - Required for all operations
+- **Python 3.8+** - Required for skill validation scripts
+
+See [PYTHON_STRATEGY.md](../PYTHON_STRATEGY.md) for architecture rationale.
+
+---
+
+## 🎨 Studio (Design System Generator)
+
+**Location:** `.agent/skills/studio/`
+
+Studio provides AI-powered design system generation using BM25 search across curated design databases.
+
+### Purpose
+
+Generate high-quality UI/UX code by searching 24 CSV databases containing:
+
+- 50+ design styles (Minimalism, Glassmorphism, Brutalism...)
+- 95+ color palettes (SaaS, E-commerce, Fintech...)
+- 60+ font pairings (Google Fonts combinations)
+- 12 framework-specific guidelines (React, Vue, SwiftUI...)
+
+### Components
+
+| Component       | Purpose               | Files                                |
+| --------------- | --------------------- | ------------------------------------ |
+| **data/**       | Design knowledge base | 24 CSV files (241 KB)                |
+| **scripts-js/** | BM25 search engine    | core.js, design_system.js, search.js |
+
+### Usage
+
+```bash
+# Search design guidelines
+npm run studio:search "minimalist dashboard"
+
+# Generate design system
+npm run studio:design
+
+# Stack-specific search
+node .agent/skills/studio/scripts-js/search.js "layout" --stack nextjs
+```
+
+### Data Domains (11)
+
+- **style** - Design styles (styles.csv)
+- **color** - Color palettes (colors.csv)
+- **typography** - Font pairings (typography.csv)
+- **ux** - UX guidelines (ux-guidelines.csv)
+- **icons** - Icon libraries (icons.csv)
+- **chart** - Data visualization (charts.csv)
+- **landing** - Landing patterns (landing.csv)
+- **product** - Product-specific (products.csv)
+- **prompt** - AI prompts (prompts.csv)
+- **react** - React performance (react-performance.csv)
+- **web** - Web interface (web-interface.csv)
+
+### Supported Stacks (12)
+
+Next.js, React, Vue, Nuxt, Svelte, SwiftUI, React Native, Flutter, HTML/Tailwind, shadcn/ui, Jetpack Compose, Nuxt UI
+
+See [STUDIO_MIGRATION.md](../STUDIO_MIGRATION.md) for migration details.
+
+---
+
+## 🤖 Agents (25)
 
 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 |
-| `product-manager` | Requirements, user stories | plan-writing, brainstorming |
-| `product-owner` | Strategy, backlog, MVP | plan-writing, brainstorming |
-| `qa-automation-engineer` | E2E testing, CI pipelines | webapp-testing, testing-patterns |
-| `code-archaeologist` | Legacy code, refactoring | clean-code, code-review-checklist |
-| `explorer-agent` | Codebase analysis | - |
+### Meta-Agents (Runtime Control)
+
+| Agent                  | Focus                    | Skills Used                       |
+| ---------------------- | ------------------------ | --------------------------------- |
+| `lead-orchestrator`    | Strategic coordination   | agent-patterns, code-craft        |
+| `runtime-orchestrator` | Runtime control          | lifecycle-orchestrator, code-craft |
+| `assessor`             | Risk analysis            | code-review, project-planner      |
+| `recovery`             | State rollback           | state-rollback, code-craft        |
+| `critic`               | Conflict resolution      | code-review, code-quality         |
+| `learner`              | Continuous improvement   | auto-learner, self-evolution      |
+
+### Domain Agents (20)
+
+| Agent                    | Focus                      | Skills Used                                     |
+| ------------------------ | -------------------------- | ----------------------------------------------- |
+| `orchestrator`           | Multi-agent coordination   | agent-patterns, code-craft                      |
+| `project-planner`        | Discovery, task planning   | idea-storm, project-planner, system-design      |
+| `frontend-specialist`    | Web UI/UX                  | design-system, react-architect, tailwind-kit    |
+| `backend-specialist`     | API, business logic        | api-architect, nodejs-pro, data-modeler         |
+| `database-architect`     | Schema, SQL                | data-modeler, code-craft                        |
+| `mobile-developer`       | iOS, Android, RN           | mobile-first, code-craft                        |
+| `game-developer`         | Game logic, mechanics      | game-engine, code-craft                         |
+| `devops-engineer`        | CI/CD, Docker              | cicd-pipeline, server-ops, shell-script         |
+| `security-auditor`       | Security compliance        | security-scanner, offensive-sec, api-architect  |
+| `penetration-tester`     | Offensive security         | offensive-sec, security-scanner                 |
+| `test-engineer`          | Testing strategies         | test-architect, test-driven-dev, e2e-automation |
+| `debugger`               | Root cause analysis        | debug-pro, code-craft                       |
+| `performance-optimizer`  | Speed, Web Vitals          | perf-optimizer, code-craft                      |
+| `seo-specialist`         | Ranking, visibility        | seo-optimizer, geo-spatial                      |
+| `documentation-writer`   | Manuals, docs              | doc-templates, code-craft                       |
+| `product-manager`        | Requirements, user stories | project-planner, idea-storm                     |
+| `product-owner`          | Strategy, backlog, MVP     | project-planner, idea-storm                     |
+| `qa-automation-engineer` | E2E testing, CI pipelines  | e2e-automation, test-architect                  |
+| `code-archaeologist`     | Legacy code, refactoring   | code-craft, code-review                         |
+| `explorer-agent`         | Codebase analysis          | system-design, debug-pro                        |
 
 ---
 
-## 🧩 Skills (36)
+## 🧩 Skills (45)
 
 Modular knowledge domains that agents can load 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 |
+| Skill            | Description                      |
+| ---------------- | -------------------------------- |
+| `ReactArchitect` | React hooks, state, performance  |
+| `NextJSPro`      | App Router, Server Components    |
+| `TailwindKit`    | Tailwind CSS v4 utilities        |
+| `DesignSystem`   | UI/UX patterns, design systems   |
+| `studio`         | 50 styles, 21 palettes, 50 fonts |
 
 ### Backend & API
 
-| Skill | Description |
-| ----- | ----------- |
-| `api-patterns` | REST, GraphQL, tRPC |
+| Skill           | Description                    |
+| --------------- | ------------------------------ |
+| `APIArchitect`  | REST, GraphQL, tRPC            |
 | `nestjs-expert` | NestJS modules, DI, decorators |
-| `nodejs-best-practices` | Node.js async, modules |
-| `python-patterns` | Python standards, FastAPI |
+| `NodeJSPro`     | Node.js async, modules         |
+| `PythonPro`     | Python standards, FastAPI      |
 
 ### Database
 
-| Skill | Description |
-| ----- | ----------- |
-| `database-design` | Schema design, optimization |
-| `prisma-expert` | Prisma ORM, migrations |
+| Skill           | Description                 |
+| --------------- | --------------------------- |
+| `DataModeler`   | Schema design, optimization |
+| `prisma-expert` | Prisma ORM, migrations      |
 
 ### TypeScript/JavaScript
 
-| Skill | Description |
-| ----- | ----------- |
+| Skill               | Description                         |
+| ------------------- | ----------------------------------- |
 | `typescript-expert` | Type-level programming, performance |
 
 ### Cloud & Infrastructure
 
-| Skill | Description |
-| ----- | ----------- |
+| Skill           | Description               |
+| --------------- | ------------------------- |
 | `docker-expert` | Containerization, Compose |
-| `deployment-procedures` | CI/CD, deploy workflows |
-| `server-management` | Infrastructure management |
+| `CICDPipeline`  | CI/CD, deploy workflows   |
+| `ServerOps`     | 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 |
+| Skill           | Description              |
+| --------------- | ------------------------ |
+| `TestArchitect` | Jest, Vitest, strategies |
+| `E2EAutomation` | E2E, Playwright          |
+| `TestDrivenDev` | Test-driven development  |
+| `CodeReview`    | Code review standards    |
+| `CodeQuality`   | Linting, validation      |
 
 ### Security
 
-| Skill | Description |
-| ----- | ----------- |
-| `vulnerability-scanner` | Security auditing, OWASP |
-| `red-team-tactics` | Offensive security |
+| Skill             | Description              |
+| ----------------- | ------------------------ |
+| `SecurityScanner` | Security auditing, OWASP |
+| `OffensiveSec`    | Offensive security       |
 
 ### Architecture & Planning
 
-| Skill | Description |
-| ----- | ----------- |
-| `app-builder` | Full-stack app scaffolding |
-| `architecture` | System design patterns |
-| `plan-writing` | Task planning, breakdown |
-| `brainstorming` | Socratic questioning |
+| Skill            | Description                |
+| ---------------- | -------------------------- |
+| `AppScaffold`    | Full-stack app scaffolding |
+| `SystemDesign`   | System design patterns     |
+| `ProjectPlanner` | Task planning, breakdown   |
+| `IdeaStorm`      | Socratic questioning       |
 
 ### Mobile
 
-| Skill | Description |
-| ----- | ----------- |
-| `mobile-design` | Mobile UI/UX patterns |
+| Skill         | Description           |
+| ------------- | --------------------- |
+| `MobileFirst` | Mobile UI/UX patterns |
 
 ### Game Development
 
-| Skill | Description |
-| ----- | ----------- |
-| `game-development` | Game logic, mechanics |
+| Skill        | Description           |
+| ------------ | --------------------- |
+| `GameEngine` | Game logic, mechanics |
 
 ### SEO & Growth
 
-| Skill | Description |
-| ----- | ----------- |
-| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals |
-| `geo-fundamentals` | GenAI optimization |
+| Skill          | Description                   |
+| -------------- | ----------------------------- |
+| `SEOOptimizer` | SEO, E-E-A-T, Core Web Vitals |
+| `GeoSpatial`   | GenAI optimization            |
 
 ### Shell/CLI
 
-| Skill | Description |
-| ----- | ----------- |
-| `bash-linux` | Linux commands, scripting |
-| `powershell-windows` | Windows PowerShell |
+| Skill         | Description               |
+| ------------- | ------------------------- |
+| `ShellScript` | Linux commands, scripting |
+| `PowerShell`  | 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 |
+| Skill              | Description               |
+| ------------------ | ------------------------- |
+| `CodeCraft`        | Coding standards (Global) |
+| `AgentPatterns`    | Agent patterns (consolidated) |
+| `MCPServer`        | Model Context Protocol    |
+| `DocTemplates`     | Doc formats               |
+| `PerfOptimizer`    | Web Vitals, optimization  |
+| `DebugPro`         | Unified debugging (4-phase + frameworks) |
 
 ---
 
-## 🔄 Workflows (14)
+## 🔄 Workflows (24)
 
 Slash command procedures. Invoke with `/command`.
 
-| Command | Description |
-| ------- | ----------- |
-| `/think` | Structured brainstorming |
-| `/build` | Create new features/apps |
-| `/diagnose` | Debug issues systematically |
-| `/launch` | Deploy to production |
-| `/chronicle` | Generate documentation |
-| `/boost` | Improve existing code |
-| `/autopilot` | Multi-agent coordination |
-| `/architect` | Task breakdown & planning |
-| `/stage` | Preview/staging server |
-| `/inspect` | Code review verification |
-| `/forge` | Create/package skills |
-| `/pulse` | Check project status |
-| `/validate` | Run tests |
-| `/studio` | Design with 50+ styles |
+| Command                | Description                 | Chain             |
+| ---------------------- | --------------------------- | ----------------- |
+| `/build`               | Create new features/apps    | build-web-app     |
+| `/boost`               | Improve existing code       | build-web-app     |
+| `/autopilot`           | Multi-agent coordination    | build-web-app     |
+| `/launch`              | Deploy to production        | deploy-production |
+| `/diagnose`            | Debug issues systematically | debug-complex     |
+| `/inspect`             | Code review verification    | security-audit    |
+| `/think`               | Structured brainstorming    | -                 |
+| `/architect`           | Task breakdown & planning   | -                 |
+| `/validate`            | Run tests                   | -                 |
+| `/chronicle`           | Generate documentation      | -                 |
+| `/stage`               | Preview/staging server      | -                 |
+| `/forge`               | Create/package skills       | -                 |
+| `/pulse`               | Check project status        | -                 |
+| `/studio`              | Design with 50+ styles      | -                 |
+| `/flags`               | Feature flag management     | -                 |
+| `/api`                 | API design & implementation | api-development   |
+| `/agent`               | Agent CLI interface         | -                 |
+| `/auto-accept-process` | Autonomous workflow         | -                 |
+
+---
+
+## 🔗 Workflow Chains (5)
+
+Multi-skill execution sequences defined in `registry.json`.
+
+| Chain               | Description                 | Skills                                                                                           | Workflows                  |
+| ------------------- | --------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------- |
+| `build-web-app`     | Full-stack development      | app-scaffold, project-planner, web-core, design-system, tailwind-kit, test-architect, code-craft | /build, /boost, /autopilot |
+| `deploy-production` | Production deployment       | cicd-pipeline, security-scanner, perf-optimizer, e2e-automation, feature-flags                   | /launch                    |
+| `debug-complex`     | Deep debugging              | debug-pro, debug-toolkit, reasoning-engine, test-architect                                       | /diagnose                  |
+| `security-audit`    | Security review             | security-scanner, code-review, offensive-sec, cicd-pipeline                                      | /inspect                   |
+| `api-development`   | API design & implementation | api-architect, data-modeler, nodejs-pro, test-architect, security-scanner                        | -                          |
 
 ---
 
@@ -213,38 +337,66 @@ skill-name/
 
 ### 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 |
+| Skill               | Files | Coverage                            |
+| ------------------- | ----- | ----------------------------------- |
+| `typescript-expert` | 5     | Utility types, tsconfig, cheatsheet |
+| `studio`            | 27    | 50 styles, 21 palettes, 50 fonts    |
+| `AppScaffold`       | 20    | Full-stack scaffolding              |
 
 ---
 
-## 📜 Scripts (2)
+## 📜 Scripts (Runtime - JavaScript)
 
-Master validation scripts that orchestrate skill-level scripts.
+**Location:** `.agent/scripts-js/`
 
-### Master Scripts
+Master validation scripts orchestrating skill-level validators (Python).
 
-| Script | Purpose | When to Use |
-| ------ | ------- | ----------- |
-| `checklist.py` | Priority-based validation (Core checks) | Development, pre-commit |
-| `verify_all.py` | Comprehensive verification (All checks) | Pre-deployment, releases |
+### Architecture (2-Tier Hybrid)
+
+```mermaid
+graph LR
+    User[User] --> Master[Master Scripts<br/>JavaScript]
+    Master --> Skills[Skill Scripts<br/>Python]
+    Master --> Output[Validation Report]
+    Skills --> Output
+```
+
+**Why Hybrid:**
+
+- Master scripts: JavaScript (cross-platform, npm integration)
+- Skill scripts: Python (34 scripts for specialized validation)
+- See [PYTHON_STRATEGY.md](../PYTHON_STRATEGY.md)
+
+### Master Scripts (10)
+
+| Script                    | Purpose                                 | When to Use              |
+| ------------------------- | --------------------------------------- | ------------------------ |
+| `checklist.js`            | Priority-based validation (Core checks) | Development, pre-commit  |
+| `verify_all.js`           | Comprehensive verification (All checks) | Pre-deployment, releases |
+| `auto_preview.js`         | Dev server management                   | Local development        |
+| `session_manager.js`      | Multi-session coordination              | Complex workflows        |
+| `autopilot-runner.js`     | Full autopilot integration              | /autopilot execution     |
+| `autopilot-metrics.js`    | Metrics collection (11 metrics)         | Performance tracking     |
+| `preflight-assessment.js` | Risk evaluation before execution        | Pre-flight checks        |
+| `adaptive-workflow.js`    | Workflow optimization engine            | Step skipping/parallel   |
+| `metrics-dashboard.js`    | Metrics visualization & SLO status      | Reporting                |
+| `skill-validator.js`      | Skill standard compliance checker       | Skill audits             |
 
 ### Usage
 
 ```bash
-# Quick validation during development
-python .agent/scripts/checklist.py .
+# Quick validation
+npm run checklist
+# OR: node .agent/scripts-js/checklist.js .
 
-# Full verification before deployment
-python .agent/scripts/verify_all.py . --url http://localhost:3000
+# Full verification before deploy
+npm run verify http://localhost:3000
+# OR: node .agent/scripts-js/verify_all.js . --url http://localhost:3000
 ```
 
 ### What They Check
 
-**checklist.py** (Core checks):
+**checklist.js** (Core checks):
 
 - Security (vulnerabilities, secrets)
 - Code Quality (lint, types)
@@ -253,40 +405,145 @@ python .agent/scripts/verify_all.py . --url http://localhost:3000
 - UX Audit
 - SEO Check
 
-**verify_all.py** (Full suite):
+**verify_all.js** (Full suite):
 
-- Everything in checklist.py PLUS:
+- Everything in checklist.js PLUS:
 - Lighthouse (Core Web Vitals)
 - Playwright E2E
 - Bundle Analysis
 - Mobile Audit
 - i18n Check
 
-For details, see [scripts/README.md](scripts/README.md)
+### Migration History
+
+**v3.2.0 (January 2026):**
+
+- ✅ Python → JavaScript master scripts
+- ✅ 4 new JS scripts (checklist, verify_all, auto_preview, session_manager)
+- ✅ Legacy Python archived to `scripts-legacy/`
+- ✅ Python skill scripts retained (34 specialized validators)
+
+See [MIGRATION.md](../MIGRATION.md) for details.
 
 ---
 
 ## 📊 Statistics
 
-| Metric | Value |
-| ------ | ----- |
-| **Total Agents** | 20 |
-| **Total Skills** | 48 |
-| **Total Workflows** | 14 |
-| **Total Scripts** | 4 (master) + 18 (skill-level) |
-| **Coverage** | ~95% web/mobile development |
+| Metric              | Value                         |
+| ------------------- | ----------------------------- |
+| **Total Agents**    | 20                            |
+| **Total Skills**    | 45                            |
+| **Total Workflows** | 24                            |
+| **Total Scripts**   | 4 (master) + 34 (skill-level) |
+| **Coverage**        | ~95% 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 |
+| 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           |
+
+---
+
+## 📅 Architecture Evolution
+
+### v3.3.0 (January 2026)
+
+**Major Changes:**
+
+- **Rebrand Script v4.0:** Production-grade rebrand tool with 5x performance boost
+  - Parallel batch processing (50 files/batch)
+  - Stream processing for large files (>1MB)
+  - Git-based backup/rollback mechanism
+  - Auto-discover package.json files
+  - Word boundary matching for precision
+- **Execution Policy v1.1:** Enhanced with PowerShell deny patterns
+  - Added `codebaseVersion` tracking
+  - 5 new Windows-specific safety rules
+  - Critical commands blocked (Remove-Item -Recurse, etc.)
+- **CLI Package Updates:** v3.3.0 alignment
+  - Updated branding across all CLI files
+  - Enhanced demo data quality
+  - Vitest 4.x upgrade
+
+**Files Added:**
+
+- `scripts/rebrand/v4.mjs` - Enhanced rebrand tool (700+ LOC)
+- `scripts/rebrand/README.md` - Comprehensive usage guide
+- `.agent/config/execution-policy.json` - v1.1 with codebaseVersion
+
+**Documentation:**
+
+- [rebrand/README.md](../scripts/rebrand/README.md) - Rebrand tool guide
+- [CHANGELOG.md](../CHANGELOG.md#330) - v3.3.0 release notes
+
+**Workflow Chains v2.0 (FAANG Upgrade):**
+
+All 5 workflow chains upgraded to schema v2.0 with enterprise-grade features:
+
+- **Error Handling**: Retry policies (0-2 retries), fail-fast strategies, fallback chains
+- **Dependency Management**: DAG execution, parallel processing (1-3 concurrent), explicit skill dependencies
+- **Success Criteria**: Required and optional metrics with automated verification scripts
+- **Versioning**: Semantic versioning (v1.0.0), schema versioning (v2.0), changelog tracking
+
+Chains upgraded:
+
+- `build-web-app`: 7 skills, DAG execution, 3 parallel max
+- `security-audit`: 4 skills, DAG execution, 2 parallel max
+- `debug-complex`: 4 skills, sequential execution
+- `deploy-production`: 5 skills, DAG execution, zero retries (production safety)
+- `api-development`: 5 skills, sequential execution
+
+FAANG Compliance: 64% → 90%+ (P0 features complete)
+
+**Files Modified:**
+
+- `.agent/skills/registry.json` - All 5 chains upgraded (+480 lines)
+- `.agent/WORKFLOW_CHAINS.md` - Schema v2.0 documentation
+- `.agent/workflows/api.md` - New /api workflow
+
+### v3.2.0 (January 2026)
+
+**Major Changes:**
+
+- **Python → JavaScript Migration:** Master scripts rewritten in JS
+- **Hybrid Architecture:** 2-tier system (JS master + Python skills)
+- **Studio Rename:** `.agent/.shared/studio` → `.agent/skills/studio`
+
+**Rationale:**
+
+- Cross-platform compatibility (Windows, macOS, Linux)
+- npm ecosystem integration
+- Faster execution (Node.js async I/O)
+- Maintain Python for specialized validators
+
+**Files Affected:**
+
+- Added: 4 JavaScript master scripts (~1,000 LOC)
+- Added: 14 JavaScript Studio scripts (~1,400 LOC)
+- Archived: 4 Python master scripts to `scripts-legacy/`
+- Retained: 34 Python skill scripts
+
+**Documentation:**
+
+- [MIGRATION.md](../MIGRATION.md) - Migration guide
+- [PYTHON_STRATEGY.md](../PYTHON_STRATEGY.md) - Hybrid rationale
+- [STUDIO_MIGRATION.md](../STUDIO_MIGRATION.md) - Studio migration
+- [CHANGELOG.md](../CHANGELOG.md) - Release notes
+
+### v3.1.0 (December 2025)
+
+**Changes:**
+
+- Added SelfEvolution v4.0 (auto-learning system)
+- Enhanced agent routing (SmartRouter skill)
+- 49 skills total