---
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}*
Converted and distributed by TomeVault — claim your Tome and manage your conversions.