# AI_PROGRESS.md

> This file tracks ALL work performed by AI agents on this codebase.
> Copy this template to your project's `docs/` folder.

## Purpose

This file serves as:
1. **Work Log** - What has been done, when, and by which agent
2. **Status Tracker** - Current state of ongoing work
3. **Knowledge Base** - Decisions made, blockers found, lessons learned
4. **Handoff Document** - Context for new conversations or agents

---

## How to Use This Template

1. Copy this file to your project: `docs/AI_PROGRESS.md`
2. Update after each significant work session
3. Keep completed items for historical reference
4. Move old items to Archive section periodically

---

## Status Definitions

| Status | Meaning |
|--------|---------|
| `NOT_STARTED` | Work item defined but not begun |
| `IN_PROGRESS` | Currently being worked on |
| `BLOCKED` | Cannot proceed - needs resolution |
| `IN_REVIEW` | Code written, awaiting review |
| `COMPLETED` | Work finished and verified |
| `DEFERRED` | Postponed to future iteration |

---

## Current Sprint / Focus

<!-- Update this section with current priorities -->

**Sprint Goal**: [Describe the current focus area]

**Priority Order**:
1. [Highest priority item]
2. [Second priority]
3. [Third priority]

---

## In Progress

<!-- Items currently being worked on -->

### [Feature/Task Name]
- **Status**: `IN_PROGRESS`
- **Started**: YYYY-MM-DD
- **Agent**: [Which agent is working on this]
- **Description**: [What is being done]
- **Files Modified**:
  - `src/components/Example.tsx` - [change description]
  - `src/hooks/useExample.ts` - [change description]
- **Notes**: [Any relevant context]
- **Blockers**: None | [Description of blocker]

---

## Blocked Items

<!-- Items that cannot proceed -->

### [Blocked Item Name]
- **Status**: `BLOCKED`
- **Blocked Since**: YYYY-MM-DD
- **Blocker**: [What is preventing progress]
- **Resolution Needed**: [What needs to happen to unblock]
- **Owner**: [Who can resolve this]

---

## Completed (This Session)

<!-- Recently completed items - move to Archive periodically -->

### [Completed Feature Name]
- **Status**: `COMPLETED`
- **Completed**: YYYY-MM-DD
- **Agent**: [Which agent completed this]
- **Description**: [What was done]
- **Files Changed**:
  - `src/components/Feature.tsx` - Created new component
  - `src/hooks/useFeature.ts` - Added custom hook
- **Verification**:
  - [x] TypeScript builds without errors
  - [x] Lint passes
  - [x] Tested on iOS
  - [x] Tested on Android
- **Constraints Followed**:
  - [x] Component under 300 lines
  - [x] Used required patterns
  - [x] No forbidden dependencies

---

## Decisions Log

<!-- Important decisions made during development -->

### [Decision Title]
- **Date**: YYYY-MM-DD
- **Context**: [Why this decision was needed]
- **Options Considered**:
  1. [Option A] - [Pros/Cons]
  2. [Option B] - [Pros/Cons]
- **Decision**: [What was decided]
- **Rationale**: [Why this option was chosen]
- **Impact**: [What this affects going forward]

---

## Known Issues

<!-- Issues discovered but not yet addressed -->

| Issue | Severity | Found | Status |
|-------|----------|-------|--------|
| [Description] | High/Med/Low | YYYY-MM-DD | [Status] |

---

## Technical Debt

<!-- Items that need future attention -->

| Debt Item | Priority | Notes |
|-----------|----------|-------|
| [Description] | High/Med/Low | [Context] |

---

## Questions for User

<!-- Items needing human decision -->

1. [Question that needs user input]
   - Context: [Why this matters]
   - Options: [A, B, C]

---

## Archive

<!-- Move completed items here to keep the main sections clean -->

<details>
<summary>Completed Items (Click to expand)</summary>

### [Archived Item 1]
- **Completed**: YYYY-MM-DD
- **Description**: [What was done]

### [Archived Item 2]
- **Completed**: YYYY-MM-DD
- **Description**: [What was done]

</details>

---

## Session Notes

<!-- Quick notes from current/recent sessions -->

### Session: YYYY-MM-DD
- Started: [What was the initial request]
- Accomplished: [What got done]
- Remaining: [What's left]
- Next Steps: [Recommendations for next session]

---

## File Change Log

<!-- Track significant file changes -->

| Date | File | Change Type | Description |
|------|------|-------------|-------------|
| YYYY-MM-DD | `path/to/file.tsx` | Created/Modified/Deleted | [Brief description] |

---

## Metrics (Optional)

<!-- Track progress metrics if useful -->

| Metric | Value | Target |
|--------|-------|--------|
| Components Created | X | - |
| Tests Written | X | - |
| TypeScript Coverage | X% | 100% |
| Build Time | Xs | <30s |

---

*Last Updated: YYYY-MM-DD by [Agent Name]*