@mytechtoday/augment-extensions 1.2.0 → 1.2.2
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/AGENTS.md +35 -3
- package/README.md +3 -3
- package/augment-extensions/domain-rules/software-architecture/README.md +143 -0
- package/augment-extensions/domain-rules/software-architecture/examples/banking-layered.md +961 -0
- package/augment-extensions/domain-rules/software-architecture/examples/ecommerce-microservices.md +990 -0
- package/augment-extensions/domain-rules/software-architecture/examples/iot-eventdriven.md +882 -0
- package/augment-extensions/domain-rules/software-architecture/examples/monolith-to-microservices-migration.md +703 -0
- package/augment-extensions/domain-rules/software-architecture/examples/serverless-imageprocessing.md +957 -0
- package/augment-extensions/domain-rules/software-architecture/examples/trading-eventdriven.md +747 -0
- package/augment-extensions/domain-rules/software-architecture/module.json +119 -0
- package/augment-extensions/domain-rules/software-architecture/rules/challenges-solutions.md +763 -0
- package/augment-extensions/domain-rules/software-architecture/rules/definitions-terminology.md +409 -0
- package/augment-extensions/domain-rules/software-architecture/rules/design-principles.md +684 -0
- package/augment-extensions/domain-rules/software-architecture/rules/evaluation-testing.md +1381 -0
- package/augment-extensions/domain-rules/software-architecture/rules/event-driven-architecture.md +616 -0
- package/augment-extensions/domain-rules/software-architecture/rules/fundamentals.md +306 -0
- package/augment-extensions/domain-rules/software-architecture/rules/industry-architectures.md +554 -0
- package/augment-extensions/domain-rules/software-architecture/rules/layered-architecture.md +776 -0
- package/augment-extensions/domain-rules/software-architecture/rules/microservices-architecture.md +503 -0
- package/augment-extensions/domain-rules/software-architecture/rules/modeling-documentation.md +1199 -0
- package/augment-extensions/domain-rules/software-architecture/rules/monolithic-architecture.md +351 -0
- package/augment-extensions/domain-rules/software-architecture/rules/principles.md +556 -0
- package/augment-extensions/domain-rules/software-architecture/rules/quality-attributes.md +797 -0
- package/augment-extensions/domain-rules/software-architecture/rules/scalability-performance.md +1345 -0
- package/augment-extensions/domain-rules/software-architecture/rules/security-architecture.md +1039 -0
- package/augment-extensions/domain-rules/software-architecture/rules/serverless-architecture.md +711 -0
- package/augment-extensions/domain-rules/software-architecture/rules/skills-development.md +568 -0
- package/augment-extensions/domain-rules/software-architecture/rules/tools-methodologies.md +961 -0
- package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +8 -8
- package/augment-extensions/workflows/beads/rules/best-practices.md +2 -2
- package/augment-extensions/workflows/beads/rules/file-format.md +4 -4
- package/augment-extensions/workflows/beads/rules/manual-setup.md +4 -4
- package/augment-extensions/workflows/beads/rules/workflow.md +3 -3
- package/modules.md +40 -3
- package/package.json +1 -1
|
@@ -95,14 +95,14 @@ Only `bd-a3f8.1` is ready because it has no blockers.
|
|
|
95
95
|
|
|
96
96
|
```bash
|
|
97
97
|
# With CLI
|
|
98
|
-
bd update bd-a3f8.1 --status
|
|
98
|
+
bd update bd-a3f8.1 --status in_progress
|
|
99
99
|
bd comment bd-a3f8.1 "Creating users table with email, password_hash, created_at columns"
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
103
103
|
|
|
104
104
|
```jsonl
|
|
105
|
-
{"id":"bd-a3f8.1","status":"
|
|
105
|
+
{"id":"bd-a3f8.1","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
106
106
|
{"id":"bd-a3f8.1","comments":[{"text":"Creating users table with email, password_hash, created_at columns","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
|
|
107
107
|
```
|
|
108
108
|
|
|
@@ -145,7 +145,7 @@ bd comment bd-a3f8.2 "Using bcrypt with cost factor 12"
|
|
|
145
145
|
bd close bd-a3f8.2
|
|
146
146
|
|
|
147
147
|
# Work on JWT generation
|
|
148
|
-
bd update bd-a3f8.3 --status
|
|
148
|
+
bd update bd-a3f8.3 --status in_progress
|
|
149
149
|
bd comment bd-a3f8.3 "Using HS256 algorithm, 24-hour expiry"
|
|
150
150
|
|
|
151
151
|
# Complete it
|
|
@@ -155,10 +155,10 @@ bd close bd-a3f8.3
|
|
|
155
155
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
156
156
|
|
|
157
157
|
```jsonl
|
|
158
|
-
{"id":"bd-a3f8.2","status":"
|
|
158
|
+
{"id":"bd-a3f8.2","status":"in_progress","updated":"2024-01-20T12:30:00Z"}
|
|
159
159
|
{"id":"bd-a3f8.2","comments":[{"text":"Using bcrypt with cost factor 12","timestamp":"2024-01-20T12:30:00Z"}],"updated":"2024-01-20T12:30:00Z"}
|
|
160
160
|
{"id":"bd-a3f8.2","status":"closed","closed":"2024-01-20T13:00:00Z","updated":"2024-01-20T13:00:00Z"}
|
|
161
|
-
{"id":"bd-a3f8.3","status":"
|
|
161
|
+
{"id":"bd-a3f8.3","status":"in_progress","updated":"2024-01-20T13:30:00Z"}
|
|
162
162
|
{"id":"bd-a3f8.3","comments":[{"text":"Using HS256 algorithm, 24-hour expiry","timestamp":"2024-01-20T13:30:00Z"}],"updated":"2024-01-20T13:30:00Z"}
|
|
163
163
|
{"id":"bd-a3f8.3","status":"closed","closed":"2024-01-20T14:00:00Z","updated":"2024-01-20T14:00:00Z"}
|
|
164
164
|
```
|
|
@@ -179,7 +179,7 @@ Now `bd-a3f8.4` is ready because both blockers are closed.
|
|
|
179
179
|
|
|
180
180
|
```bash
|
|
181
181
|
# With CLI
|
|
182
|
-
bd update bd-a3f8.4 --status
|
|
182
|
+
bd update bd-a3f8.4 --status in_progress
|
|
183
183
|
bd comment bd-a3f8.4 "POST /api/auth/login endpoint created, returns JWT on success"
|
|
184
184
|
bd close bd-a3f8.4
|
|
185
185
|
```
|
|
@@ -187,7 +187,7 @@ bd close bd-a3f8.4
|
|
|
187
187
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
188
188
|
|
|
189
189
|
```jsonl
|
|
190
|
-
{"id":"bd-a3f8.4","status":"
|
|
190
|
+
{"id":"bd-a3f8.4","status":"in_progress","updated":"2024-01-20T14:30:00Z"}
|
|
191
191
|
{"id":"bd-a3f8.4","comments":[{"text":"POST /api/auth/login endpoint created, returns JWT on success","timestamp":"2024-01-20T14:30:00Z"}],"updated":"2024-01-20T14:30:00Z"}
|
|
192
192
|
{"id":"bd-a3f8.4","status":"closed","closed":"2024-01-20T15:00:00Z","updated":"2024-01-20T15:00:00Z"}
|
|
193
193
|
```
|
|
@@ -266,7 +266,7 @@ What Beads tasks are ready to work on?
|
|
|
266
266
|
### Documenting Progress
|
|
267
267
|
|
|
268
268
|
```
|
|
269
|
-
Update Beads task bd-a3f8.2 to
|
|
269
|
+
Update Beads task bd-a3f8.2 to in_progress.
|
|
270
270
|
Add comment: "Using bcrypt with cost factor 12"
|
|
271
271
|
```
|
|
272
272
|
|
|
@@ -116,7 +116,7 @@ Deeper hierarchies become hard to manage.
|
|
|
116
116
|
Keep status current:
|
|
117
117
|
|
|
118
118
|
```
|
|
119
|
-
open →
|
|
119
|
+
open → in_progress → closed
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
### Use Blocked Status
|
|
@@ -223,7 +223,7 @@ Track who is working on what:
|
|
|
223
223
|
"id": "bd-a1b2",
|
|
224
224
|
"title": "Add authentication",
|
|
225
225
|
"assignee": "agent-1",
|
|
226
|
-
"status": "
|
|
226
|
+
"status": "in_progress"
|
|
227
227
|
}
|
|
228
228
|
```
|
|
229
229
|
|
|
@@ -64,7 +64,7 @@ Beads stores issues in `.beads/issues.jsonl` using JSONL (JSON Lines) format. Ea
|
|
|
64
64
|
|
|
65
65
|
- **id** (string): Unique hash-based ID, format: `bd-<hash>` or `bd-<hash>.<number>` for hierarchical
|
|
66
66
|
- **title** (string): Short description of the task
|
|
67
|
-
- **status** (string): One of: `"open"`, `"
|
|
67
|
+
- **status** (string): One of: `"open"`, `"in_progress"`, `"blocked"`, `"closed"`
|
|
68
68
|
- **created** (string): ISO 8601 timestamp
|
|
69
69
|
- **updated** (string): ISO 8601 timestamp
|
|
70
70
|
|
|
@@ -109,7 +109,7 @@ bd-a3f8.2 # Another task under epic
|
|
|
109
109
|
## Status Values
|
|
110
110
|
|
|
111
111
|
- **open** - Task is ready to work on (no blockers)
|
|
112
|
-
- **
|
|
112
|
+
- **in_progress** - Currently being worked on
|
|
113
113
|
- **blocked** - Waiting on dependencies
|
|
114
114
|
- **closed** - Completed or cancelled
|
|
115
115
|
|
|
@@ -227,7 +227,7 @@ Tasks that are related but not blocking:
|
|
|
227
227
|
|
|
228
228
|
```jsonl
|
|
229
229
|
{"id":"bd-a1b2","title":"Task 1","status":"open","created":"2024-01-20T10:00:00Z","updated":"2024-01-20T10:00:00Z"}
|
|
230
|
-
{"id":"bd-a1b2","status":"
|
|
230
|
+
{"id":"bd-a1b2","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
231
231
|
{"id":"bd-a1b2","status":"closed","closed":"2024-01-20T12:00:00Z","updated":"2024-01-20T12:00:00Z"}
|
|
232
232
|
```
|
|
233
233
|
|
|
@@ -310,7 +310,7 @@ echo '{"id":"bd-a1b2","title":"New task","status":"open","created":"2024-01-20T1
|
|
|
310
310
|
### Start Work
|
|
311
311
|
|
|
312
312
|
```jsonl
|
|
313
|
-
{"id":"bd-a1b2","status":"
|
|
313
|
+
{"id":"bd-a1b2","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
314
314
|
```
|
|
315
315
|
|
|
316
316
|
### Add Comment
|
|
@@ -63,7 +63,7 @@ Append a JSON line:
|
|
|
63
63
|
Append a JSON line with the same ID and updated fields:
|
|
64
64
|
|
|
65
65
|
```json
|
|
66
|
-
{"id":"bd-<hash>","status":"
|
|
66
|
+
{"id":"bd-<hash>","status":"in_progress","updated":"<ISO-8601>"}
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
### Closing Tasks
|
|
@@ -77,7 +77,7 @@ Append a JSON line with status "closed":
|
|
|
77
77
|
## Task States
|
|
78
78
|
|
|
79
79
|
- **open** - Ready to work on
|
|
80
|
-
- **
|
|
80
|
+
- **in_progress** - Currently being worked on
|
|
81
81
|
- **blocked** - Waiting on dependencies
|
|
82
82
|
- **closed** - Completed
|
|
83
83
|
|
|
@@ -100,7 +100,7 @@ Tasks are ready when:
|
|
|
100
100
|
1. Create task by appending to `.beads/issues.jsonl`
|
|
101
101
|
2. Add dependencies with `blocks`/`blocked_by` fields
|
|
102
102
|
3. Find ready tasks (no open blockers)
|
|
103
|
-
4. Update status to "
|
|
103
|
+
4. Update status to "in_progress"
|
|
104
104
|
5. Add comments as needed
|
|
105
105
|
6. Close task when complete
|
|
106
106
|
```
|
|
@@ -206,7 +206,7 @@ Parse .beads/issues.jsonl and find tasks where:
|
|
|
206
206
|
Ask your AI:
|
|
207
207
|
|
|
208
208
|
```
|
|
209
|
-
Update Beads task bd-a1b2 to status "
|
|
209
|
+
Update Beads task bd-a1b2 to status "in_progress"
|
|
210
210
|
Append an update to .beads/issues.jsonl
|
|
211
211
|
```
|
|
212
212
|
|
|
@@ -74,7 +74,7 @@ bd create "Implement authentication" -p 1
|
|
|
74
74
|
- **Context**: AI agents load relevant rules automatically
|
|
75
75
|
- **Coordination**: Integration with coordination manifest
|
|
76
76
|
|
|
77
|
-
See `.augment/
|
|
77
|
+
See `.augment-guidelines/system-integration/coordination-system.md` for details.
|
|
78
78
|
|
|
79
79
|
---
|
|
80
80
|
|
|
@@ -220,7 +220,7 @@ The AI will:
|
|
|
220
220
|
bd comment bd-a1b2 "Started implementation, added login endpoint"
|
|
221
221
|
|
|
222
222
|
# Update status
|
|
223
|
-
bd update bd-a1b2 --status
|
|
223
|
+
bd update bd-a1b2 --status in_progress
|
|
224
224
|
|
|
225
225
|
# Add labels
|
|
226
226
|
bd update bd-a1b2 --labels backend,auth
|
|
@@ -231,7 +231,7 @@ bd update bd-a1b2 --labels backend,auth
|
|
|
231
231
|
Append update to `.beads/issues.jsonl`:
|
|
232
232
|
|
|
233
233
|
```json
|
|
234
|
-
{"id":"bd-a1b2","title":"Implement user authentication","status":"
|
|
234
|
+
{"id":"bd-a1b2","title":"Implement user authentication","status":"in_progress","priority":0,"comments":[{"text":"Started implementation","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
|
|
235
235
|
```
|
|
236
236
|
|
|
237
237
|
## Step 6: Close Task
|
package/modules.md
CHANGED
|
@@ -395,6 +395,43 @@ augx link domain-rules/security
|
|
|
395
395
|
augx link domain-rules/seo-sales-marketing
|
|
396
396
|
```
|
|
397
397
|
|
|
398
|
+
### Software Architecture Design
|
|
399
|
+
- **Module**: `domain-rules/software-architecture`
|
|
400
|
+
- **Version**: 1.0.0
|
|
401
|
+
- **Character Count**: 508,000
|
|
402
|
+
- **Description**: Comprehensive software architecture design patterns, principles, and best practices covering monolithic, microservices, event-driven, serverless, and industry-specific architectures
|
|
403
|
+
- **Contents**:
|
|
404
|
+
- **Fundamentals**: Core architectural elements (ISO/IEC 42010), definitions and terminology, architectural views (4+1 model), quality attributes
|
|
405
|
+
- **Principles**: Modularity, separation of concerns, coupling, cohesion, SOLID principles, DRY, KISS
|
|
406
|
+
- **Architecture Patterns**:
|
|
407
|
+
- Monolithic architecture patterns and modular monoliths
|
|
408
|
+
- Microservices patterns, service discovery, API gateways, distributed systems
|
|
409
|
+
- Event-driven architecture, pub/sub, CQRS, event sourcing, saga pattern
|
|
410
|
+
- Serverless patterns, FaaS, stateless functions, cloud-native
|
|
411
|
+
- Layered architecture, MVC, hexagonal architecture, pipe-and-filter
|
|
412
|
+
- **Quality Attributes**: Performance, reliability, maintainability, scalability, security
|
|
413
|
+
- **Security Architecture**: Threat modeling, zero-trust, RBAC, defense in depth (OWASP)
|
|
414
|
+
- **Scalability & Performance**: Horizontal/vertical scaling, caching strategies, load balancing, database sharding
|
|
415
|
+
- **Best Practices**:
|
|
416
|
+
- Tools and methodologies (TOGAF, CI/CD, DDD frameworks)
|
|
417
|
+
- Modeling and documentation (4+1 views, UML, C4 model, ADRs)
|
|
418
|
+
- Evaluation and testing (ATAM, chaos engineering, architecture reviews)
|
|
419
|
+
- **Specialized Architectures**: IoT, AI/ML systems, blockchain, edge computing
|
|
420
|
+
- **Migration & Challenges**: Strangler Fig Pattern, technical debt management, monolith-to-microservices migration
|
|
421
|
+
- **Skills Development**: Technical and soft skills for architects
|
|
422
|
+
- **Examples**:
|
|
423
|
+
- E-commerce microservices platform
|
|
424
|
+
- IoT event-driven sensor network
|
|
425
|
+
- Stock trading event-driven system
|
|
426
|
+
- Serverless image processing pipeline
|
|
427
|
+
- Banking layered architecture application
|
|
428
|
+
- Monolith-to-microservices migration strategy
|
|
429
|
+
|
|
430
|
+
**Usage**:
|
|
431
|
+
```bash
|
|
432
|
+
augx link domain-rules/software-architecture
|
|
433
|
+
```
|
|
434
|
+
|
|
398
435
|
### WordPress Development Standards
|
|
399
436
|
- **Module**: `domain-rules/wordpress`
|
|
400
437
|
- **Version**: 1.0.0
|
|
@@ -657,11 +694,11 @@ augx mcp wrap github-mcp search-repos github-search --category retrieval
|
|
|
657
694
|
|
|
658
695
|
## Statistics
|
|
659
696
|
|
|
660
|
-
- **Total Modules**:
|
|
697
|
+
- **Total Modules**: 20
|
|
661
698
|
- **Coding Standards**: 5
|
|
662
699
|
- **Writing Standards**: 1
|
|
663
|
-
- **Domain Rules**:
|
|
700
|
+
- **Domain Rules**: 6
|
|
664
701
|
- **Workflows**: 2
|
|
665
702
|
- **Examples**: 4
|
|
666
703
|
- **Total Skills**: 4
|
|
667
|
-
- **Total Character Count**: ~
|
|
704
|
+
- **Total Character Count**: ~2,446,192
|