walkthrough-generate

---
run: {run-id}
work_item: {work-item-id}
intent: {intent-id}
generated: {timestamp}
mode: {mode}
---

# Implementation Walkthrough: {title}

## Summary

{2-3 sentences describing what was implemented}

## Structure Overview

{High-level description of how pieces fit together - NO CODE}

## Architecture (if multi-component)

### Pattern Used
{Pattern and rationale - e.g., Repository pattern for data access abstraction}

### Layer Structure
```text
┌─────────────────────────────┐
│      Presentation           │
├─────────────────────────────┤
│      Application            │
├─────────────────────────────┤
│        Domain               │
├─────────────────────────────┤
│     Infrastructure          │
└─────────────────────────────┘
```

## Files Changed

### Created

| File | Purpose |
|------|---------|
| `{path}` | {purpose} |

### Modified

| File | Changes |
|------|---------|
| `{path}` | {changes} |

## Domain Model (if entities created)

### Entities

| Entity | Properties | Business Rules |
|--------|------------|----------------|
| {name} | {props} | {rules} |

### Value Objects

| Value Object | Properties | Constraints |
|--------------|------------|-------------|
| {name} | {props} | {constraints} |

## Key Implementation Details

### 1. {Detail Title}

{description of implementation approach}

## Security Considerations (if applicable)

| Concern | Approach |
|---------|----------|
| {concern} | {approach} |

## Performance Considerations (if applicable)

| Requirement | Implementation |
|-------------|----------------|
| {requirement} | {implementation} |

## Decisions Made

| Decision | Choice | Rationale |
|----------|--------|-----------|
| {decision} | {choice} | {rationale} |

## Deviations from Plan

{Changes from work item plan and why, or "None"}

## Dependencies Added

| Package | Why Needed |
|---------|------------|
| `{package}` | {reason} |

## How to Verify

1. **{Step Title}**

   ```bash
   {command}
   ```

   Expected: {expected output}

## Test Coverage

- Tests added: {count}
- Coverage: {percentage}%
- Status: {passing/failing}

## Ready for Review

- [x] All acceptance criteria met
- [x] Tests passing
- [x] No critical issues
- [ ] Documentation updated (if applicable)
- [x] Developer notes captured

## Developer Notes

{Gotchas, tips, or context for future work - keep brief}

---
*Generated by specs.md - fabriqa.ai FIRE Flow Run {run-id}*