candycong2001-ui/agent-project-playbook

Documentos del Proyecto

Flujo de Trabajo

1. Al inicio de una implementación o diagnóstico sustancial, lee docs/CURRENT_HANDOFF.md y solo las secciones relevantes de los documentos estables.
2. Verifica las afirmaciones de los documentos contra la evidencia actual del repositorio.
3. Durante la exploración o revisión de solo lectura, informa sobre desviaciones sin editar a menos que el usuario autorice cambios.
4. Al inicio de una tarea, reemplaza el objetivo actual y la siguiente acción en CURRENT_HANDOFF.md.
5. Después de un hito verificado, reemplaza el estado actual y la evidencia de verificación; no añadas una línea de tiempo.
6. Antes de la entrega, elimina los detalles de proceso completados y deja un estado listo para continuar.
7. Actualiza BLUEPRINT.md solo cuando cambien la intención del producto, los usuarios, el alcance, las restricciones o la aceptación.
8. Actualiza ARCHITECTURE.md solo cuando cambien los componentes, límites, flujo de datos, comandos verificados, despliegue, reversión o riesgos.
9. Antes de una entrega sustancial, ejecuta python3 .agents/skills/project-docs/scripts/docs_lint.py.

Límites

• El código actual, las pruebas, la configuración, la salida de comandos y las instrucciones del usuario tienen prioridad sobre estos documentos.
• Mantén BLUEPRINT en 160 líneas o menos.
• Mantén ARCHITECTURE en 160 líneas o menos.
• Mantén CURRENT_HANDOFF en 80 líneas o menos.
• Mantén AGENTS en 90 líneas o menos.
• Git almacena el historial. CURRENT_HANDOFF solo almacena el último estado funcional.