<!-- template:09-lessons-learned -->

# 📝 Lessons Learned: {project-name}

![Step](https://img.shields.io/badge/Step-9-blue?style=for-the-badge)
![Status](https://img.shields.io/badge/Status-Draft-orange?style=for-the-badge)
![Agent](https://img.shields.io/badge/Agent-Orchestrator-purple?style=for-the-badge)

<details open>
<summary><strong>📑 Lessons Contents</strong></summary>

- [📋 Summary](#-summary)
- [📊 Lessons by Severity](#-lessons-by-severity)
- [🔍 Per-Step Findings](#-per-step-findings)
- [💡 Recommendations](#-recommendations)
- [📎 Appendix: Full Lesson Details](#-appendix-full-lesson-details)

</details>

> Generated by orchestrator agent | {date}

| ⬅️ Previous                                            | 📑 Index            | Next ➡️ |
| ------------------------------------------------------ | ------------------- | ------- |
| [07-documentation-index.md](07-documentation-index.md) | [README](README.md) | —       |

**Generated**: {YYYY-MM-DD}
**Workflow Mode**: {production | e2e}
**Total Lessons**: {count}
**Source**: [09-lessons-learned.json](09-lessons-learned.json)

## 📋 Summary

{Executive summary: top systemic issues, self-correction rate, clean run status}

## 📊 Lessons by Severity

| Severity | Count | Examples                        |
| -------- | ----- | ------------------------------- |
| Critical | {n}   | {brief description if count >0} |
| High     | {n}   | {brief description if count >0} |
| Medium   | {n}   | {brief description if count >0} |
| Low      | {n}   | {brief description if count >0} |

## 🔍 Per-Step Findings

{For each step that had lessons: step number, what happened, iterations needed}

| Step | Phase        | Lessons | Key Finding                    |
| ---- | ------------ | ------- | ------------------------------ |
| {n}  | {phase-name} | {count} | {One-line summary of findings} |

## 💡 Recommendations

{Actionable improvements with file paths from applies_to_paths}

| #   | Recommendation | Affected Files | Priority                  |
| --- | -------------- | -------------- | ------------------------- |
| 1   | {action}       | {file paths}   | 🔴 High / 🟡 Med / 🟢 Low |

## 📎 Appendix: Full Lesson Details

{Detailed entries from 09-lessons-learned.json — one subsection per lesson}

---

<div align="center">

| ⬅️ [07-documentation-index.md](07-documentation-index.md) | 🏠 [Project Index](README.md) | ➡️ — |
| --------------------------------------------------------- | ----------------------------- | ---- |

</div>
