omgkit 2.15.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 • 128 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,9 +17,9 @@ 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** | 128 | Domain expertise modules |
+| **Skills** | 127 | Domain expertise modules |
 | **Modes** | 10 | Behavioral configurations |
 | **Archetypes** | 14 | Project templates for autonomous dev |
 | **Sprint Management** | ✅ | Vision, backlog, team autonomy |
@@ -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.
@@ -445,6 +457,42 @@ OMGKIT supports these MCP servers for enhanced capabilities:
 | Filesystem | Secure file operations |
 | Playwright | Browser automation |
 
+## 🏗️ 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
+```
+
+### Five Alignment Rules
+
+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
+
+### Component Formats
+
+| 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` |
+
+All alignment rules are enforced by 400+ automated tests. See [full documentation](https://omgkit.mintlify.app/concepts/alignment-principle).
+
 ## 📄 License
 
 MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "omgkit",
-  "version": "2.15.0",
-  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 33 agents, 111 commands, 128 skills, 49 workflows.",
+  "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",
     "ai",

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)