¿QUÉ ES EL SPEC DRIVEN DEVELOPMENT (SDD)?

# agents.md - Sistema de Gestión de Tareas (TaskFlow)

## 1. Descripción del Proyecto
TaskFlow es una API REST + panel simple para gestión de tareas personales y de equipo.
Los usuarios pueden registrarse, crear proyectos, asignar tareas, cambiar estados y recibir notificaciones básicas.

Objetivo principal: Aprender y aplicar buenas prácticas de PHP moderno, arquitectura limpia y desarrollo con IA.

## 2. Stack Tecnológico
- PHP 8.3+
- Composer
- MySQL 8
- PDO (sin ORM)
- JWT para autenticación
- PHPUnit para testing
- Estructura tipo MVC + Services
- Servidor: PHP built-in o Apache/Nginx
- Frontend: Ninguno por ahora (solo API). Más adelante se podrá añadir.

## 3. Estructura de Carpetas
taskflow/
├── public/
│   └── index.php
├── src/
│   ├── Controllers/
│   ├── Models/
│   ├── Services/
│   ├── Middleware/
│   └── Helpers/
├── config/
│   └── database.php
├── database/
│   └── migrations/
├── tests/
├── vendor/
├── .env
├── composer.json
└── agents.md

## 4. Convenciones de Código
- PSR-12
- Tipado estricto (`declare(strict_types=1);`)
- Nombres en inglés para clases, métodos y variables
- Comentarios en español solo cuando sea necesario
- Un controlador por recurso
- Toda la lógica de negocio va en Services
- Nunca lógica de negocio en Controllers ni Models
- Usar prepared statements siempre
- Respuestas JSON estandarizadas:
  json
  {
    "success": true|false,
    "message": "...",
    "data": {}
  }