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
4. Reference-Aware Planning (New)
Use PRDs, specs, and design documents to inform sprint planning:
```bash
# Create sprint with PRD reference
/sprint:sprint-new "Auth Sprint" --ref=.omgkit/artifacts/prd-auth.md
# Sprint with multiple references
/sprint:sprint-new "Payment" --ref=artifacts/prd.md,specs/api.yaml
# Sprint with AI proposal based on references
/sprint:sprint-new "MVP" --propose --ref=.omgkit/artifacts/
```
Configure in .omgkit/workflow.yaml:
```yaml
references:
enabled: true
auto_suggest: true
max_tokens: 10000
extract_sections:
- requirements
- user_stories
- acceptance_criteria
```
References automatically propagate to /sprint:team-run and /sprint:backlog-add.
5. Testing Automation
OMGKIT includes a comprehensive testing automation system:
#### Auto-Generate Test Tasks
When you create a feature, OMGKIT automatically generates corresponding test tasks:
```yaml
# workflow.yaml
testing:
auto_generate_tasks: true
required_test_types:
- unit
- integration
```
Feature tasks automatically spawn test tasks based on feature type (API β Contract tests, UI β Snapshot tests, etc.)
#### Enforce Tests Before Done
No task can be marked "done" without passing tests:
```yaml
testing:
enforcement:
level: standard # soft | standard | strict
blocking:
on_test_failure: true
on_coverage_below_minimum: true
```
#### Coverage Gates
Set minimum and target coverage thresholds:
```yaml
testing:
coverage_gates:
unit:
minimum: 80
target: 90
integration:
minimum: 60
target: 75
overall:
minimum: 75
target: 85
```
6. Design System
OMGKIT includes a complete design system with 30 curated V2 themes for shadcn/ui integration. All themes use the V2 schema with 12-step color scales, effects, and animations.
```bash
# Initialize with a theme (opt-in)
omgkit init --theme neo-tokyo
# Or explore themes first
omgkit init --with-design
```
#### V2 Theme Features
All 30 themes include:
| Feature | Description |
|---------|-------------|
| 12-step color scales | --primary-1 through --primary-12 |
| Alpha variants | --primary-a1 through --primary-a12 |
| Status colors | --success, --warning, --info, --destructive |
| Effects | glassMorphism, glow, gradients |
| Animations | shimmer, pulse-glow, fade-in, slide-up |
| Backward compatibility | Includes flat colors block for legacy support |
#### 5 Theme Categories
| Category | Themes | Description |
|----------|--------|-------------|
| Tech & AI | neo-tokyo, electric-cyan, neural-dark, matrix-green, quantum-purple, hologram | Futuristic, cyberpunk-inspired |
| Minimal & Clean | minimal-slate, paper, mono, zen, nordic, swiss | Simple, elegant, distraction-free |
| Corporate | ocean-blue, corporate-indigo, finance, legal, healthcare, consulting | Professional, trustworthy |
| Creative & Bold | coral-sunset, candy, neon, gradient-dream, retro, studio | Vibrant, expressive |
| Nature & Organic | forest, ocean, desert, lavender, arctic, autumn | Earth tones, calming |
#### Design Commands
| Command | Description |
|---------|-------------|
| /design:themes | List all 30 curated themes |
| /design:theme | Apply a theme to your project |
| /design:preview | Preview current theme colors |
| /design:builder | Build custom theme interactively |
| /design:from-screenshot | Extract theme from image |
| /design:from-url | Extract theme from webpage |
| /design:add | Add shadcn/ui components |
| /design:reset | Reset to original theme |
| /design:rebuild | Rebuild entire project with new theme |
| /design:scan | Scan for non-compliant colors |
| /design:rollback | Rollback to previous theme |
| /design:export | Export to CSS, SCSS, Tailwind, Figma, Style Dictionary |
| /design:validate | Validate theme structure |
#### Theme Export
Export your theme to various design tools and framework formats:
```bash
# Export CSS
/design:export css
# Export Figma tokens
/design:export figma --output ./tokens/
# Export all formats
/design:export --all
```
Supported formats: css, scss, tailwind, figma, style-dictionary
#### Theme Rebuild
Rebuild your entire project's UI with a single command:
```bash
# Rebuild with new theme (scans and fixes hardcoded colors)
omgkit design:rebuild neo-tokyo
# Full auto mode - zero manual steps, scans ALL directories
omgkit design:rebuild neo-tokyo --full
# Preview changes without applying
omgkit design:rebuild neo-tokyo --dry
# Scan for non-compliant colors
omgkit design:sca
|