omgkit 2.25.1 → 2.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,17 @@
1
1
  ---
2
- description: Test-driven development workflow
2
+ description: Test-driven development workflow with enforced test-first methodology
3
3
  allowed-tools: Task, Read, Write, Bash, Glob
4
- argument-hint: <feature>
4
+ argument-hint: <feature> [--coverage PERCENT] [--test-types TYPES]
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ - methodology/systematic-debugging
8
+ related_commands:
9
+ - /dev:feature-tested
10
+ - /dev:test-write
11
+ - /quality:verify-done
12
+ testing:
13
+ default: true
14
+ configurable: false
5
15
  ---
6
16
 
7
17
  # 🔴🟢♻️ TDD: $ARGUMENTS
@@ -19,6 +29,23 @@ Test-driven development for: **$ARGUMENTS**
19
29
  - Only enough code to pass test
20
30
  - Refactor only when green
21
31
 
32
+ ## Testing Options
33
+
34
+ This command **always enforces testing** (TDD by definition). Testing cannot be disabled.
35
+
36
+ ### Options
37
+
38
+ | Option | Description | Example |
39
+ |--------|-------------|---------|
40
+ | `--coverage <percent>` | Set minimum coverage | `/dev:tdd "auth" --coverage 95` |
41
+ | `--test-types <types>` | Specify test types | `/dev:tdd "api" --test-types unit,integration` |
42
+
43
+ ### Coverage Requirements
44
+
45
+ TDD defaults to high coverage requirements:
46
+ - **Minimum**: 90% (higher than standard commands)
47
+ - **Target**: 95%
48
+
22
49
  ## Process
23
50
  For each requirement:
24
51
  1. Write test first
@@ -27,3 +54,29 @@ For each requirement:
27
54
  4. Run test (should pass)
28
55
  5. Refactor if needed
29
56
  6. Next requirement
57
+
58
+ ## Configuration
59
+
60
+ Configure via `.omgkit/workflow.yaml`:
61
+
62
+ ```yaml
63
+ testing:
64
+ enabled: true
65
+ coverage_gates:
66
+ unit:
67
+ minimum: 90
68
+ target: 95
69
+ ```
70
+
71
+ ## Examples
72
+
73
+ ```bash
74
+ # Standard TDD workflow
75
+ /dev:tdd "user authentication"
76
+
77
+ # TDD with specific coverage target
78
+ /dev:tdd "payment processing" --coverage 95
79
+
80
+ # TDD with specific test types
81
+ /dev:tdd "API endpoint" --test-types unit,integration,contract
82
+ ```
@@ -1,7 +1,17 @@
1
1
  ---
2
2
  description: Write comprehensive tests following OMGKIT Omega Testing methodology
3
3
  allowed-tools: Task, Read, Write, Bash, Glob
4
- argument-hint: <function-or-file>
4
+ argument-hint: <function-or-file> [--coverage PERCENT] [--test-types TYPES]
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ - methodology/test-task-generation
8
+ related_commands:
9
+ - /dev:test
10
+ - /dev:tdd
11
+ - /quality:verify-done
12
+ testing:
13
+ default: true
14
+ configurable: true
5
15
  ---
6
16
 
7
17
  # Write Omega-Level Tests
@@ -121,6 +131,32 @@ npm run test:coverage
121
131
  npx stryker run
