@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.
Files changed (35) hide show
  1. package/AGENTS.md +35 -3
  2. package/README.md +3 -3
  3. package/augment-extensions/domain-rules/software-architecture/README.md +143 -0
  4. package/augment-extensions/domain-rules/software-architecture/examples/banking-layered.md +961 -0
  5. package/augment-extensions/domain-rules/software-architecture/examples/ecommerce-microservices.md +990 -0
  6. package/augment-extensions/domain-rules/software-architecture/examples/iot-eventdriven.md +882 -0
  7. package/augment-extensions/domain-rules/software-architecture/examples/monolith-to-microservices-migration.md +703 -0
  8. package/augment-extensions/domain-rules/software-architecture/examples/serverless-imageprocessing.md +957 -0
  9. package/augment-extensions/domain-rules/software-architecture/examples/trading-eventdriven.md +747 -0
  10. package/augment-extensions/domain-rules/software-architecture/module.json +119 -0
  11. package/augment-extensions/domain-rules/software-architecture/rules/challenges-solutions.md +763 -0
  12. package/augment-extensions/domain-rules/software-architecture/rules/definitions-terminology.md +409 -0
  13. package/augment-extensions/domain-rules/software-architecture/rules/design-principles.md +684 -0
  14. package/augment-extensions/domain-rules/software-architecture/rules/evaluation-testing.md +1381 -0
  15. package/augment-extensions/domain-rules/software-architecture/rules/event-driven-architecture.md +616 -0
  16. package/augment-extensions/domain-rules/software-architecture/rules/fundamentals.md +306 -0
  17. package/augment-extensions/domain-rules/software-architecture/rules/industry-architectures.md +554 -0
  18. package/augment-extensions/domain-rules/software-architecture/rules/layered-architecture.md +776 -0
  19. package/augment-extensions/domain-rules/software-architecture/rules/microservices-architecture.md +503 -0
  20. package/augment-extensions/domain-rules/software-architecture/rules/modeling-documentation.md +1199 -0
  21. package/augment-extensions/domain-rules/software-architecture/rules/monolithic-architecture.md +351 -0
  22. package/augment-extensions/domain-rules/software-architecture/rules/principles.md +556 -0
  23. package/augment-extensions/domain-rules/software-architecture/rules/quality-attributes.md +797 -0
  24. package/augment-extensions/domain-rules/software-architecture/rules/scalability-performance.md +1345 -0
  25. package/augment-extensions/domain-rules/software-architecture/rules/security-architecture.md +1039 -0
  26. package/augment-extensions/domain-rules/software-architecture/rules/serverless-architecture.md +711 -0
  27. package/augment-extensions/domain-rules/software-architecture/rules/skills-development.md +568 -0
  28. package/augment-extensions/domain-rules/software-architecture/rules/tools-methodologies.md +961 -0
  29. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +8 -8
  30. package/augment-extensions/workflows/beads/rules/best-practices.md +2 -2
  31. package/augment-extensions/workflows/beads/rules/file-format.md +4 -4
  32. package/augment-extensions/workflows/beads/rules/manual-setup.md +4 -4
  33. package/augment-extensions/workflows/beads/rules/workflow.md +3 -3
  34. package/modules.md +40 -3
  35. 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 in-progress
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":"in-progress","updated":"2024-01-20T11:00:00Z"}
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 in-progress
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":"in-progress","updated":"2024-01-20T12:30:00Z"}
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":"in-progress","updated":"2024-01-20T13:30:00Z"}
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 in-progress
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":"in-progress","updated":"2024-01-20T14:30:00Z"}
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 in-progress.
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 → in-progress → closed
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": "in-progress"
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"`, `"in-progress"`, `"blocked"`, `"closed"`
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
- - **in-progress** - Currently being worked on
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":"in-progress","updated":"2024-01-20T11:00:00Z"}
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":"in-progress","updated":"2024-01-20T11:00:00Z"}
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":"in-progress","updated":"<ISO-8601>"}
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
- - **in-progress** - Currently being worked on
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 "in-progress"
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 "in-progress"
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/rules/coordination-system.md` for details.
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 in-progress
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":"in-progress","priority":0,"comments":[{"text":"Started implementation","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
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**: 19
697
+ - **Total Modules**: 20
661
698
  - **Coding Standards**: 5
662
699
  - **Writing Standards**: 1
663
- - **Domain Rules**: 5
700
+ - **Domain Rules**: 6
664
701
  - **Workflows**: 2
665
702
  - **Examples**: 4
666
703
  - **Total Skills**: 4
667
- - **Total Character Count**: ~1,938,192
704
+ - **Total Character Count**: ~2,446,192
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mytechtoday/augment-extensions",
3
- "version": "1.2.0",
3
+ "version": "1.2.2",
4
4
  "description": "CLI tool for managing Augment Code AI extension modules",
5
5
  "main": "cli/dist/index.js",
6
6
  "bin": {