omgkit 2.19.3 → 2.20.0

package/README.md

@@ -1,4 +1,4 @@
-# 🔮 OMGKIT - Omega-Level Development Kit
+# OMGKIT - Omega-Level Development Kit
 
 [![CI](https://github.com/doanchienthangdev/omgkit/actions/workflows/ci.yml/badge.svg)](https://github.com/doanchienthangdev/omgkit/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/omgkit.svg)](https://www.npmjs.com/package/omgkit)
@@ -7,26 +7,97 @@
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 > **AI Team System for Claude Code**
-> 33 Agents • 113 Commands • 49 Workflows • 128 Skills • 10 Modes • 14 Archetypes
+>
 > *"Think Omega. Build Omega. Be Omega."*
 
-OMGKIT transforms Claude Code into an autonomous AI development team with sprint management, specialized agents, and Omega-level thinking for 10x-1000x productivity improvements.
+---
+
+## What is OMGKIT?
+
+**OMGKIT** (Omega-Level Development Kit) transforms Claude Code into an autonomous AI development team. It provides a complete ecosystem of specialized AI agents, slash commands, skills, and workflows that work together to deliver 10x-1000x productivity improvements.
+
+### The Vision
+
+Traditional AI assistants respond to prompts. OMGKIT creates an **AI Team** that:
+
+- **Plans** like a senior architect
+- **Researches** like a staff engineer
+- **Codes** like a full-stack developer
+- **Reviews** like a security expert
+- **Tests** like a QA specialist
+- **Documents** like a technical writer
+- **Ships** like a DevOps engineer
+
+All coordinated through **Omega-level thinking** - a framework for finding breakthrough solutions rather than incremental improvements.
+
+---
 
-## ✨ Features
+## Key Numbers
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| **Agents** | 33 | Specialized AI team members |
-| **Commands** | 113 | Slash commands for every task |
-| **Workflows** | 49 | Complete development processes |
-| **Skills** | 128 | Domain expertise modules |
-| **Modes** | 10 | Behavioral configurations |
-| **Archetypes** | 14 | Project templates for autonomous dev |
-| **Sprint Management** | ✅ | Vision, backlog, team autonomy |
-| **Omega Thinking** | ✅ | 7 modes for 10x-1000x solutions |
-| **Autonomous Dev** | ✅ | Build complete apps from idea to deploy |
-
-## 🚀 Installation
+| **Agents** | 33 | Specialized AI team members with distinct roles |
+| **Commands** | 113 | Slash commands for every development task |
+| **Workflows** | 49 | Complete development processes from idea to deploy |
+| **Skills** | 128 | Domain expertise modules across 22 categories |
+| **Modes** | 10 | Behavioral configurations for different contexts |
+| **Archetypes** | 14 | Project templates for autonomous development |
+
+---
+
+## Core Concepts
+
+### 1. Optimized Alignment Principle (OAP)
+
+OMGKIT uses a **5-level component hierarchy** ensuring consistency and maintainability:
+
+```
+Level 0: MCPs (Foundation)
+    ↓
+Level 1: Commands → use MCPs
+    ↓
+Level 2: Skills → use Commands, MCPs
+    ↓
+Level 3: Agents → use Skills, Commands, MCPs
+    ↓
+Level 4: Workflows → use Agents, Skills, Commands, MCPs
+```
+
+Each level builds on lower levels, creating a coherent system where components work together seamlessly.
+
+### 2. Omega Philosophy
+
+Seven principles guide OMGKIT's approach to problem-solving:
+
+| Principle | Focus |
+|-----------|-------|
+| **Leverage Multiplication** | Build systems, not features |
+| **Transcendent Abstraction** | Solve classes of problems, not instances |
+| **Agentic Decomposition** | Orchestrate specialists |
+| **Feedback Acceleration** | Compress learning loops |
+| **Zero-Marginal-Cost Scaling** | Build once, scale infinitely |
+| **Emergent Intelligence** | System greater than sum of parts |
+| **Aesthetic Perfection** | Excellence in everything |
+
+### 3. Sprint Management
+
+OMGKIT brings agile methodology to AI-assisted development:
+
+- **Vision**: Define what you're building and why
+- **Backlog**: Prioritized list of work items
+- **Sprints**: Time-boxed development cycles
+- **AI Team**: Autonomous execution with human oversight
+
+---
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18+
+- Claude Code CLI installed and authenticated
+
+### Install OMGKIT
 
 ```bash
 # Install globally
@@ -40,423 +111,384 @@ cd your-project
 omgkit init
 ```
 
-## 📋 Quick Start
+### Verify Installation
+
+```bash
+omgkit doctor
+```
+
+---
+
+## Quick Start
 
 After installation, use these commands in Claude Code:
 
 ```bash
-# Set your vision
+# 1. Set your product vision
 /vision:set
 
-# Create a sprint (AI proposes tasks)
+# 2. Create a sprint with AI-proposed tasks
 /sprint:new --propose
 
-# Start the AI team
+# 3. Start the AI team
 /team:run
 
-# Or use individual commands
+# 4. Or use individual commands
 /feature "add user authentication"
 /fix "login not working"
 /10x "improve performance"
 ```
 
-## 🤖 Agents (33)
+---
+
+## Agents (33)
+
+Agents are specialized AI team members, each with distinct expertise and responsibilities.
 
 ### Core Development
-| Agent | Description |
-|-------|-------------|
-| `planner` | Task decomposition, implementation planning |
-| `researcher` | Technology research, best practices |
-| `debugger` | Error analysis, root cause finding |
-| `tester` | Test generation, coverage analysis |
-| `code-reviewer` | Code review with security focus |
-| `scout` | Codebase exploration, file search |
+
+| Agent | Description | Key Skills |
+|-------|-------------|------------|
+| `planner` | Task decomposition, implementation planning | Writing plans, task breakdown |
+| `researcher` | Technology research, best practices | Documentation analysis, comparisons |
+| `debugger` | Error analysis, root cause finding | RAPID methodology, log analysis |
+| `tester` | Test generation, coverage analysis | Framework-specific testing |
+| `code-reviewer` | Code review with security focus | OWASP checks, severity rating |
+| `scout` | Codebase exploration, file search | Pattern discovery, architecture mapping |
+| `fullstack-developer` | Full implementation | All development skills |
 
 ### Operations
+
 | Agent | Description |
 |-------|-------------|
-| `git-manager` | Git operations, PRs, commits |
-| `docs-manager` | Documentation generation |
-| `project-manager` | Progress tracking, coordination |
-| `database-admin` | Schema design, query optimization |
-| `ui-ux-designer` | UI components, responsive design |
-| `observability-engineer` | Monitoring, logging, tracing, alerting |
-
-### Extended
-| Agent | Description |
-|-------|-------------|
-| `fullstack-developer` | Full implementation |
-| `cicd-manager` | CI/CD pipeline management |
-| `security-auditor` | Security reviews, audits |
-| `api-designer` | API design, OpenAPI specs |
-| `vulnerability-scanner` | Security scanning |
-| `pipeline-architect` | Pipeline optimization |
-| `devsecops` | Security automation, SAST/DAST |
-
-### Creative
-| Agent | Description |
-|-------|-------------|
-| `copywriter` | Marketing copy, content |
-| `brainstormer` | Creative exploration |
-| `journal-writer` | Failure documentation |
+| `git-manager` | Conventional commits, PR automation, branch management |
+| `docs-manager` | API docs, architecture guides, automated doc generation |
+| `project-manager` | Progress tracking, coordination, status reports |
+| `database-admin` | Schema design, query optimization, migrations |
+| `ui-ux-designer` | UI components, responsive design, accessibility |
+| `observability-engineer` | Monitoring, logging, tracing, alerting, SLOs |
 
 ### Architecture & Platform
+
 | Agent | Description |
 |-------|-------------|
+| `architect` | System design, leverage multiplication, ADRs |
 | `domain-decomposer` | DDD, bounded contexts, service boundaries |
 | `platform-engineer` | Internal developer platforms, golden paths |
 | `performance-engineer` | Profiling, load testing, optimization |
 
+### Security
+
+| Agent | Description |
+|-------|-------------|
+| `security-auditor` | Security reviews, vulnerability assessment |
+| `vulnerability-scanner` | Security scanning, dependency audit |
+| `devsecops` | Security automation, SAST/DAST integration |
+
 ### Data & ML
+
 | Agent | Description |
 |-------|-------------|
 | `data-engineer` | Data pipelines, ETL, schema design |
 | `ml-engineer` | ML pipelines, model training, MLOps |
 
-### Specialized
+### Specialized Domains
+
 | Agent | Description |
 |-------|-------------|
 | `game-systems-designer` | Game mechanics, balancing, multiplayer |
 | `embedded-systems` | Firmware, RTOS, IoT connectivity |
 | `scientific-computing` | Numerical methods, simulations |
 
-### Omega Exclusive ⭐
+### Omega Exclusive
+
 | Agent | Description |
 |-------|-------------|
-| `oracle` | Deep analysis with 7 thinking modes |
-| `architect` | System design, leverage multiplication |
+| `oracle` | Deep analysis with 7 Omega thinking modes |
 | `sprint-master` | Sprint management, team orchestration |
 
-## ⚡ Commands (113)
+---
 
-### Development
-```bash
-/feature <desc>     # Full feature development
-/fix <error>        # Debug and fix bugs
-/fix:fast <error>   # Quick bug fix
-/fix:hard <error>   # Complex bug (deep analysis)
-/test <scope>       # Generate tests
-/tdd <feature>      # Test-driven development
-/review [file]      # Code review
-```
+## Commands (113)
 
-### Planning
-```bash
-/plan <task>        # Create implementation plan
-/plan:detailed      # Detailed plan (2-5 min tasks)
-/brainstorm <topic> # Interactive brainstorming
-/research <topic>   # Research technology
-/doc <target>       # Generate documentation
-```
+Commands are slash-prefixed actions organized by namespace.
 
-### Git & Deploy
-```bash
-/commit [message]   # Smart commit
-/ship [message]     # Commit + PR
-/pr [title]         # Create pull request
-/deploy [env]       # Deploy to environment
-```
+### Development (`/dev:*`)
 
-### Quality
 ```bash
-/security-scan      # Scan for vulnerabilities
-/refactor <file>    # Improve code structure
-/optimize <file>    # Performance optimization
-/lint               # Run linting
+/dev:feature <desc>     # Full feature development
+/dev:fix <error>        # Debug and fix bugs
+/dev:fix-fast <error>   # Quick bug fix
+/dev:fix-hard <error>   # Complex bug (deep analysis)
+/dev:test <scope>       # Generate tests
+/dev:tdd <feature>      # Test-driven development
+/dev:review [file]      # Code review
 ```
 
-### Omega ⭐
+### Planning (`/planning:*`)
+
 ```bash
-/10x <topic>        # Find 10x improvement path
-/100x <topic>       # Find 100x paradigm shift
-/1000x <topic>      # Find 1000x moonshot
-/principles         # Display 7 Omega Principles
-/dimensions         # Display 10 Omega Dimensions
+/planning:plan <task>        # Create implementation plan
+/planning:plan-detailed      # Detailed plan (2-5 min tasks)
+/planning:brainstorm <topic> # Interactive brainstorming
+/planning:research <topic>   # Research technology
+/planning:doc <target>       # Generate documentation
 ```
 
-### Sprint Management ⭐
+### Git (`/git:*`)
+
 ```bash
-/vision:set         # Set product vision
-/vision:show        # Display current vision
-/sprint:new [name]  # Create new sprint
-/sprint:start       # Start current sprint
-/sprint:current     # Show sprint progress
-/sprint:end         # End sprint + retrospective
-/backlog:add <task> # Add task to backlog
-/backlog:show       # Display backlog
-/team:run [--mode]  # Run AI team (full-auto|semi-auto|manual)
-/team:status        # Show team activity
+/git:commit [message]   # Smart commit with conventional format
+/git:ship [message]     # Commit + PR in one command
+/git:pr [title]         # Create pull request
+/git:deploy [env]       # Deploy to environment
 ```
 
-### Autonomous Development
+### Quality (`/quality:*`)
+
 ```bash
-/auto:init <idea>   # Start discovery for new project
-/auto:start         # Begin/continue autonomous execution
-/auto:status        # Check project progress
-/auto:approve       # Approve checkpoint to continue
-/auto:reject        # Request changes with feedback
-/auto:resume        # Resume from saved state
+/quality:security-scan  # Scan for vulnerabilities
+/quality:refactor <file> # Improve code structure
+/quality:optimize <file> # Performance optimization
+/quality:lint           # Run linting
 ```
 
-### Alignment & Dependencies ⭐
+### Omega (`/omega:*`)
+
 ```bash
-/alignment:health   # Check system alignment health status
-/alignment:deps <type:name>  # Show dependency graph tree
+/omega:10x <topic>      # Find 10x improvement path
+/omega:100x <topic>     # Find 100x paradigm shift
+/omega:1000x <topic>    # Find 1000x moonshot opportunity
+/omega:principles       # Display 7 Omega Principles
+/omega:dimensions       # Display 10 Omega Dimensions
 ```
 
-The alignment commands help you understand and validate OMGKIT's component hierarchy:
-- `agent:fullstack-developer` - Shows agent's skills, commands, and workflows
-- `workflow:development/feature` - Shows workflow's agents, skills, commands
-- `skill:methodology/writing-plans` - Shows which agents/workflows use this skill
-- `command:/dev:feature` - Shows which agents trigger this command
-
-## 🤖 Autonomous Development (14 Archetypes)
+### Sprint Management (`/sprint:*`)
 
-Build complete applications autonomously from idea to deployment.
+```bash
+/sprint:vision-set      # Set product vision
+/sprint:vision-show     # Display current vision
+/sprint:sprint-new      # Create new sprint
+/sprint:sprint-start    # Start current sprint
+/sprint:sprint-current  # Show sprint progress
+/sprint:sprint-end      # End sprint + retrospective
+/sprint:backlog-add     # Add task to backlog
+/sprint:backlog-show    # Display backlog
+/sprint:team-run        # Run AI team
+/sprint:team-status     # Show team activity
+```
 
-| Archetype | Description |
-|-----------|-------------|
-| **SaaS MVP** | Multi-tenant SaaS with auth, payments |
-| **API Service** | Backend APIs for web/mobile apps |
-| **CLI Tool** | Command-line utilities |
-| **Library/SDK** | Reusable npm packages |
-| **Full-Stack App** | Complete web applications |
-| **Mobile App** | iOS/Android with React Native |
-| **AI-Powered App** | LLM apps with RAG, function calling |
-| **AI Model Building** | ML model training pipelines |
-| **Desktop App** | Electron cross-platform apps |
-| **IoT App** | Device management, real-time data |
-| **Game** | Unity/Godot game development |
-| **Simulation** | Scientific/engineering simulations |
-| **Microservices** | Distributed services with K8s, API gateway |
-| **Event-Driven** | Async systems with Kafka, CQRS, sagas |
+### Autonomous Development (`/auto:*`)
 
-### Artifacts System
+```bash
+/auto:init <idea>       # Start discovery for new project
+/auto:start             # Begin/continue autonomous execution
+/auto:status            # Check project progress
+/auto:approve           # Approve checkpoint to continue
+/auto:reject            # Request changes with feedback
+/auto:resume            # Resume from saved state
+```
 
-Provide project context through artifacts:
+### Alignment (`/alignment:*`)
 
-```
-.omgkit/artifacts/
-├── data/       # Sample data, schemas
-├── docs/       # Requirements, user stories
-├── knowledge/  # Glossary, business rules
-├── research/   # Competitor analysis
-├── assets/     # Images, templates
-└── examples/   # Code samples
+```bash
+/alignment:health       # Check system alignment health
+/alignment:deps <type:name>  # Show dependency graph
 ```
 
-## 📋 Workflows (49)
+---
+
+## Workflows (49)
 
-Workflows are orchestrated sequences of agents, commands, and skills that guide complete development processes.
+Workflows are orchestrated sequences of agents, commands, and skills.
 
 ### Development
+
 | Workflow | Description |
 |----------|-------------|
-| `feature` | Complete feature development from planning to PR |
-| `bug-fix` | Systematic debugging and resolution |
-| `refactor` | Code improvement and restructuring |
-| `code-review` | Comprehensive code review |
+| `development/feature` | Complete feature from planning to PR |
+| `development/bug-fix` | Systematic debugging and resolution |
+| `development/refactor` | Code improvement and restructuring |
+| `development/code-review` | Comprehensive code review |
 
 ### AI Engineering
-| Workflow | Description |
-|----------|-------------|
-| `rag-development` | Build complete RAG systems |
-| `model-evaluation` | AI model evaluation pipeline |
-| `prompt-engineering` | Systematic prompt optimization |
-| `agent-development` | Build AI agents |
-| `fine-tuning` | Model fine-tuning workflow |
 
-### AI-ML Operations
 | Workflow | Description |
 |----------|-------------|
-| `data-pipeline` | Build ML data pipelines |
-| `experiment-cycle` | ML experiment tracking |
-| `model-deployment` | Model serving and deployment |
-| `monitoring-setup` | ML model monitoring |
-| `feature-engineering` | Feature store development |
+| `ai-engineering/rag-development` | Build complete RAG systems |
+| `ai-engineering/model-evaluation` | AI model evaluation pipeline |
+| `ai-engineering/prompt-engineering` | Systematic prompt optimization |
+| `ai-engineering/agent-development` | Build AI agents |
+| `ai-engineering/fine-tuning` | Model fine-tuning workflow |
 
-### Omega ⭐
-| Workflow | Description |
-|----------|-------------|
-| `10x-improvement` | Tactical enhancements |
-| `100x-architecture` | System redesign |
-| `1000x-innovation` | Industry transformation |
+### AI-ML Operations
 
-### Sprint Management
 | Workflow | Description |
 |----------|-------------|
-| `sprint-setup` | Initialize and plan sprints |
-| `sprint-execution` | Execute sprint tasks |
-| `sprint-retrospective` | Review and improve |
+| `ai-ml/data-pipeline` | Build ML data pipelines |
+| `ai-ml/experiment-cycle` | ML experiment tracking |
+| `ai-ml/model-deployment` | Model serving and deployment |
+| `ai-ml/monitoring-setup` | ML model monitoring |
 
 ### Microservices
+
 | Workflow | Description |
 |----------|-------------|
-| `domain-decomposition` | DDD bounded context analysis |
-| `service-scaffolding` | Service template generation |
-| `contract-first` | API contract development |
-| `integration-testing` | Service integration tests |
-| `service-mesh-setup` | Istio/Linkerd configuration |
-| `distributed-tracing` | Tracing implementation |
+| `microservices/domain-decomposition` | DDD bounded context analysis |
+| `microservices/service-scaffolding` | Service template generation |
+| `microservices/contract-first` | API contract development |
+| `microservices/distributed-tracing` | Tracing implementation |
 
 ### Event-Driven
+
 | Workflow | Description |
 |----------|-------------|
-| `event-storming` | Domain event modeling |
-| `schema-evolution` | Event schema management |
-| `saga-implementation` | Distributed transaction patterns |
-| `replay-testing` | Event replay testing |
-| `consumer-groups` | Consumer group setup |
+| `event-driven/event-storming` | Domain event modeling |
+| `event-driven/saga-implementation` | Distributed transaction patterns |
+| `event-driven/schema-evolution` | Event schema management |
 
 ### Game Development
+
 | Workflow | Description |
 |----------|-------------|
-| `prototype-to-production` | Game development lifecycle |
-| `content-pipeline` | Asset management |
-| `playtesting` | Testing and balancing |
-| `platform-submission` | Store submission |
-
-### Other Categories
-- **Security**: `security-audit`, `penetration-testing`
-- **Database**: `schema-design`, `migration`, `optimization`
-- **API**: `api-design`, `api-testing`
-- **Full Stack**: `full-feature`, `authentication`
-- **Content**: `technical-docs`, `marketing`
-- **Research**: `technology-research`, `best-practices`
-- **Quality**: `performance-optimization`
-
-Use workflows with: `/workflow:<name> "description"`
+| `game/prototype-to-production` | Game development lifecycle |
+| `game/content-pipeline` | Asset management |
+| `game/playtesting` | Testing and balancing |
 
-## 🎭 Modes (10)
+### Omega
 
-| Mode | Description |
-|------|-------------|
-| `default` | Balanced standard behavior |
-| `tutor` ⭐ | Teaching mode with Feynman technique & Socratic questions |
-| `brainstorm` | Creative exploration |
-| `token-efficient` | Compressed output (30-70% savings) |
-| `deep-research` | Thorough analysis with citations |
-| `implementation` | Code-focused, minimal prose |
-| `review` | Critical analysis mode |
-| `orchestration` | Multi-task coordination |
-| `omega` ⭐ | 10x-1000x thinking mode |
-| `autonomous` ⭐ | AI team self-management |
+| Workflow | Description |
+|----------|-------------|
+| `omega/10x-improvement` | Tactical enhancements |
+| `omega/100x-architecture` | System redesign |
+| `omega/1000x-innovation` | Industry transformation |
 
-Switch modes with: `/mode <name>`
+---
 
-## 🔮 Omega Philosophy
+## Skills (128)
 
-### 7 Omega Principles
+Skills are domain expertise modules organized in 22 categories.
 
-1. **Ω1 Leverage Multiplication** - Build systems, not features
-2. **Ω2 Transcendent Abstraction** - Solve classes, not instances
-3. **Ω3 Agentic Decomposition** - Orchestrate specialists
-4. **Ω4 Feedback Acceleration** - Compress loops
-5. **Ω5 Zero-Marginal-Cost Scaling** - Build once, scale infinitely
-6. **Ω6 Emergent Intelligence** - System > sum of parts
-7. **Ω7 Aesthetic Perfection** - Excellence always
+### AI Engineering (12 skills)
 
-### 7 Thinking Modes
+Based on production AI application patterns:
 
-| Mode | Focus |
-|------|-------|
-| 🔭 Telescopic | Zoom out to see big picture |
-| 🔬 Microscopic | First principles analysis |
-| ↔️ Lateral | Different angles and industries |
-| 🔄 Inversion | Learn through failure |
-| ⏳ Temporal | Time dimension analysis |
-| 🕸️ Systemic | Interconnections and emergence |
-| ⚛️ Quantum | Multiple possibilities |
+| Skill | Description |
+|-------|-------------|
+| `ai-engineering/foundation-models` | Model architecture, sampling, structured outputs |
+| `ai-engineering/evaluation-methodology` | AI-as-judge, semantic similarity, ELO ranking |
+| `ai-engineering/prompt-engineering` | Few-shot, chain-of-thought, injection defense |
+| `ai-engineering/rag-systems` | Chunking, embedding, hybrid retrieval, reranking |
+| `ai-engineering/ai-agents` | Tool use, ReAct, Plan-and-Execute, memory |
+| `ai-engineering/finetuning` | LoRA, QLoRA, PEFT, model merging |
+| `ai-engineering/inference-optimization` | Quantization, batching, caching, vLLM |
+| `ai-engineering/guardrails-safety` | Input/output guards, PII protection |
 
-## 🧠 Skills (128)
+### Methodology (17 skills)
 
-OMGKIT includes 128 skills across 22 categories:
+| Skill | Description |
+|-------|-------------|
+| `methodology/writing-plans` | Implementation plan creation |
+| `methodology/executing-plans` | Plan execution best practices |
+| `methodology/debugging` | Systematic debugging approach |
+| `methodology/code-review` | Review standards and checklists |
+| `methodology/tdd` | Test-driven development |
 
-### AI Engineering (12 skills)
-Based on Chip Huyen's "AI Engineering" book for building production AI applications:
+### Frameworks (10 skills)
 
 | Skill | Description |
 |-------|-------------|
-| `foundation-models` | Model architecture, sampling, structured outputs |
-| `evaluation-methodology` | AI-as-judge, semantic similarity, ELO ranking |
-| `ai-system-evaluation` | Benchmarks, model selection, cost analysis |
-| `prompt-engineering` | Few-shot, chain-of-thought, injection defense |
-| `rag-systems` | Chunking, embedding, hybrid retrieval, reranking |
-| `ai-agents` | Tool use, ReAct, Plan-and-Execute, memory |
-| `finetuning` | LoRA, QLoRA, PEFT, model merging |
-| `dataset-engineering` | Curation, deduplication, synthesis |
-| `inference-optimization` | Quantization, batching, caching, vLLM |
-| `ai-architecture` | Gateway, routing, observability |
-| `guardrails-safety` | Input/output guards, PII protection |
-| `user-feedback` | Explicit/implicit signals, A/B testing |
-
-### Other Skill Categories
-
-| Category | Count | Description |
-|----------|-------|-------------|
+| `frameworks/react` | React hooks, TypeScript, state management |
+| `frameworks/nextjs` | App Router, Server Components, API routes |
+| `frameworks/django` | DRF, ORM optimization, Celery tasks |
+| `frameworks/fastapi` | Async/await, Pydantic v2, dependency injection |
+| `frameworks/nestjs` | TypeScript, dependency injection, microservices |
+
+### Other Categories
+
+| Category | Skills | Focus |
+|----------|--------|-------|
 | AI-ML Operations | 6 | MLOps, feature stores, model serving |
-| Microservices | 6 | Service mesh, API gateway, distributed tracing |
-| Event-Driven | 6 | Kafka, event sourcing, CQRS, sagas |
-| Game Development | 5 | Unity, Godot, networking, shaders |
-| IoT | 5 | MQTT, edge computing, device management |
-| Mobile Advanced | 5 | React Native deep, CI/CD, offline-first |
-| Simulation | 5 | Numerical methods, physics, parallel computing |
-| Languages | 3 | Python, TypeScript, JavaScript |
-| Frameworks | 10 | React, Next.js, Django, FastAPI, etc. |
-| Backend | 4 | API architecture, caching, real-time |
-| Databases | 9 | PostgreSQL, MongoDB, Redis, migrations |
-| Frontend | 7 | Tailwind, shadcn/ui, Three.js, accessibility |
-| DevOps | 7 | Docker, Kubernetes, GitHub Actions, AWS |
-| Security | 4 | OWASP, OAuth, security hardening |
-| Testing | 3 | Pytest, Vitest, Playwright |
-| Methodology | 17 | TDD, code review, debugging practices |
-| Omega | 5 | Omega-level development practices |
-
-## 🛠️ CLI Commands
+| Microservices | 6 | Service mesh, API gateway, tracing |
+| Event-Driven | 6 | Kafka, event sourcing, CQRS |
+| Game Development | 5 | Unity, Godot, networking |
+| Databases | 9 | PostgreSQL, MongoDB, Redis |
+| Frontend | 7 | Tailwind, shadcn/ui, accessibility |
+| DevOps | 7 | Docker, Kubernetes, GitHub Actions |
+| Security | 4 | OWASP, OAuth, hardening |
+
+---
+
+## Modes (10)
+
+Modes configure Claude's behavior for different contexts.
 
+| Mode | Description |
+|------|-------------|
+| `default` | Balanced standard behavior |
+| `tutor` | Teaching mode with Feynman technique & Socratic questions |
+| `brainstorm` | Creative exploration, divergent thinking |
+| `token-efficient` | Compressed output (30-70% savings) |
+| `deep-research` | Thorough analysis with citations |
+| `implementation` | Code-focused, minimal prose |
+| `review` | Critical analysis mode |
+| `orchestration` | Multi-task coordination |
+| `omega` | 10x-1000x thinking mode |
+| `autonomous` | AI team self-management |
+
+Switch modes:
 ```bash
-omgkit install      # Install plugin to Claude Code
-omgkit init         # Initialize .omgkit/ in project
-omgkit doctor       # Check installation status
-omgkit list         # List all components
-omgkit update       # Update plugin
-omgkit uninstall    # Remove plugin
-omgkit help         # Show help
+/context:mode <name>
 ```
 
-## ✅ Before-Commit Validation
+---
 
-OMGKIT provides two types of before-commit rules:
+## Autonomous Development (14 Archetypes)
 
-| Rule Type | Location | Purpose |
-|-----------|----------|---------|
-| **OMGKIT Internal** | `plugin/stdrules/` | For OMGKIT contributors |
-| **Project Rules** | `.omgkit/stdrules/BEFORE_COMMIT.md` | For your projects |
+Build complete applications from idea to deployment.
 
-### For OMGKIT Contributors
+| Archetype | Description |
+|-----------|-------------|
+| **SaaS MVP** | Multi-tenant SaaS with auth, payments |
+| **API Service** | Backend APIs for web/mobile apps |
+| **CLI Tool** | Command-line utilities |
+| **Library/SDK** | Reusable npm packages |
+| **Full-Stack App** | Complete web applications |
+| **Mobile App** | iOS/Android with React Native |
+| **AI-Powered App** | LLM apps with RAG, function calling |
+| **AI Model Building** | ML model training pipelines |
+| **Desktop App** | Electron cross-platform apps |
+| **IoT App** | Device management, real-time data |
+| **Game** | Unity/Godot game development |
+| **Simulation** | Scientific/engineering simulations |
+| **Microservices** | Distributed services with K8s |
+| **Event-Driven** | Async systems with Kafka, CQRS |
 
-```bash
-npm test    # Run all 4800+ validation tests
-```
+### How It Works
 
-| Category | Requirement |
-|----------|-------------|
-| **Agents** | 50+ lines, valid frontmatter, skills/commands arrays |
-| **Commands** | 15+ lines, description, registered as slash command |
-| **Skills** | 30+ lines, name/description if frontmatter present |
-| **Workflows** | 50+ lines, description, agents array |
+1. **Discovery**: AI asks questions to understand your vision
+2. **Planning**: Generates architecture, tasks, and timeline
+3. **Execution**: Autonomous development with checkpoints
+4. **Review**: Human approval at critical milestones
+5. **Iteration**: Feedback loop for refinements
 
-### For Project Developers
+### Artifacts System
 
-When you run `omgkit init`, a comprehensive `BEFORE_COMMIT.md` is created with:
-- Code quality checks
-- Git commit standards
-- Security guidelines
-- Documentation requirements
+Provide project context:
 
-See [full documentation](https://omgkit.mintlify.app/resources/before-commit).
+```
+.omgkit/artifacts/
+├── data/       # Sample data, schemas
+├── docs/       # Requirements, user stories
+├── knowledge/  # Glossary, business rules
+├── research/   # Competitor analysis
+├── assets/     # Images, templates
+└── examples/   # Code samples
+```
+
+---
 
-## 📁 Project Structure
+## Project Structure
 
 After `omgkit init`:
 
@@ -471,65 +503,117 @@ your-project/
 │   ├── plans/           # Generated plans
 │   ├── docs/            # Generated docs
 │   ├── logs/            # Activity logs
-│   ├── devlogs/         # Development logs, planning, tracking (git-ignored)
-│   └── stdrules/        # Standards & rules for the project
-│       ├── BEFORE_COMMIT.md   # Before-commit checklist
-│       └── SKILL_STANDARDS.md
-└── OMEGA.md             # Project context
+│   ├── devlogs/         # Development logs (git-ignored)
+│   ├── stdrules/        # Project standards
+│   │   ├── BEFORE_COMMIT.md
+│   │   └── SKILL_STANDARDS.md
+│   └── artifacts/       # Project context
+└── OMEGA.md             # Project context file
 ```
 
-## 🔌 MCP Integrations
+---
 
-OMGKIT supports these MCP servers for enhanced capabilities:
+## MCP Integrations
+
+OMGKIT supports these MCP servers:
 
 | Server | Purpose |
 |--------|---------|
-| Context7 | Up-to-date library documentation |
-| Sequential Thinking | Multi-step reasoning |
-| Memory | Persistent knowledge graph |
-| Filesystem | Secure file operations |
-| Playwright | Browser automation |
+| `context7` | Up-to-date library documentation |
+| `sequential-thinking` | Multi-step reasoning |
+| `memory` | Persistent knowledge graph |
+| `filesystem` | Secure file operations |
+| `playwright` | Browser automation |
 
-## 🏗️ Optimized Alignment Principle (OAP)
+---
 
-OMGKIT uses a **5-level component hierarchy** ensuring consistency and maintainability:
+## Standards & Rules
 
+OMGKIT provides two types of standards:
+
+### For OMGKIT Contributors
+
+Located in `plugin/stdrules/`:
+
+| File | Purpose |
+|------|---------|
+| `ALIGNMENT_PRINCIPLE.md` | Component hierarchy rules |
+| `OMGKIT_BEFORE_COMMIT_RULES.md` | Validation requirements |
+| `SKILL_STANDARDS.md` | Skill documentation standards |
+
+### For Project Developers
+
+Generated in `.omgkit/stdrules/` when you run `omgkit init`:
+
+| File | Purpose |
+|------|---------|
+| `BEFORE_COMMIT.md` | Pre-commit checklist |
+| `SKILL_STANDARDS.md` | Custom skill guidelines |
+
+---
+
+## CLI Commands
+
+```bash
+omgkit install      # Install plugin to Claude Code
+omgkit init         # Initialize .omgkit/ in project
+omgkit doctor       # Check installation status
+omgkit list         # List all components
+omgkit update       # Update plugin
+omgkit uninstall    # Remove plugin
+omgkit help         # Show help
 ```
-Level 0: MCPs (Foundation)
-    ↓
-Level 1: Commands → use MCPs
-    ↓
-Level 2: Skills → use Commands, MCPs
-    ↓
-Level 3: Agents → use Skills, Commands, MCPs
-    ↓
-Level 4: Workflows → use Agents, Skills, Commands, MCPs
+
+---
+
+## Validation & Testing
+
+OMGKIT has 4800+ automated tests ensuring system integrity.
+
+### Run Tests
+
+```bash
+npm test                           # All tests
+npm test -- tests/validation/      # Validation tests only
+npm test -- tests/unit/            # Unit tests only
 ```
 
-### Five Alignment Rules
+### Test Categories
 
-1. **Format Compliance** - Components use correct naming patterns
-2. **Existence Validation** - All references must exist
-3. **No Cross-Type Confusion** - Components not confused with other types
-4. **Hierarchical Respect** - Only reference same/lower level components
-5. **Optimization** - Minimal, appropriate, unique references
+| Category | Tests | Purpose |
+|----------|-------|---------|
+| Registry Sync | ~200 | Verify registry matches files |
+| Alignment | ~400 | Component hierarchy validation |
+| Documentation | ~500 | Quality and format checks |
+| Format | ~300 | Naming convention compliance |
+| Dependency Graph | ~600 | Reference integrity |
+
+---
 
-### Component Formats
+## Contributing
 
-| Component | Format | Example |
-|-----------|--------|---------|
-| MCPs | `kebab-case` | `context7` |
-| Commands | `/namespace:name` | `/dev:feature` |
-| Skills | `category/name` | `methodology/writing-plans` |
-| Agents | `kebab-case` | `fullstack-developer` |
-| Workflows | `category/name` | `development/feature` |
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-All alignment rules are enforced by 400+ automated tests. See [full documentation](https://omgkit.mintlify.app/concepts/alignment-principle).
+### Quick Start
+
+1. Fork and clone the repository
+2. Install dependencies: `npm install`
+3. Run tests: `npm test`
+4. Make changes following `plugin/stdrules/`
+5. Submit PR with conventional commit messages
+
+---
+
+## Documentation
+
+Full documentation available at: [omgkit.mintlify.app](https://omgkit.mintlify.app)
+
+---
 
-## 📄 License
+## License
 
-MIT
+MIT - See [LICENSE](LICENSE) for details.
 
 ---
 
-*Think Omega. Build Omega. Be Omega.* 🔮
+*Think Omega. Build Omega. Be Omega.*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "omgkit",
-  "version": "2.19.3",
-  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 33 agents, 111 commands, 127 skills, 49 workflows.",
+  "version": "2.20.0",
+  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 33 agents, 113 commands, 128 skills, 49 workflows.",
   "keywords": [
     "claude-code",
     "ai",

package/plugin/registry.yaml

@@ -1,9 +1,9 @@
 # OMGKIT Component Registry
 # Single Source of Truth for Agents, Skills, Commands, Workflows, and MCPs
-# Version: 2.19.2
+# Version: 2.20.0
 # Updated: 2026-01-02
 
-version: "2.19.2"
+version: "2.20.0"
 
 # =============================================================================
 # OPTIMIZED ALIGNMENT PRINCIPLE (OAP)