@mytechtoday/augment-extensions 1.2.2 → 1.3.1

package/augment-extensions/workflows/adr-support/templates/madr-elaborate.md

@@ -0,0 +1,197 @@
+# ADR-{number}: {Title}
+
+**Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
+
+**Date:** {YYYY-MM-DD}
+
+**Deciders:** {List of people involved in the decision}
+
+**Technical Story:** {Optional: Link to related issue, spec, or task}
+
+---
+
+## Context and Problem Statement
+
+{Describe the context and problem statement in detail. What is the issue that motivates this decision? What are the business and technical drivers?}
+
+### Background
+
+{Provide additional background information that helps understand the problem domain}
+
+### Assumptions
+
+{List key assumptions made in this decision}
+
+- {Assumption 1}
+- {Assumption 2}
+- {Assumption 3}
+
+### Constraints
+
+{List constraints that limit the solution space}
+
+- {Constraint 1}
+- {Constraint 2}
+- {Constraint 3}
+
+---
+
+## Decision Drivers
+
+{List the key factors that influenced this decision, in priority order}
+
+1. {High priority driver}
+2. {Medium priority driver}
+3. {Lower priority driver}
+
+---
+
+## Considered Options
+
+### Option 1: {Option Name}
+
+**Description:** {Detailed description of this option}
+
+**Pros:**
+- {Advantage 1}
+- {Advantage 2}
+- {Advantage 3}
+
+**Cons:**
+- {Disadvantage 1}
+- {Disadvantage 2}
+- {Disadvantage 3}
+
+**Cost/Effort:** {Estimation of implementation cost and effort}
+
+**Risk:** {Risk assessment: Low | Medium | High}
+
+---
+
+### Option 2: {Option Name}
+
+**Description:** {Detailed description of this option}
+
+**Pros:**
+- {Advantage 1}
+- {Advantage 2}
+- {Advantage 3}
+
+**Cons:**
+- {Disadvantage 1}
+- {Disadvantage 2}
+- {Disadvantage 3}
+
+**Cost/Effort:** {Estimation of implementation cost and effort}
+
+**Risk:** {Risk assessment: Low | Medium | High}
+
+---
+
+### Option 3: {Option Name}
+
+**Description:** {Detailed description of this option}
+
+**Pros:**
+- {Advantage 1}
+- {Advantage 2}
+- {Advantage 3}
+
+**Cons:**
+- {Disadvantage 1}
+- {Disadvantage 2}
+- {Disadvantage 3}
+
+**Cost/Effort:** {Estimation of implementation cost and effort}
+
+**Risk:** {Risk assessment: Low | Medium | High}
+
+---
+
+## Decision Outcome
+
+**Chosen option:** "{Option X}", because:
+
+{Provide detailed justification for the chosen option. Explain how it best addresses the decision drivers and why it was preferred over the alternatives.}
+
+### Consequences
+
+#### Positive Consequences
+
+- {Positive consequence 1 with explanation}
+- {Positive consequence 2 with explanation}
+- {Positive consequence 3 with explanation}
+
+#### Negative Consequences
+
+- {Negative consequence 1 with mitigation strategy}
+- {Negative consequence 2 with mitigation strategy}
+- {Negative consequence 3 with mitigation strategy}
+
+#### Neutral Consequences
+
+- {Neutral consequence 1}
+- {Neutral consequence 2}
+
+---
+
+## Validation
+
+{How will we know if this decision was correct? Define success criteria and metrics.}
+
+### Success Criteria
+
+- {Measurable criterion 1}
+- {Measurable criterion 2}
+- {Measurable criterion 3}
+
+### Metrics
+
+- {Metric 1: baseline → target}
+- {Metric 2: baseline → target}
+
+### Review Schedule
+
+- {When to review this decision: e.g., "After 3 months" or "After first production deployment"}
+
+---
+
+## Implementation Plan
+
+{Optional: High-level implementation plan}
+
+### Phase 1: {Phase Name}
+- {Task 1}
+- {Task 2}
+
+### Phase 2: {Phase Name}
+- {Task 1}
+- {Task 2}
+
+### Migration Strategy
+
+{If applicable, describe how to migrate from current state to new state}
+
+---
+
+## More Information
+
+### References
+
+- {Link to research, documentation, or external resources}
+- {Link to proof of concept or prototype}
+- {Link to similar decisions in other projects}
+
+### Related Decisions
+
+- Supersedes: [ADR-{number}]({link})
+- Superseded by: [ADR-{number}]({link})
+- Related to: [ADR-{number}]({link})
+
+### Stakeholder Feedback
+
+{Optional: Summary of feedback from key stakeholders}
+
+- **{Stakeholder 1}:** {Feedback summary}
+- **{Stakeholder 2}:** {Feedback summary}
+

