omgkit 2.16.0 → 2.18.0

package/README.md

@@ -7,7 +7,7 @@
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 > **AI Team System for Claude Code**
-> 33 Agents • 111 Commands • 49 Workflows • 127 Skills • 10 Modes • 14 Archetypes
+> 33 Agents • 113 Commands • 49 Workflows • 127 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.
@@ -17,7 +17,7 @@ OMGKIT transforms Claude Code into an autonomous AI development team with sprint
 | Component | Count | Description |
 |-----------|-------|-------------|
 | **Agents** | 33 | Specialized AI team members |
-| **Commands** | 111 | Slash commands for every task |
+| **Commands** | 113 | Slash commands for every task |
 | **Workflows** | 49 | Complete development processes |
 | **Skills** | 127 | Domain expertise modules |
 | **Modes** | 10 | Behavioral configurations |
@@ -127,7 +127,7 @@ After installation, use these commands in Claude Code:
 | `architect` | System design, leverage multiplication |
 | `sprint-master` | Sprint management, team orchestration |
 
-## ⚡ Commands (111)
+## ⚡ Commands (113)
 
 ### Development
 ```bash
@@ -198,6 +198,18 @@ After installation, use these commands in Claude Code:
 /auto:resume        # Resume from saved state
 ```
 
+### Alignment & Dependencies ⭐
+```bash
+/alignment:health   # Check system alignment health status
+/alignment:deps <type:name>  # Show dependency graph tree
+```
+
+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)
 
 Build complete applications autonomously from idea to deployment.