122
132
  ```
123
133
 
134
+ ## Testing Options
135
+
136
+ This command respects project testing configuration from `.omgkit/workflow.yaml`.
137
+
138
+ ### Options
139
+
140
+ | Option | Description | Example |
141
+ |--------|-------------|---------|
142
+ | `--coverage <percent>` | Target coverage | `/dev:test-write "auth.ts" --coverage 95` |
143
+ | `--test-types <types>` | Test categories | `/dev:test-write "api.ts" --test-types unit,security` |
144
+ | `--4d` | Include all 4D tests | `/dev:test-write "payment.ts" --4d` |
145
+
146
+ ### Configuration
147
+
148
+ Configure via `.omgkit/workflow.yaml`:
149
+
150
+ ```yaml
151
+ testing:
152
+ enabled: true
153
+ enforcement:
154
+ level: standard
155
+ coverage_gates:
156
+ unit:
157
+ minimum: 80
158
+ ```
159
+
124
160
  ## Output Checklist
125
161
 
126
162
  Before completing, verify:
@@ -1,7 +1,17 @@
1
1
  ---
2
- description: Generate and run tests
2
+ description: Generate and run tests with configurable coverage enforcement
3
3
  allowed-tools: Task, Read, Write, Bash, Glob
4
- argument-hint: <scope>
4
+ argument-hint: <scope> [--coverage PERCENT] [--test-types TYPES] [--watch]
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ - methodology/test-task-generation
8
+ related_commands:
9
+ - /dev:test-write
10
+ - /dev:tdd
11
+ - /quality:coverage-check
12
+ testing:
13
+ default: true
14
+ configurable: true
5
15
  ---
6
16
 
7
17
  # 🧪 Test: $ARGUMENTS
@@ -13,13 +23,74 @@ Generate tests for: **$ARGUMENTS**
13
23
  2. **Integration Tests** - Component interactions
14
24
  3. **E2E Tests** - User flows
15
25
 
26
+ ## Testing Options
27
+
28
+ This command respects project testing configuration from `.omgkit/workflow.yaml`.
29
+
30
+ ### Default Behavior
31
+
32
+ - **Testing**: Always enabled (this is a test command)
33
+ - **Coverage Enforcement**: Read from `testing.enforcement.level`
34
+ - **Coverage Targets**: Configurable via options or config
35
+
36
+ ### Options
37
+
38
+ | Option | Description | Example |
39
+ |--------|-------------|---------|
40
+ | `--coverage <percent>` | Override minimum coverage | `/dev:test "src/" --coverage 90` |
41
+ | `--test-types <types>` | Specify test types | `/dev:test "api/" --test-types unit,integration` |
42
+ | `--watch` | Run in watch mode | `/dev:test "src/" --watch` |
43
+ | `--fail-under <percent>` | Fail if coverage below | `/dev:test "lib/" --fail-under 80` |
44
+
45
+ ### Enforcement Levels
46
+
47
+ | Level | Coverage Below Min | Test Failure |
48
+ |-------|-------------------|--------------|
49
+ | `soft` | Warning | Warning |
50
+ | `standard` | Block | Block |
51
+ | `strict` | Block | Block |
52
+
16
53
  ## Coverage Targets
17
54
  - Unit: 80%+
18
55
  - Integration: 60%+
19
56
  - E2E: Critical paths
20
57
 
58
+ ## Configuration
59
+
60
+ Configure via `.omgkit/workflow.yaml`:
61
+
62
+ ```yaml
63
+ testing:
64
+ enabled: true
65
+ enforcement:
66
+ level: standard
67
+ coverage_gates:
68
+ unit:
69
+ minimum: 80
70
+ target: 90
71
+ integration:
72
+ minimum: 60
73
+ target: 75
74
+ ```
75
+
21
76
  ## Output
22
77
  ```
23
78
  Tests: X passed, Y failed
24
79
  Coverage: Z%
