Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
133 changes: 133 additions & 0 deletions .github/ISSUE_TEMPLATE/decision.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
---
name: Architecture Decision Record (ADR)
about: Document an important architectural or design decision
title: '[ADR] Decision to be made'
labels: adr, decision
assignees: ''
---

## Decision

**Status:** Proposed / Accepted / Superseded
**Date:** YYYY-MM-DD
**Deciders:** [Who is involved in this decision]

**Decision Question:** [What are we deciding?]

---

## Context

**What is the issue we're facing?**

[Describe the forces at play: technical, political, social, project constraints]

**Why does this matter?**

[Impact on the project, users, or architecture]

---

## Options Considered

### Option 1: [Name]

**Pros:**
- Pro 1
- Pro 2

**Cons:**
- Con 1
- Con 2

**Five Cornerstones:**
- Configurability: [impact]
- Modularity: [impact]
- Extensibility: [impact]
- Integration: [impact]
- Automation: [impact]

---

### Option 2: [Name]

**Pros:**
- Pro 1
- Pro 2

**Cons:**
- Con 1
- Con 2

**Five Cornerstones:**
- Configurability: [impact]
- Modularity: [impact]
- Extensibility: [impact]
- Integration: [impact]
- Automation: [impact]

---

### Option 3: [Name] (if applicable)

[Same structure as above]

---

## Decision

**Chosen Option:** Option X

**Rationale:**

[Why this option was chosen. Reference Five Cornerstones alignment, user needs, technical constraints]

---

## Consequences

**Positive:**
- Consequence 1
- Consequence 2

**Negative:**
- Tradeoff 1
- Tradeoff 2

**Neutral:**
- Thing to be aware of

---

## Implementation

**What needs to happen to implement this decision:**

- [ ] Action 1
- [ ] Action 2
- [ ] Action 3

**Related issues:**
- #[issue number] (created from this decision)

---

## Validation

**How will we know if this decision was correct?**

Success criteria:
- Metric 1
- Metric 2

Review date: [When to reassess this decision]

---

## References

**Links to:**
- Related documentation
- Discussion threads
- External resources
- Similar decisions in other projects
85 changes: 85 additions & 0 deletions .github/ISSUE_TEMPLATE/task.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
name: Task
about: A specific deliverable or piece of work
title: '[PHASE X] Brief task description'
labels: task
assignees: ''
---

## Task Description

**Phase:** Phase X
**Milestone:** [Link to milestone]
**Priority:** High / Medium / Low
**Estimated Effort:** X hours/days

[Clear description of what needs to be done and why]

---

## Acceptance Criteria

- [ ] Criterion 1 (clear, testable)
- [ ] Criterion 2
- [ ] Criterion 3

---

## Five Cornerstones Impact

**Configurability:** [How does this affect configurability? N/A if not applicable]

**Modularity:** [How does this affect modularity?]

**Extensibility:** [How does this affect extensibility?]

**Integration:** [How does this affect integration?]

**Automation:** [How does this affect automation?]

---

## Implementation Notes

**Files to modify/create:**
- `path/to/file1.ts`
- `path/to/file2.ts`

**Dependencies:**
- Depends on: #[issue number] (if applicable)
- Blocks: #[issue number] (if applicable)

**Technical approach:**
[Brief notes on how to implement this]

---

## Testing

**How to verify this works:**
1. Step 1
2. Step 2
3. Expected result

---

## Documentation

**What documentation needs updating:**
- [ ] README.md
- [ ] ARCHITECTURE_DESIGN.md
- [ ] Code comments
- [ ] Other: ___________

---

## Done Checklist

Before closing this issue:

- [ ] Acceptance criteria met
- [ ] Five Cornerstones validation passed
- [ ] Tests written/updated (if applicable)
- [ ] Documentation updated
- [ ] Code committed and pushed
- [ ] Reviewed (if applicable)
Loading
Loading