@@ -412,6 +424,28 @@ omgkit uninstall    # Remove plugin
 omgkit help         # Show help
 ```
 
+## ✅ Before-Commit Validation
+
+OMGKIT enforces strict quality standards with **4800+ automated tests**:
+
+```bash
+npm test    # Run all validation tests before commit
+```
+
+### Quality Gates
+
+| 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 |
+| **Registry** | Version sync, cross-reference validation |
+| **Content** | No placeholder text (TODO:, FIXME:, etc.) |
+
+All commands must be registered in `registry.yaml` under valid namespaces.
+See [full documentation](https://omgkit.mintlify.app/resources/before-commit).
+
 ## 📁 Project Structure
 
 After `omgkit init`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omgkit",
-  "version": "2.16.0",
+  "version": "2.18.0",
   "description": "Omega-Level Development Kit - AI Team System for Claude Code. 33 agents, 111 commands, 127 skills, 49 workflows.",
   "keywords": [
     "claude-code",

package/plugin/agents/brainstormer.md

@@ -1,6 +1,6 @@
 ---
 name: brainstormer
-description: Creative exploration, ideation, option generation. Use for brainstorming.
+description: Creative exploration agent specialized for ideation, brainstorming sessions, and systematic option generation for complex problems.
 tools: Read, WebSearch, Glob
 model: inherit
 skills:

package/plugin/agents/project-manager.md

@@ -44,3 +44,34 @@ You coordinate and track progress.
 - Track dependencies
 - Manage blockers
 - Report progress
+
+## Project Tracking Process
+
+### Daily Standup Template
+```markdown
+## Daily Update: [Date]
+
+### Yesterday
+- Completed: [List completed tasks]
+- Agents involved: [Names]
+
+### Today
+- Planned: [List planned tasks]
+- Assigned to: [Agent names]
+
+### Blockers
+- [Issue]: [Proposed resolution]
+```
+
+### Sprint Planning
+1. Review backlog
+2. Estimate complexity
+3. Assign to agents
+4. Set success criteria
+5. Track progress daily
+
+## Decision Log
+Track key decisions with:
+- Context and options
+- Decision rationale
+- Owner and date

package/plugin/commands/alignment/deps.md

@@ -0,0 +1,213 @@
+---
+description: Show the dependency graph tree for any OMGKIT component
+argument-hint: <type:name>
+allowed-tools: Read, Bash, Glob, Grep
+---
+
+# Dependency Graph Command
+
+Display the dependency graph tree for any component in OMGKIT.
+
+## Usage
+
+```bash
+/alignment:deps <type>:<name>
+```
+
+Where `<type>` is one of:
+- `agent` - Show agent's skills, commands, and which workflows use it
+- `workflow` - Show workflow's agents, skills, and commands
+- `skill` - Show which agents and workflows use this skill
+- `command` - Show which agents and workflows trigger this command
+
+## Examples
+
+### View Agent Dependencies
+
+```bash
+/alignment:deps agent:fullstack-developer
+```
+
+Output:
+```
+🔮 Dependency Graph: fullstack-developer
+═══════════════════════════════════════════
+
+📋 Agent: fullstack-developer
+   └── Full implementation with strict file ownership
+
+🧠 Skills Used (5):
+   ├── methodology/executing-plans
+   │   └── Skill for following implementation plans...
+   ├── methodology/verification-before-completion
+   │   └── Skill for verifying work before marking done...
+   ├── methodology/test-driven-development
+   │   └── Skill for TDD practices...
+   ├── languages/typescript
+   │   └── TypeScript language expertise...
+   └── languages/javascript
+       └── JavaScript language expertise...
+
+⚡ Commands Triggered (5):
+   ├── /dev:feature
+   ├── /dev:fix
+   ├── /dev:fix-fast
+   ├── /dev:fix-hard
+   └── /dev:tdd
+
+📊 Used By Workflows (5):
+   ├── development/feature
+   ├── development/bug-fix
+   ├── development/refactor
+   ├── omega/10x-improvement
+   └── fullstack/full-feature
+```
+
+### View Workflow Dependencies
+
+```bash
+/alignment:deps workflow:development/feature
+```
+
+Output:
+```
+🔮 Dependency Graph: development/feature
+═══════════════════════════════════════════
+
+📋 Workflow: development/feature
+   └── Complete feature development from planning to deployment
+
+🤖 Agents Orchestrated (5):
+   ├── planner
+   │   ├── Skills: methodology/writing-plans, methodology/executing-plans...
+   │   └── Commands: /planning:plan, /planning:plan-detailed...
+   ├── fullstack-developer
+   │   ├── Skills: methodology/executing-plans, languages/typescript...
+   │   └── Commands: /dev:feature, /dev:fix...
+   ├── tester
+   │   ├── Skills: methodology/test-driven-development, testing/vitest...
+   │   └── Commands: /dev:test, /dev:tdd...
+   ├── code-reviewer
+   │   ├── Skills: methodology/verification-before-completion...
+   │   └── Commands: /dev:review
+   └── git-manager
+       ├── Skills: methodology/finishing-development-branch...
+       └── Commands: /git:commit, /git:pr...
+
+🧠 Skills Applied (3):
+   ├── methodology/writing-plans
+   ├── methodology/executing-plans
+   └── methodology/test-driven-development
+
+⚡ Commands Available (6):
+   ├── /planning:plan
+   ├── /dev:feature
+   ├── /dev:test
+   ├── /dev:review
+   ├── /git:commit
+   └── /git:pr
+```
+
+### View Skill Usage (Reverse Lookup)
+
+```bash
+/alignment:deps skill:methodology/writing-plans
+```
+
+Output:
+```
+🔮 Usage Graph: methodology/writing-plans
+═══════════════════════════════════════════
+
+🧠 Skill: methodology/writing-plans
+   └── AI agent creates structured implementation plans...
+
+🤖 Used By Agents (2):
+   ├── planner
+   │   └── Task decomposition and implementation planning...
+   └── docs-manager
+       └── Documentation architect and maintainer...
+
+📊 Used By Workflows (5):
+   ├── development/feature
+   ├── fullstack/full-feature
+   ├── omega/10x-improvement
+   ├── omega/100x-architecture
+   └── sprint/sprint-setup
+```
+
+### View Command Usage (Reverse Lookup)
+
+```bash
+/alignment:deps command:/dev:feature
+```
+
+Output:
+```
+🔮 Usage Graph: /dev:feature
+═══════════════════════════════════════════
+
+⚡ Command: /dev:feature
+   └── Build a complete feature based on requirements
+
+🤖 Triggered By Agents (1):
+   └── fullstack-developer
+
+📊 Available In Workflows (4):
+   ├── development/feature
+   ├── ai-engineering/rag-development
+   ├── fullstack/full-feature
+   └── omega/10x-improvement
+```
+
+## Understanding the Graph
+
+### Forward Dependencies (dependsOn)
+Shows what components THIS component uses:
+- Agent → Skills it applies, Commands it triggers
+- Workflow → Agents it orchestrates, Skills applied, Commands available
+- Skill → Commands or MCPs it may use
+
+### Reverse Dependencies (usedBy)
+Shows what components USE this component:
+- Agent → Which workflows orchestrate it
+- Skill → Which agents apply it, which workflows include it
+- Command → Which agents trigger it, which workflows include it
+
+## Use Cases
+
+### 1. Impact Analysis
+Before modifying a component, see what depends on it:
+```bash
+/alignment:deps skill:methodology/test-driven-development
+# Shows all agents and workflows that would be affected
+```
+
+### 2. Workflow Understanding
+Understand what a workflow does and what it orchestrates:
+```bash
+/alignment:deps workflow:security/security-audit
+```
+
+### 3. Skill Discovery
+Find which agents have a particular skill:
+```bash
+/alignment:deps skill:security/owasp
+```
+
+### 4. Command Tracing
+Find which agents trigger a command:
+```bash
+/alignment:deps command:/git:commit
+```
+
+## Related Commands
+
+- `/alignment:health` - Check overall system alignment health
+- `/omega:principles` - View Omega principles
+
+## See Also
+
+- [Optimized Alignment Principle](/concepts/alignment-principle)
+- [Agents Overview](/agents/overview)
+- [Workflows Overview](/workflows/overview)

package/plugin/commands/alignment/health.md

@@ -0,0 +1,118 @@
+---
+description: Check the alignment health status of the OMGKIT system
+argument-hint:
+allowed-tools: Read, Bash, Glob, Grep
+---
+
+# Alignment Health Check
+
+Check the health status of OMGKIT's component alignment system.
+
+## Overview
+
+This command validates that:
+1. **Registry Sync** - registry.yaml matches actual component files
+2. **Dependency Integrity** - All references point to existing components
+3. **Format Compliance** - All component IDs use correct formats
+4. **Hierarchy Respect** - Components only reference appropriate levels
+
+## Usage
+
+```bash
+/alignment:health
+```
+
+## Output
+
+The command provides a comprehensive health report:
+
+```
+🔮 OMGKIT Alignment Health Report
+=================================
+
+Registry Sync Status: ✓ ALIGNED / ⚠ DRIFT DETECTED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Component Counts:
+   Agents:    33 registered, 33 actual    ✓
+   Skills:    127 actual                  ✓
+   Commands:  111 actual                  ✓
+   Workflows: 49 registered, 49 actual    ✓
+
+🔗 Dependency Health:
+   Agent→Skill refs:    153 valid    ✓
+   Agent→Command refs:  172 valid    ✓
+   Workflow→Agent refs: 156 valid    ✓
+
+Overall: ✓ HEALTHY
+```
+
+## What Gets Checked
+
+### 1. Component Count Validation
+Verifies that the number of registered components matches actual files:
+- All agents in registry exist as files
+- All workflows in registry exist as files
+- No orphaned entries (registry entries without files)
+- No missing entries (files without registry entries)
+
+### 2. Dependency Reference Validation
+Verifies all dependency references are valid:
+- Agent skill references point to existing skills
+- Agent command references point to existing commands
+- Workflow agent references point to existing agents
+- Workflow skill references point to existing skills
+- Workflow command references point to existing commands
+
+### 3. Format Compliance
+Verifies all component IDs use correct formats:
+- Skills: `category/skill-name`
+- Commands: `/namespace:command-name`
+- Agents: `kebab-case`
+- Workflows: `category/workflow-name`
+
+### 4. Hierarchy Validation
+Verifies the Optimized Alignment Principle:
+- 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
+
+## Troubleshooting
+
+If the health check reports issues:
+
+### Registry Drift
+```bash
+# Check specific component
+/alignment:deps agent:fullstack-developer
+
+# Review the registry
+cat plugin/registry.yaml | grep fullstack-developer
+```
+
+### Missing References
+```bash
+# Verify skill exists
+ls plugin/skills/methodology/writing-plans/SKILL.md
+
+# Verify command exists
+ls plugin/commands/dev/feature.md
+```
+
+### Format Issues
+Ensure component references follow the correct format:
+- Skills must have category prefix: `methodology/writing-plans`
+- Commands must have namespace: `/dev:feature`
+- Agents must be kebab-case: `fullstack-developer`
+
+## Related Commands
+
+- `/alignment:deps <component>` - Show dependency graph for any component
+- `/omega:principles` - View the Omega principles including alignment
+
+## See Also
+
+- [Optimized Alignment Principle](/concepts/alignment-principle)
+- [Registry Documentation](/concepts/registry)

package/plugin/commands/git/cm.md

@@ -7,7 +7,11 @@ allowed-tools: Bash
 
 Quick conventional commit for staged changes.
 
+## Usage
+
 ```bash
 git add -A
 git commit -m "type(scope): message"
 ```
+
+Follow conventional commit format: `feat`, `fix`, `docs`, `chore`, `refactor`, `test`.

package/plugin/commands/sprint/sprint-new.md

@@ -1,7 +1,7 @@
 ---
 description: Create new sprint
 allowed-tools: Task, Read, Write, Grep, Glob
-argument-hint: [name] [--propose]
+argument-hint: "[name] [--propose]"
 ---
 
 # 🏃 Sprint New: $ARGUMENTS

package/plugin/registry.yaml

@@ -1,9 +1,9 @@
 # OMGKIT Component Registry
 # Single Source of Truth for Agents, Skills, Commands, Workflows, and MCPs
-# Version: 2.0.0
+# Version: 2.18.0
 # Updated: 2026-01-02
 
-version: "2.0.0"
+version: "2.17.0"
 
 # =============================================================================
 # OPTIMIZED ALIGNMENT PRINCIPLE (OAP)
@@ -449,21 +449,7 @@ agents:
   # ---------------------------------------------------------------------------
   # SPECIALIZED AGENTS
   # ---------------------------------------------------------------------------
-  autonomous-orchestrator:
-    file: agents/autonomous-orchestrator.yaml
-    description: State-driven autonomous project execution
-    skills:
-      - autonomous/project-orchestration
-    commands:
-      - /auto:init
-      - /auto:start
-      - /auto:status
-      - /auto:next
-      - /auto:approve
-      - /auto:reject
-      - /auto:verify
-      - /auto:checkpoint
-      - /auto:resume
+  # Note: autonomous-orchestrator uses YAML format and is handled separately
 
   domain-decomposer:
     file: agents/domain-decomposer.md
@@ -542,6 +528,7 @@ skill_categories:
 # All valid command namespace prefixes
 
 command_namespaces:
+  - alignment # Alignment and dependency graph
   - auto      # Autonomous orchestration
   - context   # Context management
   - data      # Data engineering
@@ -578,15 +565,15 @@ workflows:
     commands: [/planning:plan, /dev:feature, /dev:test, /dev:review, /git:pr]
 
   development/bug-fix:
-    agents: [debugger, fullstack-developer, tester, code-reviewer, git-manager]
+    agents: [debugger, fullstack-developer, tester, git-manager]
     skills:
       - methodology/systematic-debugging
       - methodology/root-cause-tracing
       - methodology/test-driven-development
-    commands: [/dev:fix, /dev:fix-hard, /dev:test, /git:cm]
+    commands: [/dev:fix, /dev:fix-hard, /dev:fix-test, /git:cm]
 
   development/refactor:
-    agents: [architect, fullstack-developer, tester, code-reviewer, git-manager]
+    agents: [code-reviewer, fullstack-developer, tester, git-manager]
     skills:
       - methodology/verification-before-completion
       - methodology/test-driven-development
@@ -618,31 +605,31 @@ workflows:
     commands: [/planning:research, /planning:plan-detailed, /dev:feature, /dev:test, /quality:security-scan]
 
   ai-engineering/fine-tuning:
-    agents: [ml-engineer, data-engineer, tester]
+    agents: [researcher, planner, fullstack-developer, tester]
     skills:
       - ai-engineering/finetuning
       - ai-engineering/dataset-engineering
       - ai-engineering/evaluation-methodology
-    commands: [/planning:plan, /ml:train, /ml:evaluate, /dev:test]
+    commands: [/planning:plan, /dev:feature, /dev:test]
 
   ai-engineering/prompt-engineering:
-    agents: [researcher, fullstack-developer, tester]
+    agents: [researcher, tester]
     skills:
       - ai-engineering/prompt-engineering
       - ai-engineering/evaluation-methodology
-    commands: [/planning:research, /dev:feature, /dev:test]
+    commands: [/planning:research, /dev:test]
 
   ai-engineering/model-evaluation:
-    agents: [ml-engineer, researcher, tester]
+    agents: [researcher, planner, tester]
     skills:
       - ai-engineering/ai-system-evaluation
       - ai-engineering/evaluation-methodology
       - ai-engineering/dataset-engineering
-    commands: [/planning:plan, /ml:evaluate, /dev:test]
+    commands: [/planning:plan, /dev:test]
 
   # Security workflows
   security/security-audit:
-    agents: [security-auditor, fullstack-developer, docs-manager]
+    agents: [security-auditor, vulnerability-scanner, code-reviewer, fullstack-developer, docs-manager]
     skills:
       - security/owasp
       - security/security-hardening
@@ -659,7 +646,7 @@ workflows:
 
   # Database workflows
   database/schema-design:
-    agents: [database-admin, architect, fullstack-developer, tester]
+    agents: [database-admin, planner, tester]
     skills:
       - databases/database-schema-design
       - databases/postgresql
@@ -667,20 +654,20 @@ workflows:
     commands: [/planning:plan, /dev:feature, /dev:test]
 
   database/migration:
-    agents: [database-admin, fullstack-developer, tester]
+    agents: [database-admin, planner, tester]
     skills:
       - databases/database-migration
-    commands: [/planning:plan, /dev:feature, /dev:test]
+    commands: [/planning:plan, /dev:test]
 
   database/optimization:
-    agents: [database-admin, performance-engineer, tester]
+    agents: [database-admin, tester]
     skills:
       - databases/database-optimization
-    commands: [/quality:optimize, /perf:profile, /dev:test]
+    commands: [/quality:optimize, /dev:test]
 
   # API workflows
   api/api-design:
-    agents: [api-designer, architect, docs-manager, code-reviewer]
+    agents: [api-designer, planner, docs-manager, code-reviewer]
     skills:
       - backend/api-architecture
     commands: [/planning:plan, /quality:api-gen, /planning:doc, /dev:review]
@@ -694,21 +681,21 @@ workflows:
 
   # Omega workflows
   omega/10x-improvement:
-    agents: [oracle, brainstormer, fullstack-developer, tester]
+    agents: [oracle, architect, brainstormer, fullstack-developer, tester, journal-writer]
     skills:
       - omega/omega-thinking
       - omega/omega-coding
     commands: [/omega:10x, /planning:brainstorm, /dev:feature, /dev:test]
 
   omega/100x-architecture:
-    agents: [oracle, architect, researcher]
+    agents: [oracle, architect, planner, researcher]
     skills:
       - omega/omega-architecture
       - omega/omega-thinking
     commands: [/omega:100x, /planning:plan-detailed]
 
   omega/1000x-innovation:
-    agents: [oracle, researcher, brainstormer]
+    agents: [oracle, researcher, brainstormer, architect]
     skills:
       - omega/omega-thinking
       - omega/omega-architecture
@@ -716,27 +703,27 @@ workflows:
 
   # Sprint workflows
   sprint/sprint-setup:
-    agents: [sprint-master, planner]
+    agents: [sprint-master, planner, project-manager]
     skills:
       - omega/omega-sprint
     commands: [/sprint:vision-set, /sprint:backlog-add, /sprint:backlog-prioritize, /sprint:sprint-new, /sprint:sprint-start]
 
   sprint/sprint-execution:
-    agents: [sprint-master, fullstack-developer, tester, debugger]
+    agents: [sprint-master, fullstack-developer, tester, debugger, project-manager]
     skills:
       - omega/omega-sprint
       - methodology/executing-plans
     commands: [/sprint:sprint-current, /sprint:team-run, /sprint:team-status, /dev:fix, /sprint:sprint-end]
 
   sprint/sprint-retrospective:
-    agents: [sprint-master, journal-writer, docs-manager]
+    agents: [sprint-master, project-manager, journal-writer]
     skills:
       - omega/omega-sprint
     commands: [/sprint:sprint-end, /planning:doc]
 
   # Fullstack workflows
   fullstack/full-feature:
-    agents: [planner, architect, fullstack-developer, tester, code-reviewer, git-manager]
+    agents: [planner, database-admin, api-designer, ui-ux-designer, fullstack-developer, tester, code-reviewer, git-manager]
     skills:
       - methodology/writing-plans
       - databases/database-schema-design
@@ -745,7 +732,7 @@ workflows:
     commands: [/planning:plan-detailed, /dev:feature, /dev:test, /dev:review, /git:pr]
 
   fullstack/authentication:
-    agents: [architect, fullstack-developer, security-auditor, tester]
+    agents: [planner, fullstack-developer, security-auditor, tester]
     skills:
       - security/oauth
       - security/better-auth
@@ -755,21 +742,21 @@ workflows:
 
   # Quality workflows
   quality/performance-optimization:
-    agents: [performance-engineer, fullstack-developer, tester]
+    agents: [fullstack-developer, tester]
     skills:
       - ai-engineering/inference-optimization
       - databases/database-optimization
-    commands: [/quality:optimize, /perf:profile, /dev:test]
+    commands: [/quality:optimize, /dev:test]
 
   # Research workflows
   research/technology-research:
-    agents: [researcher, architect, docs-manager]
+    agents: [researcher, oracle, docs-manager]
     skills:
       - methodology/research-validation
     commands: [/planning:research, /planning:doc]
 
   research/best-practices:
-    agents: [researcher, fullstack-developer]
+    agents: [researcher, planner, fullstack-developer]
     skills:
       - methodology/research-validation
     commands: [/planning:research, /planning:plan, /dev:feature]

package/plugin/stdrules/BEFORE_COMMIT_RULES.md

@@ -0,0 +1,367 @@
+# OMGKIT Before-Commit Rules v1.0
+
+> Comprehensive quality gates that MUST pass before any commit to OMGKIT.
+> Run `npm test` to validate all rules automatically.
+
+---
+
+## Overview
+
+This document defines the mandatory validation checks that must pass before committing changes to OMGKIT. These rules ensure system integrity, documentation quality, and proper command registration.
+
+---
+
+## 1. Test Validation (MANDATORY)
+
+All commits MUST pass the complete test suite:
+
+```bash
+npm test
+```
+
+**Minimum Requirements:**
+- All tests must pass (0 failures)
+- Current baseline: 3700+ tests
+- Coverage must not decrease
+
+---
+
+## 2. Registry Integrity
+
+### 2.1 Registry Sync
+
+The `registry.yaml` file must be synchronized with actual component files:
+
+| Check | Description |
+|-------|-------------|
+| Agent Sync | All registered agents exist as `.md` files in `plugin/agents/` |
+| Workflow Sync | All registered workflows exist as `.md` files in `plugin/workflows/` |
+| Namespace Sync | All command namespaces in registry exist as directories |
+| Category Sync | All skill categories in registry exist as directories |
+
+**Validation Command:**
+```bash
+npm test -- tests/validation/registry-sync.test.js
+```
+
+### 2.2 Dependency Graph Integrity
+
+All component references must be valid:
+
+| Reference Type | Format | Example |
+|----------------|--------|---------|
+| Skill | `category/skill-name` | `methodology/writing-plans` |
+| Command | `/namespace:command-name` | `/dev:feature` |
+| Agent | `kebab-case` | `fullstack-developer` |
+| Workflow | `category/workflow-name` | `development/feature` |
+
+**Validation Command:**
+```bash
+npm test -- tests/validation/dependency-graph.test.js
+```
+
+---
+
+## 3. Command Registration (CRITICAL)
+
+### 3.1 Slash Command Requirements
+
+Every command in OMGKIT MUST be registered as a Claude Code slash command. This means:
+
+**File Location:**
+- Commands must be in `plugin/commands/<namespace>/<command-name>.md`
+- Namespace directory must exist
+
+**Format Requirements:**
+- Command ID format: `/namespace:command-name`
+- All lowercase, hyphens for word separation
+- Namespace must be registered in `registry.yaml` under `command_namespaces`
+
+**Frontmatter Requirements:**
+```yaml
+---
+description: Clear description of what the command does
+argument-hint: <optional argument format>
+allowed-tools: List, Of, Allowed, Tools
+---
+```
+
+### 3.2 Command Registration Checklist
+
+| Requirement | Description |
+|-------------|-------------|
+| **File exists** | `plugin/commands/<namespace>/<name>.md` exists |
+| **Namespace registered** | Namespace in `registry.yaml` `command_namespaces` |
+| **Valid frontmatter** | Has `description` field |
+| **Content present** | Body has usage instructions |
+| **Format compliance** | Follows `/namespace:command-name` format |
+
+### 3.3 Current Command Namespaces
+
+All commands must belong to one of these registered namespaces:
+
+| Namespace | Purpose |
+|-----------|---------|
+| `dev` | Development commands (feature, fix, test, tdd, review) |
+| `planning` | Planning commands (plan, brainstorm, research, doc) |
+| `git` | Git operations (commit, ship, pr, deploy) |
+| `quality` | Quality commands (security-scan, refactor, optimize) |
+| `omega` | Omega thinking (10x, 100x, 1000x, principles) |
+| `sprint` | Sprint management (sprint-new, team-run, backlog) |
+| `workflow` | Workflow triggers (feature, bug-fix, rag-development) |
+| `auto` | Autonomous mode (init, start, approve, reject) |
+| `context` | Context management (mode, index, load, checkpoint) |
+| `design` | UI/UX design (screenshot, enhance, cro) |
+| `alignment` | System alignment (health, deps) |
+| `security` | Security commands (scan, audit) |
+| `data` | Data commands (pipeline, quality) |
+| `ml` | ML commands (train, evaluate) |
+| `game` | Game dev commands (balance, optimize) |
+| `iot` | IoT commands (provision) |
+| `perf` | Performance commands (profile, benchmark) |
+| `domain` | Domain modeling (analyze, map) |
+| `platform` | Platform engineering (blueprint) |
+| `sre` | SRE commands (dashboard) |
+
+---
+
+## 4. Documentation Quality Standards
+
+### 4.1 Agent Documentation
+
+**Minimum Requirements:**
+
+| Field | Requirement |
+|-------|-------------|
+| File location | `plugin/agents/<agent-name>.md` |
+| Frontmatter | `skills` and `commands` arrays |
+| Description | 50-200 words explaining purpose |
+| Responsibilities | 3-5 primary, 2-4 secondary |
+| Minimum lines | 50+ lines of content |
+
+**Required Sections:**
+- Description/Overview
+- Primary Responsibilities
+- Skills Used
+- Commands Triggered
+- Usage Examples
+
+### 4.2 Command Documentation
+
+**Minimum Requirements:**
+
+| Field | Requirement |
+|-------|-------------|
+| File location | `plugin/commands/<namespace>/<name>.md` |
+| Frontmatter | `description`, `allowed-tools` |
+| Description | Clear, actionable description |
+| Minimum lines | 15+ lines of content |
+
+**Required Frontmatter Fields:**
+```yaml
+---
+description: What the command does (required)
+argument-hint: Expected arguments (recommended)
+allowed-tools: Comma-separated tool list (required)
+---
+```
+
+### 4.3 Skill Documentation
+
+**Minimum Requirements:**
+
+| Field | Requirement |
+|-------|-------------|
+| File location | `plugin/skills/<category>/<name>/SKILL.md` |
+| Frontmatter | `name`, `description` |
+| Description | Third-person, 50-150 words |
+| Minimum lines | 30+ lines of content |
+
+**Must Follow:** `plugin/stdrules/SKILL_STANDARDS.md`
+
+### 4.4 Workflow Documentation
+
+**Minimum Requirements:**
+
+| Field | Requirement |
+|-------|-------------|
+| File location | `plugin/workflows/<category>/<name>.md` |
+| Frontmatter | name, description, category, complexity, agents, skills, commands |
+| Steps | Clear step-by-step process |
+| Quality Gates | Completion checklist |
+| Minimum lines | 50+ lines of content |
+
+**Required Frontmatter Fields:**
+```yaml
+---
+name: workflow-name
+description: What the workflow accomplishes
+category: workflow-category
+complexity: low|medium|high|very-high
+estimated-time: Time estimate
+agents:
+  - agent-name
+skills:
+  - category/skill-name
+commands:
+  - /namespace:command-name
+prerequisites:
+  - Prerequisite 1
+---
+```
+
+---
+
+## 5. Content Quality Rules
+
+### 5.1 Prohibited Content
+
+- No placeholder text: `TODO`, `FIXME`, `XXX`, `HACK`
+- No empty sections
+- No broken internal links
+- No duplicate content across components
+
+### 5.2 Required Content Elements
+
+**Code Blocks:**
+- Must have language specifier
+- Must be properly indented
+- Must be functional examples
+
+**Links:**
+- Internal links must be relative
+- External links must be valid
+- All referenced files must exist
+
+### 5.3 Formatting Standards
+
+- Use proper Markdown heading hierarchy (h1 > h2 > h3)
+- Use consistent list formatting
+- Use tables for structured data
+- Use code blocks for commands/examples
+
+---
+
+## 6. Cross-Reference Validation
+
+### 6.1 Forward References (dependsOn)
+
+All references in component frontmatter must point to existing components:
+
+| Source | Reference Type | Target |
+|--------|---------------|--------|
+| Agent | skills | Skill files |
+| Agent | commands | Command files |
+| Workflow | agents | Agent files |
+| Workflow | skills | Skill files |
+| Workflow | commands | Command files |
+
+### 6.2 Reverse References (usedBy)
+
+The dependency graph must correctly compute:
+
+| Component | usedBy |
+|-----------|--------|
+| Skill | Agents that use it, Workflows that include it |
+| Command | Agents that trigger it, Workflows that include it |
+| Agent | Workflows that orchestrate it |
+
+---
+
+## 7. Version Management
+
+### 7.1 Version Bump Requirements
+
+When releasing:
+- Bump `package.json` version
+- Bump `plugin/registry.yaml` version
+- Update version comment in registry header
+
+### 7.2 Changelog
+
+Document changes in commit message following conventional commits:
+- `feat:` New features
+- `fix:` Bug fixes
+- `docs:` Documentation changes
+- `chore:` Maintenance tasks
+- `refactor:` Code refactoring
+- `test:` Test additions/changes
+
+---
+
+## 8. Pre-Commit Checklist
+
+### Quick Validation
+
+```bash
+# Run all tests
+npm test
+
+# Check specific validations
+npm test -- tests/validation/registry-sync.test.js
+npm test -- tests/validation/dependency-graph.test.js
+npm test -- tests/validation/before-commit.test.js
+npm test -- tests/validation/doc-quality.test.js
+npm test -- tests/validation/command-registration.test.js
+```
+
+### Manual Checklist
+
+- [ ] All tests pass (`npm test`)
+- [ ] Registry.yaml synced with actual files
+- [ ] All commands registered as slash commands
+- [ ] All command namespaces in registry
+- [ ] Documentation meets quality standards
+- [ ] No broken internal links
+- [ ] Dependency graph valid
+- [ ] Version bumped (if releasing)
+- [ ] Docs regenerated (`npm run docs:generate`)
+
+---
+
+## 9. Automated Validation
+
+### Test Files
+
+| Test File | Purpose |
+|-----------|---------|
+| `registry-sync.test.js` | Registry matches actual files |
+| `dependency-graph.test.js` | Dependency references valid |
+| `before-commit.test.js` | All pre-commit rules |
+| `doc-quality.test.js` | Documentation quality |
+| `command-registration.test.js` | Command slash registration |
+| `format.test.js` | Format compliance |
+| `alignment.test.js` | Alignment principle |
+
+### Running Validation
+
+```bash
+# Full validation
+npm test
+
+# Quick validation (key tests only)
+npm test -- tests/validation/before-commit.test.js
+```
+
+---
+
+## 10. Enforcement
+
+### CI/CD Integration
+
+These rules are enforced in CI:
+- All tests must pass before merge
+- Documentation must be regenerated
+- Version must be bumped for releases
+
+### Local Development
+
+Before committing:
+1. Run `npm test`
+2. Fix any failures
+3. Re-run until all pass
+4. Commit with proper message
+
+---
+
+*Think Omega. Build Omega. Be Omega.*