25
80
  ```
81
+
82
+ ## Examples
83
+
84
+ ```bash
85
+ # Run tests with default settings
86
+ /dev:test "src/services"
87
+
88
+ # Run with higher coverage requirement
89
+ /dev:test "src/auth" --coverage 95
90
+
91
+ # Run specific test types
92
+ /dev:test "src/api" --test-types unit,integration
93
+
94
+ # Run in watch mode during development
95
+ /dev:test "src/" --watch
96
+ ```
@@ -1,7 +1,15 @@
1
1
  ---
2
- description: Performance optimization
3
- allowed-tools: Task, Read, Write, Bash, Grep
4
- argument-hint: <file>
2
+ description: Performance optimization with test verification
3
+ allowed-tools: Task, Read, Write, Bash, Grep, Glob
4
+ argument-hint: <file> [--no-test] [--test-level LEVEL] [--benchmark]
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ related_commands:
8
+ - /quality:refactor
9
+ - /quality:verify-done
10
+ testing:
11
+ default: true
12
+ configurable: true
5
13
  ---
6
14
 
7
15
  # ⚡ Optimize: $ARGUMENTS
@@ -15,9 +23,64 @@ Optimize performance of: **$ARGUMENTS**
15
23
  - Bundle size
16
24
  - Caching
17
25
 
26
+ ## Testing Options
27
+
28
+ This command respects project testing configuration from `.omgkit/workflow.yaml`.
29
+
30
+ ### Default Behavior
31
+
32
+ - **Testing**: Enabled by default (verify functionality after optimization)
33
+ - **Enforcement Level**: Read from `testing.enforcement.level` (default: standard)
34
+ - **Performance Tests**: Encouraged to add benchmark tests
35
+
36
+ ### Options
37
+
38
+ | Option | Description | Example |
39
+ |--------|-------------|---------|
40
+ | `--no-test` | Skip test verification | `/quality:optimize "db.ts" --no-test` |
41
+ | `--test-level <level>` | Override enforcement level | `/quality:optimize "core/" --test-level strict` |
42
+ | `--benchmark` | Include performance benchmarks | `/quality:optimize "api/" --benchmark` |
43
+
44
+ ### Enforcement Levels
45
+
46
+ | Level | Test Failure After Optimization |
47
+ |-------|--------------------------------|
48
+ | `soft` | Warning |
49
+ | `standard` | Block |
50
+ | `strict` | Block |
51
+
18
52
  ## Process
19
53
  1. Profile current performance
20
- 2. Identify bottlenecks
21
- 3. Apply optimizations
22
- 4. Measure improvement
23
- 5. Document changes
54
+ 2. **Run existing tests** (baseline)
55
+ 3. Identify bottlenecks
56
+ 4. Apply optimizations
57
+ 5. **Verify tests still pass**
58
+ 6. Measure improvement
59
+ 7. Document changes
60
+
61
+ ## Configuration
62
+
63
+ Configure via `.omgkit/workflow.yaml`:
64
+
65
+ ```yaml
66
+ testing:
67
+ enabled: true
68
+ enforcement:
69
+ level: standard
70
+ ```
71
+
72
+ ## Examples
73
+
74
+ ```bash
75
+ # Default: with test verification
76
+ /quality:optimize "src/services/search.ts"
77
+
78
+ # With performance benchmarks
79
+ /quality:optimize "src/db/queries.ts" --benchmark
80
+
81
+ # Skip tests for infrastructure optimization
82
+ /quality:optimize "webpack.config.js" --no-test
83
+
84
+ # Strict mode for critical paths
85
+ /quality:optimize "src/core/engine.ts" --test-level strict
86
+ ```
@@ -1,7 +1,16 @@
1
1
  ---
2
- description: Improve code structure
2
+ description: Improve code structure with test verification
3
3
  allowed-tools: Task, Read, Write, Bash, Grep, Glob
4
- argument-hint: <file or directory>
4
+ argument-hint: <file or directory> [--no-test] [--test-level LEVEL]
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ related_commands:
8
+ - /dev:fix
9
+ - /quality:optimize
10
+ - /quality:verify-done
11
+ testing:
12
+ default: true
13
+ configurable: true
5
14
  ---
6
15
 
7
16
  # ♻️ Refactor: $ARGUMENTS
@@ -14,9 +23,59 @@ Improve code structure of: **$ARGUMENTS**
14
23
  - Apply patterns
15
24
  - Simplify complexity
16
25
 
26
+ ## Testing Options
27
+
28
+ This command respects project testing configuration from `.omgkit/workflow.yaml`.
29
+
30
+ ### Default Behavior
31
+
32
+ - **Testing**: Enabled by default (verify tests pass after refactoring)
33
+ - **Enforcement Level**: Read from `testing.enforcement.level` (default: standard)
34
+ - **Regression Prevention**: Ensures refactoring doesn't break existing functionality
35
+
36
+ ### Options
37
+
38
+ | Option | Description | Example |
39
+ |--------|-------------|---------|
40
+ | `--no-test` | Skip test verification | `/quality:refactor "src/utils" --no-test` |
41
+ | `--test-level <level>` | Override enforcement level | `/quality:refactor "lib/" --test-level strict` |
42
+
43
+ ### Enforcement Levels
44
+
45
+ | Level | Test Failure After Refactor |
46
+ |-------|----------------------------|
47
+ | `soft` | Warning |
48
+ | `standard` | Block |
49
+ | `strict` | Block |
50
+
17
51
  ## Process
18
52
  1. Analyze current code
19
53
  2. Identify improvements
20
- 3. Apply refactoring
21
- 4. Verify tests pass
22
- 5. Document changes
54
+ 3. **Run existing tests** (baseline)
55
+ 4. Apply refactoring
56
+ 5. **Verify tests still pass**
57
+ 6. Document changes
58
+
59
+ ## Configuration
60
+
61
+ Configure via `.omgkit/workflow.yaml`:
62
+
63
+ ```yaml
64
+ testing:
65
+ enabled: true
66
+ enforcement:
67
+ level: standard
68
+ ```
69
+
70
+ ## Examples
71
+
72
+ ```bash
73
+ # Default: with test verification
74
+ /quality:refactor "src/services/auth.ts"
75
+
76
+ # Skip tests for simple restructuring
77
+ /quality:refactor "src/utils" --no-test
78
+
79
+ # Strict mode for critical code
80
+ /quality:refactor "src/core" --test-level strict
81
+ ```
@@ -1,29 +1,146 @@
1
1
  ---
2
- description: Run AI team on sprint tasks
2
+ description: Run AI team on sprint tasks with configurable test enforcement
3
3
  allowed-tools: Task, Read, Write, Bash, Grep, Glob
4
- argument-hint: [--mode MODE]
4
+ argument-hint: "[--mode MODE] [--no-test] [--test-level LEVEL]"
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ - methodology/test-task-generation
8
+ - omega/omega-sprint
9
+ related_commands:
10
+ - /sprint:team-status
11
+ - /quality:verify-done
12
+ - /quality:coverage-check
13
+ testing:
14
+ default: true
15
+ configurable: true
5
16
  ---
6
17
 
7
- # 🤖 Team Run
18
+ # Team Run
8
19
 
9
- Start AI team on sprint tasks.
20
+ Start AI team execution on sprint tasks with configurable test enforcement.
10
21
 
11
22
  ## Modes
12
- - `--mode full-auto` - No human intervention
13
- - `--mode semi-auto` - Review at checkpoints (default)
14
- - `--mode manual` - Approve each step
23
+
24
+ | Mode | Description | Best For |
25
+ |------|-------------|----------|
26
+ | `--mode full-auto` | No human intervention | Well-defined tasks, low risk |
27
+ | `--mode semi-auto` | Review at checkpoints (default) | Complex features, moderate risk |
28
+ | `--mode manual` | Approve each step | Critical systems, learning |
29
+
30
+ ## Testing Options
31
+
32
+ This command respects project testing configuration from `.omgkit/workflow.yaml`.
33
+
34
+ ### Default Behavior
35
+
36
+ - **Testing**: Enabled by default
37
+ - **Enforcement Level**: Read from `testing.enforcement.level` (default: standard)
38
+ - **Auto-generate Tests**: Read from `testing.auto_generate_tasks` (default: true)
39
+
40
+ ### Options
41
+
42
+ | Option | Description | Example |
43
+ |--------|-------------|---------|
44
+ | `--no-test` | Skip test enforcement (soft mode only) | `/sprint:team-run --no-test` |
45
+ | `--test-level <level>` | Override enforcement level | `/sprint:team-run --test-level strict` |
46
+ | `--with-test` | Force test enforcement | `/sprint:team-run --with-test` |
47
+
48
+ ### Enforcement Levels
49
+
50
+ | Level | Test Failure | Coverage Below Min | Missing Tests |
51
+ |-------|--------------|-------------------|---------------|
52
+ | `soft` | Warning | Warning | Warning |
53
+ | `standard` | Block | Block | Warning |
54
+ | `strict` | Block | Block | Block |
15
55
 
16
56
  ## Process
17
- 1. Load current sprint
18
- 2. Assign tasks to agents
19
- 3. Execute in priority order
20
- 4. Report progress
57
+
58
+ 1. **Load Configuration** - Read `.omgkit/workflow.yaml` testing config
59
+ 2. **Load Sprint** - Get current sprint and backlog
60
+ 3. **Generate Test Tasks** - Auto-create test tasks if enabled
61
+ 4. **Assign Tasks** - Route to appropriate agents
62
+ 5. **Execute** - Run tasks in priority order
63
+ 6. **Enforce Tests** - Block completion until tests pass (based on level)
64
+ 7. **Report** - Progress and test coverage status
21
65
 
22
66
  ## Agent Assignment
23
- | Task Type | Agent |
24
- |-----------|-------|
25
- | feature | fullstack-developer |
26
- | bugfix | debugger |
27
- | docs | docs-manager |
28
- | test | tester |
29
- | research | oracle |
67
+
68
+ | Task Type | Primary Agent | Test Agent | Auto-Generate Tests |
69
+ |-----------|---------------|------------|---------------------|
70
+ | feature | fullstack-developer | tester | Yes |
71
+ | bugfix | debugger | tester | Yes (regression) |
72
+ | refactor | fullstack-developer | tester | Yes |
73
+ | docs | docs-manager | - | No |
74
+ | test | tester | - | No |
75
+ | research | oracle | - | No |
76
+
77
+ ## Configuration
78
+
79
+ Configure via `.omgkit/workflow.yaml`:
80
+
81
+ ```yaml
82
+ testing:
83
+ enabled: true
84
+ enforcement:
85
+ level: standard # soft | standard | strict
86
+ auto_generate_tasks: true
87
+ coverage_gates:
88
+ unit:
89
+ minimum: 80
90
+ target: 90
91
+ ```
92
+
93
+ Or via CLI:
94
+
95
+ ```bash
96
+ omgkit config set testing.enforcement.level strict
97
+ omgkit config set testing.auto_generate_tasks true
98
+ ```
99
+
100
+ ## Examples
101
+
102
+ ```bash
103
+ # Default: semi-auto mode with standard test enforcement
104
+ /sprint:team-run
105
+
106
+ # Full auto with strict test enforcement
107
+ /sprint:team-run --mode full-auto --test-level strict
108
+
109
+ # Quick run without test enforcement (soft mode required)
110
+ /sprint:team-run --no-test
111
+
112
+ # Manual mode with high coverage requirement
113
+ /sprint:team-run --mode manual --test-level strict
114
+ ```
115
+
116
+ ## Test Task Generation
117
+
118
+ When `auto_generate_tasks: true`, for each feature task:
119
+
120
+ ```
121
+ TASK-042: Implement user authentication
122
+ ↓ Auto-generates:
123
+ TEST-042-UNIT: Unit tests for auth service
124
+ TEST-042-INT: Integration tests for auth flow
125
+ TEST-042-SEC: Security tests (if auth feature)
126
+ ```
127
+
128
+ ## Definition of Done
129
+
130
+ Before marking ANY task as DONE, team verifies:
131
+
132
+ ```
133
+ DEFINITION OF DONE CHECKLIST:
134
+ ├── Code
135
+ │ ├── [x] Implementation complete
136
+ │ ├── [x] Code review passed
137
+ │ └── [x] No lint errors
138
+
139
+ ├── Tests (MANDATORY when enabled)
140
+ │ ├── [x] Test tasks created
141
+ │ ├── [x] All tests passing
142
+ │ ├── [x] Coverage ≥ minimum threshold
143
+ │ └── [x] No skipped critical tests
144
+
145
+ └── Ready for merge
146
+ ```
@@ -1,9 +1,9 @@
1
1
  # OMGKIT Component Registry
2
2
  # Single Source of Truth for Agents, Skills, Commands, Workflows, and MCPs
3
- # Version: 2.25.1
3
+ # Version: 2.26.0
4
4
  # Updated: 2026-01-06
5
5
 
6
- version: "2.25.1"
6
+ version: "2.26.0"
7
7
 
8
8
  # =============================================================================
9
9
  # OPTIMIZED ALIGNMENT PRINCIPLE (OAP)
@@ -1,6 +1,17 @@
1
1
  ---
2
2
  name: developing-test-driven
3
3
  description: AI agent practices test-first development with the Red-Green-Refactor cycle for confident, well-designed code. Use when implementing features, fixing bugs, or establishing testing practices.
4
+ category: methodology
5
+ related_skills:
6
+ - methodology/test-enforcement
7
+ - methodology/test-task-generation
8
+ - testing/vitest
9
+ - testing/pytest
10
+ related_commands:
11
+ - /dev:tdd
12
+ - /dev:feature-tested
13
+ - /dev:test-write
14
+ - /quality:verify-done
4
15
  ---
5
16
 
6
17
  # Developing Test-Driven
@@ -125,9 +136,39 @@ REMEMBER: 100% coverage != well-tested
125
136
  | Keep cycles short (1-5 minutes) | 30+ minute cycles |
126
137
  | Mock only external dependencies | Over-mocking your own code |
127
138
 
139
+ ## Command Integration
140
+
141
+ ### Using TDD Command
142
+
143
+ ```bash
144
+ # Start TDD workflow
145
+ /dev:tdd "user authentication"
146
+
147
+ # TDD with specific coverage
148
+ /dev:tdd "payment processing" --coverage 95
149
+
150
+ # TDD with specific test types
151
+ /dev:tdd "API endpoint" --test-types unit,integration,contract
152
+ ```
153
+
154
+ ### Configuration
155
+
156
+ ```yaml
157
+ # .omgkit/workflow.yaml
158
+ testing:
159
+ enabled: true
160
+ enforcement:
161
+ level: strict # TDD recommends strict
162
+ coverage_gates:
163
+ unit:
164
+ minimum: 90
165
+ target: 95
166
+ ```
167
+
128
168
  ## Related Skills
129
169
 
130
- - `avoiding-testing-anti-patterns` - Avoid common test mistakes
131
- - `testing-with-vitest` - Vitest testing framework
132
- - `testing-with-playwright` - E2E testing with Playwright
133
- - `verifying-before-completion` - Ensure test quality
170
+ - `methodology/test-enforcement` - Enforce test completion
171
+ - `methodology/test-task-generation` - Auto-generate test tasks
172
+ - `methodology/testing-anti-patterns` - Avoid common test mistakes
173
+ - `testing/vitest` - Vitest testing framework
174
+ - `testing/playwright` - E2E testing with Playwright
@@ -11,6 +11,10 @@ related_commands:
11
11
  - /quality:verify-done
12
12
  - /quality:coverage-check
13
13
  - /dev:feature-tested
14
+ - /dev:feature
15
+ - /dev:fix
16
+ - /dev:fix-hard
17
+ - /sprint:team-run
14
18
  ---
15
19
 
16
20
  # Test Enforcement
@@ -52,9 +56,12 @@ Definition of Done:
52
56
 
53
57
  ## Configuration
54
58
 
59
+ ### Via workflow.yaml
60
+
55
61
  ```yaml
