71180983a0
* fix(#3423): standardize on required_reading, retire files_to_read emit tag * test(#3423): flip tag assertions, extend consistency guard to spawner surfaces * fix(#3423): sweep capabilities fragments, regen registry+skills, anchor executor test * chore(#3423): acknowledge tag-rename emitted ripples and workflow growth * chore(#3423): broaden emitted-ripple acknowledgment to all embedders * chore(#3423): settle emitted-drift acks post-rebase (merge 3004/1689-owned keys) * chore(#3423): drop stale ripple acks, ack execute-phase growth * chore(#3423): restore pristine 3004 fragment, keep only consumed appends * chore(#3423): backfill changeset pr number * chore(#3423): settle emitted-drift acks post-merge (move code-review-fix ripple into 3190, tag-rename ripples into 3191/3297) * chore(#3423): re-arm 3324 ack for execute-phase.md tag-rename ripple * fix(#3423): trim 8 bytes from execute-phase model note to hold ADR-857 margin, re-arm 3370 ack for net +4 growth --------- Co-authored-by: sim <sim@local>
64 lines
1.8 KiB
Markdown
64 lines
1.8 KiB
Markdown
# Discussion Log Template
|
|
|
|
Template for `.planning/phases/XX-name/{phase_num}-DISCUSSION-LOG.md` — audit trail of discuss-phase Q&A sessions.
|
|
|
|
**Purpose:** Software audit trail for decision-making. Captures all options considered, not just the selected one. Separate from CONTEXT.md which is the implementation artifact consumed by downstream agents.
|
|
|
|
**NOT for LLM consumption.** This file should never be referenced in `<required_reading>` blocks or agent prompts.
|
|
|
|
## Format
|
|
|
|
```markdown
|
|
# Phase [X]: [Name] - Discussion Log
|
|
|
|
> **Audit trail only.** Do not use as input to planning, research, or execution agents.
|
|
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
|
|
|
|
**Date:** [ISO date]
|
|
**Phase:** [phase number]-[phase name]
|
|
**Areas discussed:** [comma-separated list]
|
|
|
|
---
|
|
|
|
## [Area 1 Name]
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| [Option 1] | [Brief description] | |
|
|
| [Option 2] | [Brief description] | ✓ |
|
|
| [Option 3] | [Brief description] | |
|
|
|
|
**User's choice:** [Selected option or verbatim free-text response]
|
|
**Notes:** [Any clarifications or rationale provided during discussion]
|
|
|
|
---
|
|
|
|
## [Area 2 Name]
|
|
|
|
...
|
|
|
|
---
|
|
|
|
## Claude's Discretion
|
|
|
|
[Areas delegated to Claude's judgment — list what was deferred and why]
|
|
|
|
## Deferred Ideas
|
|
|
|
[Ideas mentioned but not in scope for this phase]
|
|
|
|
---
|
|
|
|
*Phase: XX-name*
|
|
*Discussion log generated: [date]*
|
|
```
|
|
|
|
## Rules
|
|
|
|
- Generated automatically at end of every discuss-phase session
|
|
- Includes ALL options considered, not just the selected one
|
|
- Includes user's freeform notes and clarifications
|
|
- Clearly marked as audit-only, not an implementation artifact
|
|
- Does NOT interfere with CONTEXT.md generation or downstream agent behavior
|
|
- Committed alongside CONTEXT.md in the same git commit
|