package/augment-extensions/workflows/adr-support/templates/madr-simple.md

@@ -0,0 +1,68 @@
+# ADR-{number}: {Title}
+
+**Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
+
+**Date:** {YYYY-MM-DD}
+
+**Deciders:** {List of people involved in the decision}
+
+**Technical Story:** {Optional: Link to related issue, spec, or task}
+
+---
+
+## Context and Problem Statement
+
+{Describe the context and problem statement in 2-3 sentences. What is the issue that motivates this decision?}
+
+---
+
+## Decision Drivers
+
+{Optional: List the key factors that influenced this decision}
+
+- {Driver 1}
+- {Driver 2}
+- {Driver 3}
+
+---
+
+## Considered Options
+
+- {Option 1}
+- {Option 2}
+- {Option 3}
+
+---
+
+## Decision Outcome
+
+**Chosen option:** "{Option X}", because {justification in 1-2 sentences}.
+
+### Consequences
+
+- **Good:** {Positive consequence 1}
+- **Good:** {Positive consequence 2}
+- **Bad:** {Negative consequence 1}
+- **Bad:** {Negative consequence 2}
+
+---
+
+## Validation
+
+{Optional: How will we know if this decision was correct?}
+
+- {Success criterion 1}
+- {Success criterion 2}
+
+---
+
+## More Information
+
+{Optional: Additional context, references, or implementation notes}
+
+### Links
+
+- {Link to related documentation}
+- {Link to implementation PR}
+- {Link to related ADR}
+

package/augment-extensions/workflows/adr-support/templates/nygard.md

@@ -0,0 +1,84 @@
+# ADR-{number}: {Title}
+
+**Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
+
+**Date:** {YYYY-MM-DD}
+
+**Deciders:** {List of people involved in the decision}
+
+**Technical Story:** {Optional: Link to related issue, spec, or task}
+
+---
+
+## Context
+
+{Describe the context and problem statement. What is the issue that motivates this decision or change?}
+
+### Forces
+
+{Optional: Describe the forces at play (technical, political, social, project-related). These are the constraints and considerations that influence the decision.}
+
+- {Force 1}
+- {Force 2}
+- {Force 3}
+
+---
+
+## Decision
+
+{Describe the decision that was made. Use active voice: "We will..."}
+
+### Rationale
+
+{Explain why this decision was made. What are the key reasons?}
+
+---
+
+## Consequences
+
+### Positive
+
+{What becomes easier or better as a result of this decision?}
+
+- {Positive consequence 1}
+- {Positive consequence 2}
+
+### Negative
+
+{What becomes harder or worse as a result of this decision?}
+
+- {Negative consequence 1}
+- {Negative consequence 2}
+
+### Neutral
+
+{What are the neutral consequences or trade-offs?}
+
+- {Neutral consequence 1}
+- {Neutral consequence 2}
+
+---
+
+## Related Decisions
+
+{Optional: List related ADRs}
+
+- Supersedes: [ADR-{number}]({link})
+- Superseded by: [ADR-{number}]({link})
+- Related to: [ADR-{number}]({link})
+
+---
+
+## Notes
+
+{Optional: Any additional notes, references, or links}
+
+### References
+
+- {Reference 1}
+- {Reference 2}
+
+### Implementation Notes
+
+{Optional: Notes about implementation, migration path, or timeline}
+