omgkit 2.16.0 → 2.17.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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omgkit",
-  "version": "2.16.0",
+  "version": "2.17.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/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/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.17.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]