a8fc9c7715
* fix(shellcheck): declare and assign separately in router.sh (SC2155) * feat(plugin): enhance context management and skill invocation - Update .context-manifest.json to include profile and detailed source information. - Revise context-scout.md to clarify context root discovery and navigation. - Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger). - Streamline install-context.md for clarity and remove interactive profile selection. - Improve oac-status.md to provide a more comprehensive status report. - Add OAC system paths to session-start.sh for better context management. - Remove obsolete skills and improve documentation for existing commands.
3.2 KiB
3.2 KiB
Decisions Log
Record major architectural and business decisions with full context. This prevents "why was this done?" debates.
Quick Reference
- Purpose: Document decisions so future team members understand context
- Format: Each decision as a separate entry
- Status: Decided | Pending | Under Review | Deprecated
Decision Template
## [Decision Title]
**Date**: YYYY-MM-DD
**Status**: [Decided/Pending/Under Review/Deprecated]
**Owner**: [Who owns this decision]
### Context
[What situation prompted this decision? What was the problem or opportunity?]
### Decision
[What was decided? Be specific about the choice made.]
### Rationale
[Why this decision? What were the alternatives and why were they rejected?]
### Alternatives Considered
| Alternative | Pros | Cons | Why Rejected? |
|-------------|------|------|---------------|
| [Alt 1] | [Pros] | [Cons] | [Why not chosen] |
| [Alt 2] | [Pros] | [Cons] | [Why not chosen] |
### Impact
**Positive**: [What this enables or improves]
**Negative**: [What trade-offs or limitations this creates]
**Risk**: [What could go wrong]
### Related
- [Links to related decisions, PRs, issues, or documentation]
Decision: [Title]
Date: YYYY-MM-DD Status: [Status] Owner: [Owner]
Context
[What was happening? Why did we need to decide?]
Decision
[What we decided]
Rationale
[Why this was the right choice]
Alternatives Considered
| Alternative | Pros | Cons | Why Rejected? |
|---|---|---|---|
| [Option A] | [Good things] | [Bad things] | [Reason] |
| [Option B] | [Good things] | [Bad things] | [Reason] |
Impact
- Positive: [What we gain]
- Negative: [What we trade off]
- Risk: [What to watch for]
Related
- [Link to PR #000]
- [Link to issue #000]
- [Link to documentation]
Decision: [Title]
Date: YYYY-MM-DD Status: [Status] Owner: [Owner]
Context
[What was happening?]
Decision
[What we decided]
Rationale
[Why this was right]
Alternatives Considered
| Alternative | Pros | Cons | Why Rejected? |
|---|---|---|---|
| [Option A] | [Good things] | [Bad things] | [Reason] |
Impact
- Positive: [What we gain]
- Negative: [What we trade off]
Related
- [Link]
Deprecated Decisions
Decisions that were later overturned (for historical context):
| Decision | Date | Replaced By | Why |
|---|---|---|---|
| [Old decision] | [Date] | [New decision] | [Reason] |
Onboarding Checklist
- Understand the philosophy behind major architectural choices
- Know why certain technologies were chosen over alternatives
- Understand trade-offs that were made
- Know where to find decision context when questions arise
- Understand what decisions are pending and why
Related Files
technical-domain.md- Technical implementation affected by these decisionsbusiness-tech-bridge.md- How decisions connect business and technicalliving-notes.md- Current open questions that may become decisions