# Todo Lists

This directory contains detailed todo lists for various framework features and improvements.

## Active Todo Lists

### High Priority
- Currently no high-priority items

### Medium Priority
- **[css-generation-system.md](./css-generation-system.md)** - Comprehensive CSS generation from PHP components
  - Status: Planning Phase
  - Effort: Large (2-3 weeks)
  - Decision needed on architecture approach

### Low Priority
- **[design-system-improvements.md](./design-system-improvements.md)** - Incremental design system enhancements
  - Status: Ongoing
  - Effort: Small (incremental)

## Todo List Guidelines

### File Structure
Each todo list should include:
- **Status**: Planning / In Progress / Blocked / Completed
- **Priority**: High / Medium / Low
- **Estimated Effort**: Small / Medium / Large (with time estimate)
- **Context**: Why this todo exists
- **Phases**: Organized breakdown of tasks
- **Decision Log**: Key decisions to make
- **Notes**: Advantages, challenges, open questions
- **Related Files**: Existing and to-be-created files

### Task Format
- [ ] **Task Title** - Brief description
  - Additional details
  - File references
  - Dependencies

### Status Indicators
- `[ ]` - Todo (not started)
- `[x]` - Done (completed)
- `[~]` - In Progress
- `[!]` - Blocked (waiting on decision/dependency)

### Updating Todos
- Update **Last Updated** date when making changes
- Mark completed tasks with `[x]`
- Add notes about decisions made
- Link to relevant PRs or commits when tasks are completed

## Creating New Todo Lists

When creating a new todo list:

1. Use descriptive filename: `feature-name.md`
2. Include all sections from the template
3. Add entry to this README
4. Link from relevant documentation
5. Discuss with team if high priority

## Completed Todo Lists

Completed todo lists are moved to `docs/todo/completed/` for reference.

---

**Last Updated**: 2025-10-19
