omgkit 1.0.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.
- package/LICENSE +21 -0
- package/README.md +252 -0
- package/bin/omgkit.js +122 -0
- package/lib/.gitkeep +0 -0
- package/lib/cli.js +513 -0
- package/lib/index.js +35 -0
- package/package.json +52 -0
- package/plugin/.claude-plugin/.gitkeep +0 -0
- package/plugin/.claude-plugin/plugin.json +11 -0
- package/plugin/agents/.gitkeep +0 -0
- package/plugin/agents/api-designer.md +66 -0
- package/plugin/agents/architect.md +81 -0
- package/plugin/agents/brainstormer.md +60 -0
- package/plugin/agents/cicd-manager.md +50 -0
- package/plugin/agents/code-reviewer.md +45 -0
- package/plugin/agents/copywriter.md +48 -0
- package/plugin/agents/database-admin.md +49 -0
- package/plugin/agents/debugger.md +55 -0
- package/plugin/agents/docs-manager.md +52 -0
- package/plugin/agents/fullstack-developer.md +67 -0
- package/plugin/agents/git-manager.md +48 -0
- package/plugin/agents/journal-writer.md +51 -0
- package/plugin/agents/oracle.md +91 -0
- package/plugin/agents/pipeline-architect.md +52 -0
- package/plugin/agents/planner.md +60 -0
- package/plugin/agents/project-manager.md +43 -0
- package/plugin/agents/researcher.md +37 -0
- package/plugin/agents/scout.md +37 -0
- package/plugin/agents/security-auditor.md +53 -0
- package/plugin/agents/sprint-master.md +84 -0
- package/plugin/agents/tester.md +50 -0
- package/plugin/agents/ui-ux-designer.md +61 -0
- package/plugin/agents/vulnerability-scanner.md +53 -0
- package/plugin/commands/context/.gitkeep +0 -0
- package/plugin/commands/context/checkpoint.md +20 -0
- package/plugin/commands/context/index.md +17 -0
- package/plugin/commands/context/load.md +16 -0
- package/plugin/commands/context/mode.md +20 -0
- package/plugin/commands/context/spawn-collect.md +14 -0
- package/plugin/commands/context/spawn.md +20 -0
- package/plugin/commands/design/.gitkeep +0 -0
- package/plugin/commands/design/cro.md +27 -0
- package/plugin/commands/design/enhance.md +16 -0
- package/plugin/commands/design/fast.md +17 -0
- package/plugin/commands/design/good.md +23 -0
- package/plugin/commands/design/screenshot.md +21 -0
- package/plugin/commands/dev/.gitkeep +0 -0
- package/plugin/commands/dev/feature.md +25 -0
- package/plugin/commands/dev/fix-ci.md +23 -0
- package/plugin/commands/dev/fix-fast.md +19 -0
- package/plugin/commands/dev/fix-hard.md +25 -0
- package/plugin/commands/dev/fix-logs.md +21 -0
- package/plugin/commands/dev/fix-test.md +23 -0
- package/plugin/commands/dev/fix.md +22 -0
- package/plugin/commands/dev/review.md +31 -0
- package/plugin/commands/dev/tdd.md +29 -0
- package/plugin/commands/dev/test.md +25 -0
- package/plugin/commands/git/.gitkeep +0 -0
- package/plugin/commands/git/cm.md +13 -0
- package/plugin/commands/git/commit.md +31 -0
- package/plugin/commands/git/cp.md +14 -0
- package/plugin/commands/git/deploy.md +21 -0
- package/plugin/commands/git/pr.md +20 -0
- package/plugin/commands/git/ship.md +29 -0
- package/plugin/commands/omega/.gitkeep +0 -0
- package/plugin/commands/omega/1000x.md +41 -0
- package/plugin/commands/omega/100x.md +39 -0
- package/plugin/commands/omega/10x.md +47 -0
- package/plugin/commands/omega/dimensions.md +26 -0
- package/plugin/commands/omega/principles.md +43 -0
- package/plugin/commands/planning/.gitkeep +0 -0
- package/plugin/commands/planning/ask.md +21 -0
- package/plugin/commands/planning/brainstorm.md +33 -0
- package/plugin/commands/planning/doc.md +28 -0
- package/plugin/commands/planning/execute-plan.md +28 -0
- package/plugin/commands/planning/plan-detailed.md +32 -0
- package/plugin/commands/planning/plan-parallel.md +35 -0
- package/plugin/commands/planning/plan.md +39 -0
- package/plugin/commands/planning/research.md +39 -0
- package/plugin/commands/quality/.gitkeep +0 -0
- package/plugin/commands/quality/api-gen.md +25 -0
- package/plugin/commands/quality/lint.md +15 -0
- package/plugin/commands/quality/optimize.md +23 -0
- package/plugin/commands/quality/refactor.md +22 -0
- package/plugin/commands/quality/security-scan.md +28 -0
- package/plugin/commands/sprint/.gitkeep +0 -0
- package/plugin/commands/sprint/backlog-add.md +21 -0
- package/plugin/commands/sprint/backlog-prioritize.md +18 -0
- package/plugin/commands/sprint/backlog-show.md +25 -0
- package/plugin/commands/sprint/init.md +27 -0
- package/plugin/commands/sprint/sprint-current.md +22 -0
- package/plugin/commands/sprint/sprint-end.md +33 -0
- package/plugin/commands/sprint/sprint-new.md +31 -0
- package/plugin/commands/sprint/sprint-start.md +17 -0
- package/plugin/commands/sprint/team-ask.md +21 -0
- package/plugin/commands/sprint/team-run.md +29 -0
- package/plugin/commands/sprint/team-status.md +23 -0
- package/plugin/commands/sprint/vision-set.md +21 -0
- package/plugin/commands/sprint/vision-show.md +15 -0
- package/plugin/mcp/.gitkeep +0 -0
- package/plugin/mcp/.mcp.json +20 -0
- package/plugin/mcp/README.md +68 -0
- package/plugin/modes/.gitkeep +0 -0
- package/plugin/modes/autonomous.md +48 -0
- package/plugin/modes/brainstorm.md +33 -0
- package/plugin/modes/deep-research.md +41 -0
- package/plugin/modes/default.md +25 -0
- package/plugin/modes/implementation.md +35 -0
- package/plugin/modes/omega.md +38 -0
- package/plugin/modes/orchestration.md +41 -0
- package/plugin/modes/review.md +44 -0
- package/plugin/modes/token-efficient.md +37 -0
- package/plugin/skills/databases/.gitkeep +0 -0
- package/plugin/skills/databases/mongodb/SKILL.md +43 -0
- package/plugin/skills/databases/postgresql/SKILL.md +43 -0
- package/plugin/skills/databases/prisma/SKILL.md +55 -0
- package/plugin/skills/databases/redis/SKILL.md +41 -0
- package/plugin/skills/devops/.gitkeep +0 -0
- package/plugin/skills/devops/aws/SKILL.md +51 -0
- package/plugin/skills/devops/docker/SKILL.md +54 -0
- package/plugin/skills/devops/github-actions/SKILL.md +63 -0
- package/plugin/skills/devops/kubernetes/SKILL.md +64 -0
- package/plugin/skills/frameworks/.gitkeep +0 -0
- package/plugin/skills/frameworks/django/SKILL.md +47 -0
- package/plugin/skills/frameworks/express/SKILL.md +55 -0
- package/plugin/skills/frameworks/fastapi/SKILL.md +58 -0
- package/plugin/skills/frameworks/laravel/SKILL.md +65 -0
- package/plugin/skills/frameworks/nestjs/SKILL.md +67 -0
- package/plugin/skills/frameworks/nextjs/SKILL.md +77 -0
- package/plugin/skills/frameworks/rails/SKILL.md +56 -0
- package/plugin/skills/frameworks/react/SKILL.md +61 -0
- package/plugin/skills/frameworks/spring/SKILL.md +70 -0
- package/plugin/skills/frameworks/vue/SKILL.md +62 -0
- package/plugin/skills/frontend/.gitkeep +0 -0
- package/plugin/skills/frontend/accessibility/SKILL.md +52 -0
- package/plugin/skills/frontend/frontend-design/SKILL.md +47 -0
- package/plugin/skills/frontend/responsive/SKILL.md +46 -0
- package/plugin/skills/frontend/shadcn-ui/SKILL.md +58 -0
- package/plugin/skills/frontend/tailwindcss/SKILL.md +52 -0
- package/plugin/skills/frontend/threejs/SKILL.md +59 -0
- package/plugin/skills/languages/.gitkeep +0 -0
- package/plugin/skills/languages/javascript/SKILL.md +62 -0
- package/plugin/skills/languages/python/SKILL.md +63 -0
- package/plugin/skills/languages/typescript/SKILL.md +66 -0
- package/plugin/skills/methodology/.gitkeep +0 -0
- package/plugin/skills/methodology/brainstorming/SKILL.md +34 -0
- package/plugin/skills/methodology/defense-in-depth/SKILL.md +51 -0
- package/plugin/skills/methodology/dispatching-parallel-agents/SKILL.md +43 -0
- package/plugin/skills/methodology/executing-plans/SKILL.md +34 -0
- package/plugin/skills/methodology/finishing-development-branch/SKILL.md +41 -0
- package/plugin/skills/methodology/receiving-code-review/SKILL.md +41 -0
- package/plugin/skills/methodology/requesting-code-review/SKILL.md +38 -0
- package/plugin/skills/methodology/root-cause-tracing/SKILL.md +53 -0
- package/plugin/skills/methodology/systematic-debugging/SKILL.md +50 -0
- package/plugin/skills/methodology/test-driven-development/SKILL.md +39 -0
- package/plugin/skills/methodology/testing-anti-patterns/SKILL.md +50 -0
- package/plugin/skills/methodology/token-optimization/SKILL.md +51 -0
- package/plugin/skills/methodology/verification-before-completion/SKILL.md +32 -0
- package/plugin/skills/methodology/writing-plans/SKILL.md +34 -0
- package/plugin/skills/omega/.gitkeep +0 -0
- package/plugin/skills/omega/omega-architecture/SKILL.md +59 -0
- package/plugin/skills/omega/omega-coding/SKILL.md +61 -0
- package/plugin/skills/omega/omega-sprint/SKILL.md +64 -0
- package/plugin/skills/omega/omega-testing/SKILL.md +71 -0
- package/plugin/skills/omega/omega-thinking/SKILL.md +54 -0
- package/plugin/skills/security/.gitkeep +0 -0
- package/plugin/skills/security/better-auth/SKILL.md +53 -0
- package/plugin/skills/security/oauth/SKILL.md +50 -0
- package/plugin/skills/security/owasp/SKILL.md +57 -0
- package/plugin/skills/testing/.gitkeep +0 -0
- package/plugin/skills/testing/playwright/SKILL.md +60 -0
- package/plugin/skills/testing/pytest/SKILL.md +58 -0
- package/plugin/skills/testing/vitest/SKILL.md +64 -0
- package/templates/.gitkeep +0 -0
- package/templates/OMEGA.md +80 -0
- package/templates/backlog.yaml +25 -0
- package/templates/config.yaml +44 -0
- package/templates/settings.json +20 -0
- package/templates/vision.yaml +30 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: defense-in-depth
|
|
3
|
+
description: Security defense in depth. Use when designing secure systems.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Defense in Depth Skill
|
|
7
|
+
|
|
8
|
+
## Layers
|
|
9
|
+
|
|
10
|
+
### 1. Perimeter
|
|
11
|
+
- Firewall
|
|
12
|
+
- Rate limiting
|
|
13
|
+
- WAF
|
|
14
|
+
|
|
15
|
+
### 2. Network
|
|
16
|
+
- VPC
|
|
17
|
+
- Security groups
|
|
18
|
+
- TLS everywhere
|
|
19
|
+
|
|
20
|
+
### 3. Application
|
|
21
|
+
- Input validation
|
|
22
|
+
- Output encoding
|
|
23
|
+
- CSRF protection
|
|
24
|
+
|
|
25
|
+
### 4. Data
|
|
26
|
+
- Encryption at rest
|
|
27
|
+
- Encryption in transit
|
|
28
|
+
- Access control
|
|
29
|
+
|
|
30
|
+
### 5. Monitoring
|
|
31
|
+
- Logging
|
|
32
|
+
- Alerting
|
|
33
|
+
- Audit trails
|
|
34
|
+
|
|
35
|
+
## Principle
|
|
36
|
+
> If one layer fails, others protect.
|
|
37
|
+
|
|
38
|
+
## Implementation
|
|
39
|
+
```typescript
|
|
40
|
+
// Layer 1: Rate limiting
|
|
41
|
+
app.use(rateLimit({ max: 100 }));
|
|
42
|
+
|
|
43
|
+
// Layer 2: Input validation
|
|
44
|
+
const validated = schema.parse(input);
|
|
45
|
+
|
|
46
|
+
// Layer 3: Parameterized query
|
|
47
|
+
db.query('SELECT * FROM users WHERE id = $1', [id]);
|
|
48
|
+
|
|
49
|
+
// Layer 4: Output encoding
|
|
50
|
+
res.json(sanitize(data));
|
|
51
|
+
```
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dispatching-parallel-agents
|
|
3
|
+
description: Parallel agent execution. Use when tasks can run concurrently.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Dispatching Parallel Agents Skill
|
|
7
|
+
|
|
8
|
+
## When to Parallelize
|
|
9
|
+
- Independent tasks
|
|
10
|
+
- No shared state
|
|
11
|
+
- Different file scopes
|
|
12
|
+
- Research + implementation
|
|
13
|
+
|
|
14
|
+
## Pattern
|
|
15
|
+
```
|
|
16
|
+
┌─────────────────────────────────────┐
|
|
17
|
+
│ Main Agent │
|
|
18
|
+
└──────────────┬──────────────────────┘
|
|
19
|
+
│
|
|
20
|
+
┌──────────┼──────────┐
|
|
21
|
+
▼ ▼ ▼
|
|
22
|
+
┌───────┐ ┌───────┐ ┌───────┐
|
|
23
|
+
│Agent A│ │Agent B│ │Agent C│
|
|
24
|
+
│(task1)│ │(task2)│ │(task3)│
|
|
25
|
+
└───────┘ └───────┘ └───────┘
|
|
26
|
+
│ │ │
|
|
27
|
+
└──────────┼──────────┘
|
|
28
|
+
▼
|
|
29
|
+
[Aggregate Results]
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Commands
|
|
33
|
+
```bash
|
|
34
|
+
/spawn "Research authentication options"
|
|
35
|
+
/spawn "Write tests for user module"
|
|
36
|
+
/spawn:collect
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Best Practices
|
|
40
|
+
- Clear task boundaries
|
|
41
|
+
- Define sync points
|
|
42
|
+
- Aggregate results
|
|
43
|
+
- Handle failures
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: executing-plans
|
|
3
|
+
description: Executing implementation plans. Use when implementing from a plan.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Executing Plans Skill
|
|
7
|
+
|
|
8
|
+
## Process
|
|
9
|
+
1. Read the plan completely
|
|
10
|
+
2. Verify understanding
|
|
11
|
+
3. Execute tasks in order
|
|
12
|
+
4. Check off completed tasks
|
|
13
|
+
5. Report blockers immediately
|
|
14
|
+
|
|
15
|
+
## Per Task
|
|
16
|
+
1. Read task description
|
|
17
|
+
2. Navigate to code location
|
|
18
|
+
3. Implement change
|
|
19
|
+
4. Verify it works
|
|
20
|
+
5. Mark complete
|
|
21
|
+
6. Proceed to next
|
|
22
|
+
|
|
23
|
+
## Quality Gates
|
|
24
|
+
- After each task: Does it work?
|
|
25
|
+
- After each phase: Run tests
|
|
26
|
+
- After completion: Full verification
|
|
27
|
+
|
|
28
|
+
## Reporting
|
|
29
|
+
```markdown
|
|
30
|
+
## Progress Update
|
|
31
|
+
- Completed: 5/10 tasks
|
|
32
|
+
- Current: Task 6 - [description]
|
|
33
|
+
- Blockers: [None | Description]
|
|
34
|
+
```
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: finishing-development-branch
|
|
3
|
+
description: Completing a development branch. Use when wrapping up feature work.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Finishing Development Branch Skill
|
|
7
|
+
|
|
8
|
+
## Checklist
|
|
9
|
+
|
|
10
|
+
### Code Complete
|
|
11
|
+
- [ ] All tasks done
|
|
12
|
+
- [ ] Tests written
|
|
13
|
+
- [ ] Docs updated
|
|
14
|
+
- [ ] No TODOs left
|
|
15
|
+
|
|
16
|
+
### Quality
|
|
17
|
+
- [ ] Tests passing
|
|
18
|
+
- [ ] Lint passing
|
|
19
|
+
- [ ] Type check passing
|
|
20
|
+
- [ ] Self-reviewed
|
|
21
|
+
|
|
22
|
+
### Git
|
|
23
|
+
- [ ] Clean commit history
|
|
24
|
+
- [ ] Meaningful messages
|
|
25
|
+
- [ ] Rebased on main
|
|
26
|
+
- [ ] No merge conflicts
|
|
27
|
+
|
|
28
|
+
### PR
|
|
29
|
+
- [ ] Description complete
|
|
30
|
+
- [ ] Reviewers assigned
|
|
31
|
+
- [ ] Labels added
|
|
32
|
+
|
|
33
|
+
## Final Steps
|
|
34
|
+
```bash
|
|
35
|
+
git fetch origin main
|
|
36
|
+
git rebase origin/main
|
|
37
|
+
npm test
|
|
38
|
+
npm run build
|
|
39
|
+
git push origin feature-branch
|
|
40
|
+
gh pr create
|
|
41
|
+
```
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiving-code-review
|
|
3
|
+
description: Receiving code review feedback. Use when handling review comments.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Receiving Code Review Skill
|
|
7
|
+
|
|
8
|
+
## Mindset
|
|
9
|
+
- Feedback is about code, not you
|
|
10
|
+
- Reviewers want to help
|
|
11
|
+
- Every comment is an opportunity
|
|
12
|
+
|
|
13
|
+
## Response Types
|
|
14
|
+
|
|
15
|
+
### Agree
|
|
16
|
+
```
|
|
17
|
+
Good catch! Fixed in abc123.
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### Discuss
|
|
21
|
+
```
|
|
22
|
+
I considered that, but chose X because [reason].
|
|
23
|
+
What do you think about [alternative]?
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Clarify
|
|
27
|
+
```
|
|
28
|
+
Could you elaborate on [specific point]?
|
|
29
|
+
I want to make sure I understand.
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Process
|
|
33
|
+
1. Read all comments first
|
|
34
|
+
2. Address each comment
|
|
35
|
+
3. Mark resolved when fixed
|
|
36
|
+
4. Re-request review
|
|
37
|
+
|
|
38
|
+
## Anti-Patterns
|
|
39
|
+
- Defensive reactions
|
|
40
|
+
- Ignoring comments
|
|
41
|
+
- Changing without acknowledgment
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: requesting-code-review
|
|
3
|
+
description: Requesting code reviews. Use when submitting code for review.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Requesting Code Review Skill
|
|
7
|
+
|
|
8
|
+
## Before Requesting
|
|
9
|
+
- [ ] Tests pass
|
|
10
|
+
- [ ] Self-reviewed
|
|
11
|
+
- [ ] No debug code
|
|
12
|
+
- [ ] Docs updated
|
|
13
|
+
|
|
14
|
+
## PR Description
|
|
15
|
+
```markdown
|
|
16
|
+
## Summary
|
|
17
|
+
[What changed and why]
|
|
18
|
+
|
|
19
|
+
## Changes
|
|
20
|
+
- [Specific change 1]
|
|
21
|
+
- [Specific change 2]
|
|
22
|
+
|
|
23
|
+
## Testing
|
|
24
|
+
- [ ] Unit tests added
|
|
25
|
+
- [ ] Manual testing done
|
|
26
|
+
|
|
27
|
+
## Screenshots
|
|
28
|
+
[If UI changes]
|
|
29
|
+
|
|
30
|
+
## Questions
|
|
31
|
+
[Specific areas needing review]
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Best Practices
|
|
35
|
+
- Keep PRs small (<400 lines)
|
|
36
|
+
- One concern per PR
|
|
37
|
+
- Descriptive commit messages
|
|
38
|
+
- Respond to feedback promptly
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: root-cause-tracing
|
|
3
|
+
description: Finding root causes. Use when debugging complex issues.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Root Cause Tracing Skill
|
|
7
|
+
|
|
8
|
+
## 5 Whys
|
|
9
|
+
```
|
|
10
|
+
Problem: App crashed
|
|
11
|
+
Why? → Out of memory
|
|
12
|
+
Why? → Memory leak
|
|
13
|
+
Why? → Event listeners not cleaned
|
|
14
|
+
Why? → Missing cleanup in useEffect
|
|
15
|
+
Why? → Developer unaware of cleanup pattern
|
|
16
|
+
Root: Training/documentation gap
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Fishbone Diagram
|
|
20
|
+
```
|
|
21
|
+
┌─ Code
|
|
22
|
+
├─ Config
|
|
23
|
+
Problem ────────────├─ Environment
|
|
24
|
+
├─ Data
|
|
25
|
+
└─ Dependencies
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Categories
|
|
29
|
+
1. **Code** - Bug in logic
|
|
30
|
+
2. **Data** - Invalid input
|
|
31
|
+
3. **Config** - Wrong settings
|
|
32
|
+
4. **Environment** - System issues
|
|
33
|
+
5. **External** - Third-party failure
|
|
34
|
+
|
|
35
|
+
## Output
|
|
36
|
+
```markdown
|
|
37
|
+
## Root Cause Analysis
|
|
38
|
+
|
|
39
|
+
### Symptom
|
|
40
|
+
[What was observed]
|
|
41
|
+
|
|
42
|
+
### Proximate Cause
|
|
43
|
+
[Immediate cause]
|
|
44
|
+
|
|
45
|
+
### Root Cause
|
|
46
|
+
[Underlying reason]
|
|
47
|
+
|
|
48
|
+
### Systemic Factors
|
|
49
|
+
[Why it wasn't caught]
|
|
50
|
+
|
|
51
|
+
### Prevention
|
|
52
|
+
[How to prevent recurrence]
|
|
53
|
+
```
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: systematic-debugging
|
|
3
|
+
description: Systematic debugging process. Use when investigating bugs.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Systematic Debugging Skill
|
|
7
|
+
|
|
8
|
+
## Process
|
|
9
|
+
|
|
10
|
+
### 1. Reproduce
|
|
11
|
+
- Can you reproduce consistently?
|
|
12
|
+
- What are the exact steps?
|
|
13
|
+
- What environment?
|
|
14
|
+
|
|
15
|
+
### 2. Isolate
|
|
16
|
+
- What's the smallest case?
|
|
17
|
+
- Which component fails?
|
|
18
|
+
- When did it start?
|
|
19
|
+
|
|
20
|
+
### 3. Hypothesize
|
|
21
|
+
Form 3 hypotheses:
|
|
22
|
+
1. [Most likely cause]
|
|
23
|
+
2. [Second possibility]
|
|
24
|
+
3. [Unlikely but possible]
|
|
25
|
+
|
|
26
|
+
### 4. Test
|
|
27
|
+
- Test each hypothesis
|
|
28
|
+
- Use binary search for large codebases
|
|
29
|
+
- Add logging strategically
|
|
30
|
+
|
|
31
|
+
### 5. Fix
|
|
32
|
+
- Minimal fix first
|
|
33
|
+
- Add regression test
|
|
34
|
+
- Verify fix works
|
|
35
|
+
|
|
36
|
+
## Tools
|
|
37
|
+
```bash
|
|
38
|
+
git bisect start
|
|
39
|
+
git bisect bad HEAD
|
|
40
|
+
git bisect good v1.0.0
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Output
|
|
44
|
+
```markdown
|
|
45
|
+
## Debug Report
|
|
46
|
+
- Problem: [Description]
|
|
47
|
+
- Root Cause: [Actual cause]
|
|
48
|
+
- Fix: [What changed]
|
|
49
|
+
- Prevention: [How to prevent]
|
|
50
|
+
```
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: test-driven-development
|
|
3
|
+
description: TDD workflow. Use when implementing features with test-first approach.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Test-Driven Development Skill
|
|
7
|
+
|
|
8
|
+
## TDD Cycle
|
|
9
|
+
1. 🔴 **RED** - Write failing test
|
|
10
|
+
2. 🟢 **GREEN** - Make it pass (minimal code)
|
|
11
|
+
3. ♻️ **REFACTOR** - Improve code
|
|
12
|
+
|
|
13
|
+
## Rules
|
|
14
|
+
- No production code without failing test
|
|
15
|
+
- Only enough code to pass test
|
|
16
|
+
- Refactor only when green
|
|
17
|
+
- One assertion per test
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
```typescript
|
|
21
|
+
// 1. RED - Write test first
|
|
22
|
+
describe('calculateTax', () => {
|
|
23
|
+
it('calculates 10% tax', () => {
|
|
24
|
+
expect(calculateTax(100, 0.1)).toBe(10);
|
|
25
|
+
});
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
// 2. GREEN - Minimal implementation
|
|
29
|
+
function calculateTax(amount: number, rate: number) {
|
|
30
|
+
return amount * rate;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// 3. REFACTOR if needed
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Benefits
|
|
37
|
+
- Design emerges from tests
|
|
38
|
+
- 100% coverage by default
|
|
39
|
+
- Confidence in refactoring
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: testing-anti-patterns
|
|
3
|
+
description: Testing anti-patterns to avoid. Use when writing or reviewing tests.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Testing Anti-Patterns Skill
|
|
7
|
+
|
|
8
|
+
## Anti-Patterns
|
|
9
|
+
|
|
10
|
+
### 1. Testing Implementation
|
|
11
|
+
```typescript
|
|
12
|
+
// Bad - tests internal implementation
|
|
13
|
+
expect(component.state.count).toBe(1);
|
|
14
|
+
|
|
15
|
+
// Good - tests behavior
|
|
16
|
+
expect(screen.getByText('1')).toBeInTheDocument();
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### 2. Flaky Tests
|
|
20
|
+
```typescript
|
|
21
|
+
// Bad - timing dependent
|
|
22
|
+
await sleep(1000);
|
|
23
|
+
expect(result).toBe(true);
|
|
24
|
+
|
|
25
|
+
// Good - wait for condition
|
|
26
|
+
await waitFor(() => expect(result).toBe(true));
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### 3. Test Interdependence
|
|
30
|
+
```typescript
|
|
31
|
+
// Bad - tests share state
|
|
32
|
+
let user;
|
|
33
|
+
it('creates user', () => { user = create(); });
|
|
34
|
+
it('uses user', () => { expect(user).toBe(...); });
|
|
35
|
+
|
|
36
|
+
// Good - independent tests
|
|
37
|
+
beforeEach(() => { user = create(); });
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### 4. Overmocking
|
|
41
|
+
```typescript
|
|
42
|
+
// Bad - mock everything
|
|
43
|
+
// Good - use real implementations when practical
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Guidelines
|
|
47
|
+
- Test behavior, not implementation
|
|
48
|
+
- Keep tests independent
|
|
49
|
+
- Mock only external dependencies
|
|
50
|
+
- Use realistic test data
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: token-optimization
|
|
3
|
+
description: Token/cost optimization. Use for efficient AI interactions.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Token Optimization Skill
|
|
7
|
+
|
|
8
|
+
## Strategies
|
|
9
|
+
|
|
10
|
+
### 1. Concise Prompts
|
|
11
|
+
```
|
|
12
|
+
# Bad
|
|
13
|
+
Can you please help me understand what this function does
|
|
14
|
+
and explain it in detail with examples?
|
|
15
|
+
|
|
16
|
+
# Good
|
|
17
|
+
Explain this function briefly.
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### 2. Targeted Reading
|
|
21
|
+
```
|
|
22
|
+
# Bad
|
|
23
|
+
Read("entire-large-file.ts")
|
|
24
|
+
|
|
25
|
+
# Good
|
|
26
|
+
Read("file.ts", { offset: 50, limit: 30 })
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### 3. Efficient Searches
|
|
30
|
+
```
|
|
31
|
+
# Bad
|
|
32
|
+
Grep(".*") in all files
|
|
33
|
+
|
|
34
|
+
# Good
|
|
35
|
+
Grep("specificPattern", { path: "src/", glob: "*.ts" })
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### 4. Batch Operations
|
|
39
|
+
```
|
|
40
|
+
# Bad
|
|
41
|
+
Multiple separate tool calls
|
|
42
|
+
|
|
43
|
+
# Good
|
|
44
|
+
Combined operations in one call
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Savings
|
|
48
|
+
- 30-70% reduction possible
|
|
49
|
+
- Focus on high-value output
|
|
50
|
+
- Minimize unnecessary context
|
|
51
|
+
- Use token-efficient mode
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verification-before-completion
|
|
3
|
+
description: Evidence-based verification. Use before marking tasks complete.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Verification Before Completion Skill
|
|
7
|
+
|
|
8
|
+
## Checklist
|
|
9
|
+
Before marking complete:
|
|
10
|
+
|
|
11
|
+
- [ ] **Tests pass** - All tests green
|
|
12
|
+
- [ ] **Manual test** - Verified manually
|
|
13
|
+
- [ ] **Edge cases** - Considered and handled
|
|
14
|
+
- [ ] **Errors** - Error handling works
|
|
15
|
+
- [ ] **Types** - No type errors
|
|
16
|
+
- [ ] **Lint** - No lint errors
|
|
17
|
+
|
|
18
|
+
## Verification Steps
|
|
19
|
+
1. Run full test suite
|
|
20
|
+
2. Test happy path manually
|
|
21
|
+
3. Test error cases
|
|
22
|
+
4. Check type safety
|
|
23
|
+
5. Verify in production-like env
|
|
24
|
+
|
|
25
|
+
## Evidence
|
|
26
|
+
Document verification:
|
|
27
|
+
```markdown
|
|
28
|
+
## Verification
|
|
29
|
+
- Tests: ✅ 45 passed
|
|
30
|
+
- Manual: ✅ Tested [scenario]
|
|
31
|
+
- Edge cases: ✅ Handled [case]
|
|
32
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: writing-plans
|
|
3
|
+
description: Writing implementation plans. Use when planning features or tasks.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Writing Plans Skill
|
|
7
|
+
|
|
8
|
+
## Plan Structure
|
|
9
|
+
```markdown
|
|
10
|
+
# Plan: [Feature Name]
|
|
11
|
+
|
|
12
|
+
## Overview
|
|
13
|
+
[1-2 sentence description]
|
|
14
|
+
|
|
15
|
+
## Tasks
|
|
16
|
+
1. [ ] [Task] - [2-5 min] - `path/file.ts:line`
|
|
17
|
+
2. [ ] [Task] - [2-5 min] - `path/file.ts:line`
|
|
18
|
+
|
|
19
|
+
## Files to Modify
|
|
20
|
+
- `src/file.ts` - [What changes]
|
|
21
|
+
|
|
22
|
+
## Testing Strategy
|
|
23
|
+
- Unit: [What to test]
|
|
24
|
+
- Integration: [What flows]
|
|
25
|
+
|
|
26
|
+
## Risks
|
|
27
|
+
| Risk | Likelihood | Impact | Mitigation |
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Guidelines
|
|
31
|
+
- Each task: 2-5 minutes
|
|
32
|
+
- Include exact file locations
|
|
33
|
+
- Identify dependencies
|
|
34
|
+
- Note testing requirements
|
|
File without changes
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: omega-architecture
|
|
3
|
+
description: Omega system architecture. Use for designing scalable systems.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Omega Architecture Skill
|
|
7
|
+
|
|
8
|
+
## 7 Omega Principles Applied
|
|
9
|
+
|
|
10
|
+
### Ω1. Leverage Multiplication
|
|
11
|
+
- Build systems, not features
|
|
12
|
+
- Automate everything
|
|
13
|
+
- Create multipliers
|
|
14
|
+
|
|
15
|
+
### Ω2. Transcendent Abstraction
|
|
16
|
+
- Solve the class, not instance
|
|
17
|
+
- Find patterns behind patterns
|
|
18
|
+
- Build frameworks
|
|
19
|
+
|
|
20
|
+
### Ω3. Agentic Decomposition
|
|
21
|
+
- Specialist components
|
|
22
|
+
- Clear interfaces
|
|
23
|
+
- Autonomous operation
|
|
24
|
+
|
|
25
|
+
### Ω5. Zero-Marginal-Cost Scaling
|
|
26
|
+
- No per-unit cost
|
|
27
|
+
- Horizontal scaling
|
|
28
|
+
- Platform thinking
|
|
29
|
+
|
|
30
|
+
## Architecture Patterns
|
|
31
|
+
|
|
32
|
+
### Event-Driven
|
|
33
|
+
```
|
|
34
|
+
[Producer] → [Event Bus] → [Consumer]
|
|
35
|
+
→ [Consumer]
|
|
36
|
+
→ [Consumer]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Microservices
|
|
40
|
+
```
|
|
41
|
+
[API Gateway]
|
|
42
|
+
│
|
|
43
|
+
┌────┼────┐
|
|
44
|
+
▼ ▼ ▼
|
|
45
|
+
[A] [B] [C]
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Serverless
|
|
49
|
+
```
|
|
50
|
+
[Request] → [Function] → [Database]
|
|
51
|
+
→ [Queue]
|
|
52
|
+
→ [Storage]
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Design Questions
|
|
56
|
+
1. How does this scale to 1000x?
|
|
57
|
+
2. What's the single point of failure?
|
|
58
|
+
3. How do we deploy without downtime?
|
|
59
|
+
4. What's the cost at scale?
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: omega-coding
|
|
3
|
+
description: AI-first development patterns. Use for leveraging AI in development.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Omega Coding Skill
|
|
7
|
+
|
|
8
|
+
## Principles
|
|
9
|
+
|
|
10
|
+
### 1. AI-First Design
|
|
11
|
+
Design for AI assistance:
|
|
12
|
+
- Clear interfaces
|
|
13
|
+
- Self-documenting code
|
|
14
|
+
- Predictable patterns
|
|
15
|
+
|
|
16
|
+
### 2. Prompt-Driven Development
|
|
17
|
+
```markdown
|
|
18
|
+
1. Write clear requirements
|
|
19
|
+
2. Let AI generate first draft
|
|
20
|
+
3. Review and refine
|
|
21
|
+
4. Iterate with feedback
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### 3. Leverage Multiplication (Ω1)
|
|
25
|
+
```
|
|
26
|
+
Manual: 1 task = 1 hour
|
|
27
|
+
AI-Assisted: 1 task = 5 minutes
|
|
28
|
+
Leverage: 12x improvement
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Patterns
|
|
32
|
+
|
|
33
|
+
### Specification First
|
|
34
|
+
```markdown
|
|
35
|
+
## Spec: UserService
|
|
36
|
+
|
|
37
|
+
### Methods
|
|
38
|
+
- createUser(email, password) → User
|
|
39
|
+
- getUser(id) → User | null
|
|
40
|
+
|
|
41
|
+
### Constraints
|
|
42
|
+
- Email must be unique
|
|
43
|
+
- Password hashed with bcrypt
|
|
44
|
+
|
|
45
|
+
### Tests
|
|
46
|
+
- Creates user successfully
|
|
47
|
+
- Rejects duplicate email
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Iterative Refinement
|
|
51
|
+
1. Generate initial code
|
|
52
|
+
2. Add tests
|
|
53
|
+
3. Fix edge cases
|
|
54
|
+
4. Optimize
|
|
55
|
+
5. Document
|
|
56
|
+
|
|
57
|
+
## Best Practices
|
|
58
|
+
- Clear specifications
|
|
59
|
+
- Incremental generation
|
|
60
|
+
- Verification at each step
|
|
61
|
+
- Learn from AI suggestions
|