56
62
  # .omgkit/workflow.yaml
57
63
  testing:
64
+ enabled: true
58
65
  enforcement:
59
66
  level: standard # soft | standard | strict
60
67
 
@@ -88,6 +95,32 @@ testing:
88
95
  log_all_overrides: true
89
96
  ```
90
97
 
98
+ ### Via CLI
99
+
100
+ ```bash
101
+ # Set enforcement level
102
+ omgkit config set testing.enforcement.level strict
103
+
104
+ # View current configuration
105
+ omgkit config get testing.enforcement.level
106
+
107
+ # List all testing config
108
+ omgkit config list testing
109
+ ```
110
+
111
+ ### Via Command Options
112
+
113
+ Commands support per-invocation overrides:
114
+
115
+ | Option | Description | Example |
116
+ |--------|-------------|---------|
117
+ | `--no-test` | Skip test enforcement | `/dev:fix "typo" --no-test` |
118
+ | `--with-test` | Force test enforcement | `/dev:fix-fast "bug" --with-test` |
119
+ | `--test-level <level>` | Override enforcement level | `/dev:feature "auth" --test-level strict` |
120
+ | `--coverage <percent>` | Override coverage minimum | `/dev:feature "api" --coverage 95` |
121
+
122
+ **Note:** `--no-test` requires `soft` enforcement level or explicit config override.
123
+
91
124
  ## Pre-Completion Checklist
92
125
 
93
126
  ### Mandatory Checks (Cannot Override)