@mytechtoday/augment-extensions 1.3.0 → 1.3.1

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 (95) hide show
  1. package/LICENSE +22 -22
  2. package/augment-extensions/domain-rules/software-architecture/README.md +143 -143
  3. package/augment-extensions/domain-rules/software-architecture/examples/banking-layered.md +961 -961
  4. package/augment-extensions/domain-rules/software-architecture/examples/ecommerce-microservices.md +990 -990
  5. package/augment-extensions/domain-rules/software-architecture/examples/iot-eventdriven.md +882 -882
  6. package/augment-extensions/domain-rules/software-architecture/examples/monolith-to-microservices-migration.md +703 -703
  7. package/augment-extensions/domain-rules/software-architecture/examples/serverless-imageprocessing.md +957 -957
  8. package/augment-extensions/domain-rules/software-architecture/examples/trading-eventdriven.md +747 -747
  9. package/augment-extensions/domain-rules/software-architecture/module.json +119 -119
  10. package/augment-extensions/domain-rules/software-architecture/rules/challenges-solutions.md +763 -763
  11. package/augment-extensions/domain-rules/software-architecture/rules/definitions-terminology.md +409 -409
  12. package/augment-extensions/domain-rules/software-architecture/rules/design-principles.md +684 -684
  13. package/augment-extensions/domain-rules/software-architecture/rules/evaluation-testing.md +1381 -1381
  14. package/augment-extensions/domain-rules/software-architecture/rules/event-driven-architecture.md +616 -616
  15. package/augment-extensions/domain-rules/software-architecture/rules/fundamentals.md +306 -306
  16. package/augment-extensions/domain-rules/software-architecture/rules/industry-architectures.md +554 -554
  17. package/augment-extensions/domain-rules/software-architecture/rules/layered-architecture.md +776 -776
  18. package/augment-extensions/domain-rules/software-architecture/rules/microservices-architecture.md +503 -503
  19. package/augment-extensions/domain-rules/software-architecture/rules/modeling-documentation.md +1199 -1199
  20. package/augment-extensions/domain-rules/software-architecture/rules/monolithic-architecture.md +351 -351
  21. package/augment-extensions/domain-rules/software-architecture/rules/principles.md +556 -556
  22. package/augment-extensions/domain-rules/software-architecture/rules/quality-attributes.md +797 -797
  23. package/augment-extensions/domain-rules/software-architecture/rules/scalability-performance.md +1345 -1345
  24. package/augment-extensions/domain-rules/software-architecture/rules/security-architecture.md +1039 -1039
  25. package/augment-extensions/domain-rules/software-architecture/rules/serverless-architecture.md +711 -711
  26. package/augment-extensions/domain-rules/software-architecture/rules/skills-development.md +568 -568
  27. package/augment-extensions/domain-rules/software-architecture/rules/tools-methodologies.md +961 -961
  28. package/augment-extensions/visual-design/CHANGELOG.md +132 -132
  29. package/augment-extensions/visual-design/README.md +255 -255
  30. package/augment-extensions/visual-design/__tests__/README.md +119 -119
  31. package/augment-extensions/visual-design/__tests__/style-selector.test.ts +172 -172
  32. package/augment-extensions/visual-design/__tests__/vendor-styles.test.ts +214 -214
  33. package/augment-extensions/visual-design/domains/other/ai-prompt-helper.ts +157 -157
  34. package/augment-extensions/visual-design/domains/other/dotnet-application.ts +156 -156
  35. package/augment-extensions/visual-design/domains/other/linux-platform.ts +156 -156
  36. package/augment-extensions/visual-design/domains/other/mobile-application.ts +157 -157
  37. package/augment-extensions/visual-design/domains/other/motion-picture.ts +156 -156
  38. package/augment-extensions/visual-design/domains/other/os-application.ts +156 -156
  39. package/augment-extensions/visual-design/domains/other/print-campaigns.ts +158 -158
  40. package/augment-extensions/visual-design/domains/other/web-app.ts +157 -157
  41. package/augment-extensions/visual-design/domains/other/website.ts +161 -161
  42. package/augment-extensions/visual-design/domains/other/windows-platform.ts +156 -156
  43. package/augment-extensions/visual-design/domains/web-page-styles/amazon-cloudscape.ts +506 -506
  44. package/augment-extensions/visual-design/domains/web-page-styles/google-modern.ts +615 -615
  45. package/augment-extensions/visual-design/domains/web-page-styles/microsoft-fluent.ts +531 -531
  46. package/augment-extensions/visual-design/examples/README.md +97 -97
  47. package/augment-extensions/visual-design/examples/ai-prompt-generation.md +233 -233
  48. package/augment-extensions/visual-design/examples/basic-usage.md +216 -216
  49. package/augment-extensions/visual-design/examples/domain-workflows.md +257 -257
  50. package/augment-extensions/visual-design/examples/vendor-comparison.md +247 -247
  51. package/augment-extensions/visual-design/module.json +78 -78
  52. package/augment-extensions/visual-design/style-selector.ts +177 -177
  53. package/augment-extensions/visual-design/types.ts +302 -302
  54. package/augment-extensions/visual-design/visual-design-core.ts +469 -469
  55. package/augment-extensions/workflows/adr-support/README.md +227 -227
  56. package/augment-extensions/workflows/adr-support/__tests__/adr-validator.test.ts +203 -203
  57. package/augment-extensions/workflows/adr-support/adr-validator.ts +162 -162
  58. package/augment-extensions/workflows/adr-support/examples/complete-lifecycle-example.md +449 -449
  59. package/augment-extensions/workflows/adr-support/examples/integration-example.md +580 -580
  60. package/augment-extensions/workflows/adr-support/examples/superseding-example.md +436 -436
  61. package/augment-extensions/workflows/adr-support/module.json +112 -112
  62. package/augment-extensions/workflows/adr-support/rules/adr-creation.md +372 -372
  63. package/augment-extensions/workflows/adr-support/rules/beads-integration.md +443 -443
  64. package/augment-extensions/workflows/adr-support/rules/conflict-detection.md +486 -486
  65. package/augment-extensions/workflows/adr-support/rules/decision-detection.md +362 -362
  66. package/augment-extensions/workflows/adr-support/rules/lifecycle-management.md +427 -427
  67. package/augment-extensions/workflows/adr-support/rules/openspec-integration.md +465 -465
  68. package/augment-extensions/workflows/adr-support/rules/template-selection.md +405 -405
  69. package/augment-extensions/workflows/adr-support/rules/validation-rules.md +543 -543
  70. package/augment-extensions/workflows/adr-support/schemas/adr-config.json +191 -191
  71. package/augment-extensions/workflows/adr-support/schemas/adr-metadata.json +172 -172
  72. package/augment-extensions/workflows/adr-support/templates/business-case.md +235 -235
  73. package/augment-extensions/workflows/adr-support/templates/madr-elaborate.md +197 -197
  74. package/augment-extensions/workflows/adr-support/templates/madr-simple.md +68 -68
  75. package/augment-extensions/workflows/adr-support/templates/nygard.md +84 -84
  76. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -213
  77. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -169
  78. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -165
  79. package/cli/dist/utils/auto-sync.js +19 -19
  80. package/package.json +5 -3
  81. package/augment-extensions/workflows/openspec/README.md +0 -96
  82. package/augment-extensions/workflows/openspec/examples/complete-change-example.md +0 -244
  83. package/augment-extensions/workflows/openspec/module.json +0 -54
  84. package/augment-extensions/workflows/openspec/rules/best-practices.md +0 -272
  85. package/augment-extensions/workflows/openspec/rules/manual-setup.md +0 -231
  86. package/augment-extensions/workflows/openspec/rules/spec-format.md +0 -236
  87. package/augment-extensions/workflows/openspec/rules/workflow.md +0 -214
  88. package/cli/dist/utils/__tests__/adr-validator.example.d.ts +0 -6
  89. package/cli/dist/utils/__tests__/adr-validator.example.d.ts.map +0 -1
  90. package/cli/dist/utils/__tests__/adr-validator.example.js +0 -148
  91. package/cli/dist/utils/__tests__/adr-validator.example.js.map +0 -1
  92. package/cli/dist/utils/adr-validator.d.ts +0 -65
  93. package/cli/dist/utils/adr-validator.d.ts.map +0 -1
  94. package/cli/dist/utils/adr-validator.js +0 -203
  95. package/cli/dist/utils/adr-validator.js.map +0 -1
