Skip to content

Commit 0053c56

Browse files
randrand
committed
feat: Expand engineering category with 10 software development practice skills
Add comprehensive skills covering modern software engineering practices: Software Development Practices (10 new skills): - code-review.md: PR reviews, feedback, automation tools - code-quality.md: SOLID principles, metrics, code smells - refactoring-patterns.md: Safe refactoring techniques - test-driven-development.md: TDD, red-green-refactor cycle - domain-driven-design.md: DDD patterns, bounded contexts - functional-programming.md: FP principles, immutability - design-patterns.md: GoF patterns, when to use - technical-debt.md: Identifying and managing debt - pair-programming.md: Pairing techniques, mob programming - continuous-integration.md: CI/CD pipelines, deployment Existing RFC Skills (4 skills): - rfc-consensus-building.md - rfc-decision-documentation.md - rfc-structure-format.md - rfc-technical-design.md Updates: - Updated engineering/INDEX.md: 4 → 14 skills - Updated discover-engineering/SKILL.md: Added workflow combinations - Each skill includes 250-400 lines with comprehensive examples - Multi-language code examples (Python, TypeScript, Go, Rust) - Patterns, anti-patterns, and best practices - Cross-references to related skills Total engineering skills: 14
1 parent 27cd0fc commit 0053c56

12 files changed

Lines changed: 6383 additions & 11 deletions

‎skills/discover-engineering/SKILL.md‎

Lines changed: 56 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,25 @@ This skill auto-activates when you're working with:
2020

2121
### Quick Reference
2222

23-
The Engineering category contains 4 skills:
24-
25-
1. **rfc-consensus-building**
26-
2. **rfc-decision-documentation**
27-
3. **rfc-structure-format**
28-
4. **rfc-technical-design**
23+
The Engineering category contains 14 skills:
24+
25+
**Software Development Practices:**
26+
1. **code-review** - PR reviews, feedback, automation
27+
2. **code-quality** - SOLID principles, metrics, code smells
28+
3. **refactoring-patterns** - Safe refactoring techniques
29+
4. **test-driven-development** - TDD, red-green-refactor
30+
5. **domain-driven-design** - DDD patterns, bounded contexts
31+
6. **functional-programming** - FP principles, immutability
32+
7. **design-patterns** - GoF patterns, when to use
33+
8. **technical-debt** - Identifying and managing debt
34+
9. **pair-programming** - Pairing techniques, mob programming
35+
10. **continuous-integration** - CI/CD pipelines, deployment
36+
37+
**RFC & Documentation:**
38+
11. **rfc-consensus-building** - Stakeholder collaboration
39+
12. **rfc-decision-documentation** - ADRs, decision tracking
40+
13. **rfc-structure-format** - RFC templates, formatting
41+
14. **rfc-technical-design** - Architecture proposals
2942

3043
### Load Full Category Details
3144

@@ -46,12 +59,49 @@ This loads the full Engineering category index with:
4659
Load individual skills as needed:
4760

4861
```bash
62+
# Software Development Practices
63+
cat skills/engineering/code-review.md
64+
cat skills/engineering/code-quality.md
65+
cat skills/engineering/refactoring-patterns.md
66+
cat skills/engineering/test-driven-development.md
67+
cat skills/engineering/domain-driven-design.md
68+
cat skills/engineering/functional-programming.md
69+
cat skills/engineering/design-patterns.md
70+
cat skills/engineering/technical-debt.md
71+
cat skills/engineering/pair-programming.md
72+
cat skills/engineering/continuous-integration.md
73+
74+
# RFC & Documentation
4975
cat skills/engineering/rfc-consensus-building.md
5076
cat skills/engineering/rfc-decision-documentation.md
5177
cat skills/engineering/rfc-structure-format.md
5278
cat skills/engineering/rfc-technical-design.md
5379
```
5480

81+
### Common Workflow Combinations
82+
83+
**Code Quality Workflow:**
84+
```bash
85+
# Load related skills together
86+
cat skills/engineering/code-review.md
87+
cat skills/engineering/code-quality.md
88+
cat skills/engineering/refactoring-patterns.md
89+
```
90+
91+
**TDD Workflow:**
92+
```bash
93+
cat skills/engineering/test-driven-development.md
94+
cat skills/engineering/code-quality.md
95+
cat skills/engineering/continuous-integration.md
96+
```
97+
98+
**Architecture Design Workflow:**
99+
```bash
100+
cat skills/engineering/domain-driven-design.md
101+
cat skills/engineering/design-patterns.md
102+
cat skills/engineering/rfc-technical-design.md
103+
```
104+
55105
## Progressive Loading
56106

