# Summary: Phase {phase_number} - {phase_name}

<!-- 
Template for phase execution summary.
Generated by reis_executor after completing a plan.
Provides documentation of what was built and any deviations.
-->

**Status**: ✅ Complete / ⚠️ Partial / ❌ Failed

**Executed**: {execution_date}
**Duration**: {time_taken}
**Executor**: {agent_name}

## Objective

{One-sentence description of what this phase was meant to achieve}

## What Was Built

<!-- High-level description of implemented functionality -->

{Narrative description of what was implemented, focusing on user-visible outcomes and capabilities added}

### Key Deliverables

- {Deliverable 1: brief description}
- {Deliverable 2: brief description}
- {Deliverable 3: brief description}

## Tasks Completed

<!-- List of completed tasks with commit references -->

| Task | Description | Commit | Status |
|------|-------------|--------|--------|
| {task_number} | {task_name} | `{commit_hash}` | ✅ |
| {task_number} | {task_name} | `{commit_hash}` | ✅ |
| {task_number} | {task_name} | `{commit_hash}` | ✅ |
| {task_number} | {task_name} | `{commit_hash}` | ⚠️ Partial |

**Completion Rate**: {completed}/{total} tasks ({percentage}%)

## Files Changed

<!-- Summary of file changes organized by type -->

### Created

- `{path/to/new/file.ts}` - {Brief description}
- `{path/to/new/file.ts}` - {Brief description}

### Modified

- `{path/to/existing/file.ts}` - {What changed}
- `{path/to/existing/file.ts}` - {What changed}

### Deleted

- `{path/to/removed/file.ts}` - {Why removed}

**Total**: {n} files created, {n} modified, {n} deleted

## Deviations from Plan

<!-- Document any changes made during execution -->

### Auto-Fixed Issues

<!-- Bugs or gaps fixed automatically per deviation rules -->

| Issue | What Was Wrong | How Fixed | Impact |
|-------|----------------|-----------|--------|
| {issue_1} | {Description of problem} | {Fix applied} | {None/Minor/Moderate} |
| {issue_2} | {Description of problem} | {Fix applied} | {None/Minor/Moderate} |

### Additions

<!-- Functionality added that wasn't in original plan -->

| Addition | Why Needed | Files Affected |
|----------|-----------|----------------|
| {addition_1} | {Rationale} | `{files}` |

### Skipped Items

<!-- Tasks or sub-tasks that were skipped -->

| Item | Why Skipped | Future Work? |
|------|-------------|--------------|
| {item_1} | {Reason} | Yes / No |

### Plan Accuracy

- **Accurate**: {percentage}% of plan executed as written
- **Deviations**: {count} changes from original plan

**OR**

None - plan executed exactly as written.

## Verification Results

<!-- Output from verification commands -->

### Automated Tests

```
{Test output or summary}
```

**Test Results**: {passed}/{total} passing

### Manual Verification

| Check | Result | Notes |
|-------|--------|-------|
| {check_1} | ✅ / ❌ | {observations} |
| {check_2} | ✅ / ❌ | {observations} |

### Success Criteria Status

| Criterion | Met? | Evidence |
|-----------|------|----------|
| {criterion_1} | ✅ / ❌ | {How verified} |
| {criterion_2} | ✅ / ❌ | {How verified} |
| {criterion_3} | ✅ / ❌ | {How verified} |

## Decisions Made

<!-- Technical or architectural decisions made during execution -->

| Decision | Context | Choice Made | Rationale |
|----------|---------|-------------|-----------|
| {decision_1} | {Why needed} | {What chosen} | {Why this option} |
| {decision_2} | {Why needed} | {What chosen} | {Why this option} |

**OR**

No significant decisions required - plan was detailed enough.

## Issues Encountered

<!-- Problems that arose during execution -->

### Resolved Issues

| Issue | Root Cause | Resolution | Time Impact |
|-------|------------|------------|-------------|
| {issue_1} | {Why it happened} | {How fixed} | {+X minutes} |

### Unresolved Issues

| Issue | Impact | Recommended Action | Priority |
|-------|--------|-------------------|----------|
| {issue_1} | {Effect on project} | {What to do} | High/Medium/Low |

**OR**

No significant issues encountered.

## Technical Debt

<!-- Shortcuts taken that should be addressed later -->

| Item | Description | Recommended Fix | Priority |
|------|-------------|-----------------|----------|
| {debt_1} | {What was deferred} | {Ideal solution} | High/Medium/Low |

**OR**

No technical debt introduced.

## Learnings

<!-- Insights for future phases -->

### What Worked Well

- {Positive observation 1}
- {Positive observation 2}

### What Could Improve

- {Improvement suggestion 1}
- {Improvement suggestion 2}

### Recommendations for Next Phase

- {Recommendation 1}
- {Recommendation 2}

## Next Steps

<!-- What should happen after this phase -->

### Immediate (Before Next Phase)

- [ ] {Action item 1}
- [ ] {Action item 2}

### Next Phase Prerequisites

- {Prerequisite 1}
- {Prerequisite 2}

### Future Considerations

- {Consideration for later phases}

**OR**

None - ready for next phase.

## Metrics

<!-- Quantitative summary -->

| Metric | Value |
|--------|-------|
| Tasks Completed | {n}/{total} |
| Files Changed | {n} |
| Lines Added | {n} |
| Lines Removed | {n} |
| Tests Added | {n} |
| Test Coverage | {n}% |
| Execution Time | {duration} |
| Commits Made | {n} |

---

*Summary generated on {execution_date}*
*Phase: {phase_number} - {phase_name}*
*Plan: {plan_file_path}*