Architecture Decision Log: [Book Title]
**Book:** [Book Title] **Created:** [Date] **Last Updated:** [Date]
Overview
Architecture Decision Log: [Book Title]
Book: [Book Title]
Created: [Date]
Last Updated: [Date]
How to Use This Log
This log captures significant architectural decisions—choices that shape the book's structure, content, or approach. Each entry records what was decided, why, and what alternatives were considered.
When to log a decision:
- Framework or structure choices
- Chapter ordering or sequencing
- What to include or exclude
- How to handle reader objections
- Pacing or weight decisions
- Section boundaries
- Through-line placement
- Any choice you might want to revisit or explain later
Status definitions:
- Active: Current decision in effect
- Superseded: Replaced by a later decision (note which one)
- Under Review: Being reconsidered
Decision Index
| # | Date | Decision | Impact | Confidence | Status |
|---|---|---|---|---|---|
| 1 | [Date] | [Brief] | Book/Section/Chapter | H/M/L | Active |
| 2 | [Date] | [Brief] | [Scope] | H/M/L | Active |
| ... | ... | ... | ... | ... | ... |
Decisions
Decision 1
Date: [Date]
Status: Active / Superseded by #X / Under Review
Impact: Book-level / Section-level / Chapter-level
Confidence: High / Medium / Low
Decision:
[Clear statement of what was decided]
Reasoning:
[Why this decision was made. What factors were considered. What makes this the
right choice for the reader.]
Alternatives Considered:
- [Alternative 1]: [Why rejected]
- [Alternative 2]: [Why rejected]
Initiated By: Claude recommendation / Author choice / Mutual discussion
Dependencies:
[Does this decision depend on other decisions? Does it affect other decisions?]
- Depends on: [Decision #X, or "None"]
- Affects: [Decisions #Y, #Z, or "None"]
Revisit Trigger:
[Under what circumstances should this decision be reconsidered? Or "None—high
confidence"]
Decision 2
Date: [Date]
Status: [Status]
Impact: [Scope]
Confidence: [Level]
Decision:
...
Reasoning:
...
Alternatives Considered:
Initiated By: ...
Dependencies:
Revisit Trigger:
...
Decision 3
[Continue as needed...]
Superseded Decisions
Decisions that have been replaced. Kept for historical reference.
Decision X (Superseded)
Date: [Original date]
Superseded: [Date] by Decision #[Y]
Original Decision: [What was decided]
Why Superseded: [What changed, why the new decision is better]
Decisions Under Review
Decisions being reconsidered. Include current thinking.
Decision X (Under Review)
Original Decision: ...
Under Review Since: [Date]
Reason for Review: [What triggered reconsideration]
Current Thinking: [Where the discussion stands]
Expected Resolution: [When/how this will be resolved]
Decision Patterns
Observations about decision-making for future reference:
- [Pattern observed—e.g., "Reader experience consistently trumps author preference"]
- [Pattern observed]
Quick Reference: Key Structural Decisions
The most important decisions shaping this book's architecture:
- Framework: [Decision #X] — [Brief]
- Section Structure: [Decision #Y] — [Brief]
- Opening Strategy: [Decision #Z] — [Brief]
- Pacing Approach: [Decision #W] — [Brief]