57107
This gateway skill enables progressive loading:

‎skills/engineering/INDEX.md‎

Lines changed: 105 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,91 @@
22

33
## Category Overview
44

5-
**Total Skills**: 4
5+
**Total Skills**: 14
66
**Category**: engineering
77

88
## Skills in This Category
99

10+
### code-review.md
11+
**Description**: Code review practices, PR etiquette, constructive feedback, automation tools, and effective review workflows
12+
13+
**Load this skill**:
14+
```bash
15+
cat skills/engineering/code-review.md
16+
```
17+
18+
---
19+
20+
### code-quality.md
21+
**Description**: Code quality metrics, maintainability principles, SOLID design, code smells detection, and quality measurement
22+
23+
**Load this skill**:
24+
```bash
25+
cat skills/engineering/code-quality.md
26+
```
27+
28+
---
29+
30+
### continuous-integration.md
31+
**Description**: CI/CD pipeline design, automated testing, deployment strategies, and continuous delivery best practices
32+
33+
**Load this skill**:
34+
```bash
35+
cat skills/engineering/continuous-integration.md
36+
```
37+
38+
---
39+
40+
### design-patterns.md
41+
**Description**: Gang of Four design patterns, when to use each pattern, implementation examples, and anti-patterns
42+
43+
**Load this skill**:
44+
```bash
45+
cat skills/engineering/design-patterns.md
46+
```
47+
48+
---
49+
50+
### domain-driven-design.md
51+
**Description**: Domain-Driven Design patterns, bounded contexts, aggregates, entities, value objects, and strategic design
52+
53+
**Load this skill**:
54+
```bash
55+
cat skills/engineering/domain-driven-design.md
56+
```
57+
58+
---
59+
60+
### functional-programming.md
61+
**Description**: Functional programming principles, immutability, pure functions, higher-order functions, and FP patterns
62+
63+
**Load this skill**:
64+
```bash
65+
cat skills/engineering/functional-programming.md
66+
```
67+
68+
---
69+
70+
### pair-programming.md
71+
**Description**: Pair programming techniques, driver-navigator roles, mob programming, remote pairing tools and best practices
72+
73+
**Load this skill**:
74+
```bash
75+
cat skills/engineering/pair-programming.md
76+
```
77+
78+
---
79+
80+
### refactoring-patterns.md
81+
**Description**: Refactoring techniques, when to refactor, safe refactoring strategies, and code improvement patterns
82+
83+
**Load this skill**:
84+
```bash
85+
cat skills/engineering/refactoring-patterns.md
86+
```
87+
88+
---
89+
1090
### rfc-consensus-building.md
1191
**Description**: Stakeholder identification, feedback collection, consensus building, and approval processes for RFCs
1292

@@ -47,17 +127,37 @@ cat skills/engineering/rfc-technical-design.md
47127

48128
---
49129

130+
### technical-debt.md
131+
**Description**: Identifying, measuring, tracking, and managing technical debt strategically and systematically
132+
133+
**Load this skill**:
134+
```bash
135+
cat skills/engineering/technical-debt.md
136+
```
137+
138+
---
139+
140+
### test-driven-development.md
141+
**Description**: Test-Driven Development methodology, red-green-refactor cycle, unit testing best practices, and mocking strategies
142+
143+
**Load this skill**:
144+
```bash
145+
cat skills/engineering/test-driven-development.md
146+
```
147+
148+
---
149+
50150
## Loading All Skills
51151

52152
```bash
53153
# List all skills in this category
54154
ls skills/engineering/*.md
55155

56156
# Load specific skills
57-
cat skills/engineering/rfc-consensus-building.md
58-
cat skills/engineering/rfc-decision-documentation.md
59-
cat skills/engineering/rfc-structure-format.md
60-
# ... and 1 more
157+
cat skills/engineering/code-review.md
158+
cat skills/engineering/code-quality.md
159+
cat skills/engineering/continuous-integration.md
160+
# ... and 11 more
61161
```
62162

63163
## Related Categories

0 commit comments

Comments
 (0)