@@ -1,235 +1,235 @@
1
- # ADR-{number}: {Title}
2
-
3
- **Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
4
-
5
- **Date:** {YYYY-MM-DD}
6
-
7
- **Deciders:** {List of people involved in the decision}
8
-
9
- **Business Owner:** {Name of business stakeholder}
10
-
11
- **Technical Story:** {Optional: Link to related issue, spec, or task}
12
-
13
- ---
14
-
15
- ## Executive Summary
16
-
17
- {Provide a 2-3 sentence summary of the decision, the problem it solves, and the expected business value.}
18
-
19
- ---
20
-
21
- ## Business Context
22
-
23
- ### Problem Statement
24
-
25
- {Describe the business problem or opportunity. What pain points exist? What business goals are not being met?}
26
-
27
- ### Current State
28
-
29
- {Describe the current situation, including existing solutions, workarounds, and their limitations}
30
-
31
- ### Desired State
32
-
33
- {Describe the target state after implementing this decision. What will be different?}
34
-
35
- ---
36
-
37
- ## Strategic Alignment
38
-
39
- ### Business Objectives
40
-
41
- {How does this decision align with organizational goals?}
42
-
43
- - {Objective 1}
44
- - {Objective 2}
45
- - {Objective 3}
46
-
47
- ### Key Performance Indicators (KPIs)
48
-
49
- {What metrics will this decision impact?}
50
-
51
- - {KPI 1: Current value → Target value}
52
- - {KPI 2: Current value → Target value}
53
- - {KPI 3: Current value → Target value}
54
-
55
- ---
56
-
57
- ## Financial Analysis
58
-
59
- ### Cost Breakdown
60
-
61
- #### Initial Investment
62
-
63
- | Category | Description | Cost |
64
- |----------|-------------|------|
65
- | Development | {Description} | ${amount} |
66
- | Infrastructure | {Description} | ${amount} |
67
- | Licensing | {Description} | ${amount} |
68
- | Training | {Description} | ${amount} |
69
- | **Total Initial** | | **${total}** |
70
-
71
- #### Ongoing Costs (Annual)
72
-
73
- | Category | Description | Cost |
74
- |----------|-------------|------|
75
- | Maintenance | {Description} | ${amount}/year |
76
- | Support | {Description} | ${amount}/year |
77
- | Licensing | {Description} | ${amount}/year |
78
- | Infrastructure | {Description} | ${amount}/year |
79
- | **Total Annual** | | **${total}/year** |
80
-
81
- ### Return on Investment (ROI)
82
-
83
- #### Expected Benefits (Annual)
84
-
85
- | Benefit | Description | Value |
86
- |---------|-------------|-------|
87
- | Revenue Increase | {Description} | ${amount}/year |
88
- | Cost Savings | {Description} | ${amount}/year |
89
- | Efficiency Gains | {Description} | ${amount}/year |
90
- | **Total Annual Benefit** | | **${total}/year** |
91
-
92
- #### ROI Calculation
93
-
94
- - **Total Initial Investment:** ${amount}
95
- - **Annual Net Benefit:** ${annual benefit - annual cost}
96
- - **Payback Period:** {X months/years}
97
- - **3-Year ROI:** {percentage}%
98
- - **5-Year ROI:** {percentage}%
99
-
100
- ### Risk-Adjusted ROI
101
-
102
- {Consider risks and their probability/impact on ROI}
103
-
104
- - **Best Case:** {ROI percentage}%
105
- - **Expected Case:** {ROI percentage}%
106
- - **Worst Case:** {ROI percentage}%
107
-
108
- ---
109
-
110
- ## Risk Assessment
111
-
112
- ### Business Risks
113
-
114
- | Risk | Probability | Impact | Mitigation Strategy |
115
- |------|-------------|--------|---------------------|
116
- | {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
117
- | {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
118
- | {Risk 3} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
119
-
120
- ### Technical Risks
121
-
122
- | Risk | Probability | Impact | Mitigation Strategy |
123
- |------|-------------|--------|---------------------|
124
- | {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
125
- | {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
126
-
127
- ---
128
-
129
- ## Alternatives Considered
130
-
131
- ### Option 1: {Option Name}
132
-
133
- **Cost:** ${amount}
134
- **ROI:** {percentage}%
135
- **Pros:** {Brief list}
136
- **Cons:** {Brief list}
137
- **Why not chosen:** {Reason}
138
-
139
- ### Option 2: {Option Name}
140
-
141
- **Cost:** ${amount}
142
- **ROI:** {percentage}%
143
- **Pros:** {Brief list}
144
- **Cons:** {Brief list}
145
- **Why not chosen:** {Reason}
146
-
147
- ### Option 3: Do Nothing
148
-
149
- **Cost:** ${opportunity cost}
150
- **Impact:** {Description of impact of not acting}
151
- **Why not chosen:** {Reason}
152
-
153
- ---
154
-
155
- ## Decision Outcome
156
-
157
- **Chosen option:** "{Option X}"
158
-
159
- ### Justification
160
-
161
- {Explain why this option provides the best business value, considering costs, benefits, risks, and strategic alignment}
162
-
163
- ### Success Criteria
164
-
165
- {How will we measure success?}
166
-
167
- - {Criterion 1}
168
- - {Criterion 2}
169
- - {Criterion 3}
170
-
171
- ---
172
-
173
- ## Implementation Timeline
174
-
175
- | Phase | Duration | Key Milestones | Cost |
176
- |-------|----------|----------------|------|
177
- | Phase 1: {Name} | {X weeks} | {Milestones} | ${amount} |
178
- | Phase 2: {Name} | {X weeks} | {Milestones} | ${amount} |
179
- | Phase 3: {Name} | {X weeks} | {Milestones} | ${amount} |
180
-
181
- **Total Duration:** {X months}
182
-
183
- ---
184
-
185
- ## Stakeholder Impact
186
-
187
- ### Internal Stakeholders
188
-
189
- | Stakeholder | Impact | Change Required | Support Level |
190
- |-------------|--------|-----------------|---------------|
191
- | {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
192
- | {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
193
-
194
- ### External Stakeholders
195
-
196
- | Stakeholder | Impact | Communication Plan |
197
- |-------------|--------|--------------------|
198
- | {Customers} | {Description} | {Plan} |
199
- | {Partners} | {Description} | {Plan} |
200
-
201
- ---
202
-
203
- ## Approval
204
-
205
- ### Recommendation
206
-
207
- {Clear recommendation with supporting rationale}
208
-
209
- ### Required Approvals
210
-
211
- - [ ] {Business Owner}
212
- - [ ] {Finance}
213
- - [ ] {Technical Lead}
214
- - [ ] {Executive Sponsor}
215
-
216
- ### Approval Date
217
-
218
- {Date when decision was approved}
219
-
220
- ---
221
-
222
- ## More Information
223
-
224
- ### References
225
-
226
- - {Link to market research}
227
- - {Link to competitive analysis}
228
- - {Link to technical feasibility study}
229
-
230
- ### Appendices
231
-
232
- - {Link to detailed financial model}
233
- - {Link to risk analysis}
234
- - {Link to stakeholder analysis}
235
-
1
+ # ADR-{number}: {Title}
2
+
3
+ **Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
4
+
5
+ **Date:** {YYYY-MM-DD}
6
+
7
+ **Deciders:** {List of people involved in the decision}
8
+
9
+ **Business Owner:** {Name of business stakeholder}
10
+
11
+ **Technical Story:** {Optional: Link to related issue, spec, or task}
12
+
13
+ ---
14
+
15
+ ## Executive Summary
16
+
17
+ {Provide a 2-3 sentence summary of the decision, the problem it solves, and the expected business value.}
18
+
19
+ ---
20
+
21
+ ## Business Context
22
+
23
+ ### Problem Statement
24
+
25
+ {Describe the business problem or opportunity. What pain points exist? What business goals are not being met?}
26
+
27
+ ### Current State
28
+
29
+ {Describe the current situation, including existing solutions, workarounds, and their limitations}
30
+
31
+ ### Desired State
32
+
33
+ {Describe the target state after implementing this decision. What will be different?}
34
+
35
+ ---
36
+
37
+ ## Strategic Alignment
38
+
39
+ ### Business Objectives
40
+
41
+ {How does this decision align with organizational goals?}
42
+
43
+ - {Objective 1}
44
+ - {Objective 2}
45
+ - {Objective 3}
46
+
47
+ ### Key Performance Indicators (KPIs)
48
+
49
+ {What metrics will this decision impact?}
50
+
51
+ - {KPI 1: Current value → Target value}
52
+ - {KPI 2: Current value → Target value}
53
+ - {KPI 3: Current value → Target value}
54
+
55
+ ---
56
+
57
+ ## Financial Analysis
58
+
59
+ ### Cost Breakdown
60
+
61
+ #### Initial Investment
62
+
63
+ | Category | Description | Cost |
64
+ |----------|-------------|------|
65
+ | Development | {Description} | ${amount} |
66
+ | Infrastructure | {Description} | ${amount} |
67
+ | Licensing | {Description} | ${amount} |
68
+ | Training | {Description} | ${amount} |
69
+ | **Total Initial** | | **${total}** |
70
+
71
+ #### Ongoing Costs (Annual)
72
+
73
+ | Category | Description | Cost |
74
+ |----------|-------------|------|
75
+ | Maintenance | {Description} | ${amount}/year |
76
+ | Support | {Description} | ${amount}/year |
77
+ | Licensing | {Description} | ${amount}/year |
78
+ | Infrastructure | {Description} | ${amount}/year |
79
+ | **Total Annual** | | **${total}/year** |
80
+
81
+ ### Return on Investment (ROI)
82
+
83
+ #### Expected Benefits (Annual)
84
+
85
+ | Benefit | Description | Value |
86
+ |---------|-------------|-------|
87
+ | Revenue Increase | {Description} | ${amount}/year |
88
+ | Cost Savings | {Description} | ${amount}/year |
89
+ | Efficiency Gains | {Description} | ${amount}/year |
90
+ | **Total Annual Benefit** | | **${total}/year** |
91
+
92
+ #### ROI Calculation
93
+
94
+ - **Total Initial Investment:** ${amount}
95
+ - **Annual Net Benefit:** ${annual benefit - annual cost}
96
+ - **Payback Period:** {X months/years}
97
+ - **3-Year ROI:** {percentage}%
98
+ - **5-Year ROI:** {percentage}%
99
+
100
+ ### Risk-Adjusted ROI
101
+
102
+ {Consider risks and their probability/impact on ROI}
103
+
104
+ - **Best Case:** {ROI percentage}%
105
+ - **Expected Case:** {ROI percentage}%
106
+ - **Worst Case:** {ROI percentage}%
107
+
108
+ ---
109
+
110
+ ## Risk Assessment
111
+
112
+ ### Business Risks
113
+
114
+ | Risk | Probability | Impact | Mitigation Strategy |
115
+ |------|-------------|--------|---------------------|
116
+ | {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
117
+ | {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
118
+ | {Risk 3} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
119
+
120
+ ### Technical Risks
121
+
122
+ | Risk | Probability | Impact | Mitigation Strategy |
123
+ |------|-------------|--------|---------------------|
124
+ | {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
125
+ | {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
126
+
127
+ ---
128
+
129
+ ## Alternatives Considered
130
+
131
+ ### Option 1: {Option Name}
132
+
133
+ **Cost:** ${amount}
134
+ **ROI:** {percentage}%
135
+ **Pros:** {Brief list}
136
+ **Cons:** {Brief list}
137
+ **Why not chosen:** {Reason}
138
+
139
+ ### Option 2: {Option Name}
140
+
141
+ **Cost:** ${amount}
142
+ **ROI:** {percentage}%
143
+ **Pros:** {Brief list}
144
+ **Cons:** {Brief list}
145
+ **Why not chosen:** {Reason}
146
+
147
+ ### Option 3: Do Nothing
148
+
149
+ **Cost:** ${opportunity cost}
150
+ **Impact:** {Description of impact of not acting}
151
+ **Why not chosen:** {Reason}
152
+
153
+ ---
154
+
155
+ ## Decision Outcome
156
+
157
+ **Chosen option:** "{Option X}"
158
+
159
+ ### Justification
160
+
161
+ {Explain why this option provides the best business value, considering costs, benefits, risks, and strategic alignment}
162
+
163
+ ### Success Criteria
164
+
165
+ {How will we measure success?}
166
+
167
+ - {Criterion 1}
168
+ - {Criterion 2}
169
+ - {Criterion 3}
170
+
171
+ ---
172
+
173
+ ## Implementation Timeline
174
+
175
+ | Phase | Duration | Key Milestones | Cost |
176
+ |-------|----------|----------------|------|
177
+ | Phase 1: {Name} | {X weeks} | {Milestones} | ${amount} |
178
+ | Phase 2: {Name} | {X weeks} | {Milestones} | ${amount} |
179
+ | Phase 3: {Name} | {X weeks} | {Milestones} | ${amount} |
180
+
181
+ **Total Duration:** {X months}
182
+
183
+ ---
184
+
185
+ ## Stakeholder Impact
186
+
187
+ ### Internal Stakeholders
188
+
189
+ | Stakeholder | Impact | Change Required | Support Level |
190
+ |-------------|--------|-----------------|---------------|
191
+ | {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
192
+ | {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
193
+
194
+ ### External Stakeholders
195
+
196
+ | Stakeholder | Impact | Communication Plan |
197
+ |-------------|--------|--------------------|
198
+ | {Customers} | {Description} | {Plan} |
199
+ | {Partners} | {Description} | {Plan} |
200
+
201
+ ---
202
+
203
+ ## Approval
204
+
205
+ ### Recommendation
206
+
207
+ {Clear recommendation with supporting rationale}
208
+
209
+ ### Required Approvals
210
+
211
+ - [ ] {Business Owner}
212
+ - [ ] {Finance}
213
+ - [ ] {Technical Lead}
214
+ - [ ] {Executive Sponsor}
215
+
216
+ ### Approval Date
217
+
218
+ {Date when decision was approved}
219
+
220
+ ---
221
+
222
+ ## More Information
223
+
224
+ ### References
225
+
226
+ - {Link to market research}
227
+ - {Link to competitive analysis}
228
+ - {Link to technical feasibility study}
229
+
230
+ ### Appendices
231
+
232
+ - {Link to detailed financial model}
233
+ - {Link to risk analysis}
234
+ - {Link to stakeholder analysis}
235
+