# Project Issues Log

Gaps, flaws, and enhancements discovered during writing. Not critical — address in revision.

## Open Issues

### ISS-001: [Brief description]

- **Discovered:** Section [X] Task [Z] (YYYY-MM-DD)
- **Type:** [Gap / Flaw / Citation / Structure / Clarity / Future Work]
- **Description:** [What could be improved and why it would help]
- **Impact:** Low (writing is correct, this would enhance)
- **Effort:** [Quick / Medium / Substantial]
- **Suggested section:** [Section number or "Revision"]

## Closed Issues

[Moved here when addressed]

---

## Template Notes

**When to create:** First time an enhancement is deferred during writing.

**Location:** `.planning/ISSUES.md`

**ISS numbering:** Auto-increment from highest existing number.

**Entry format:** Copy the ISS-001 block, update number and fields.

**Closing issues:** Move entire block to "Closed Issues" section, add resolution note.

## Issue Types

| Type | Definition | Example |
|------|------------|---------|
| **Gap** | Missing evidence or argument | "Need citation for claim about X" |
| **Flaw** | Logical issue or weak argument | "Conclusion doesn't follow from premises" |
| **Citation** | Citation needed or incorrect | "Smith (2023) actually says opposite" |
| **Structure** | Organization could improve | "Methods should come before results" |
| **Clarity** | Prose is unclear or awkward | "Paragraph 3 is confusing" |
| **Future Work** | Good idea but out of scope | "Could extend to domain Y" |

## When to Log vs When to Fix

**Log to ISSUES.md:**
- Nice-to-haves discovered during writing
- Improvements that would delay current section
- Ideas for future revision
- Minor clarity issues that don't block comprehension

**Fix immediately (don't log):**
- Factual errors
- Logical contradictions
- Missing required elements
- Broken citations

The distinction: If a reviewer would reject the paper for it, fix it now. If a reviewer might suggest it as an improvement, log it for later.