Back to Planning With Files

Hallazgos y Decisiones

skills/planning-with-files-es/templates/findings.md

2.37.04.1 KB
Original Source

Hallazgos y Decisiones

<!-- QUÉ: Tu base de conocimientos para la tarea. Almacena todo lo que descubres y decides. POR QUÉ: Las ventanas de contexto son limitadas. Este archivo es tu "memoria externa" - persistente e ilimitada. CUÁNDO: Actualiza después de CUALQUIER descubrimiento, especialmente después de 2 operaciones view/browser/search (Regla de 2 Acciones). -->

Requisitos

<!-- QUÉ: Lo que el usuario solicitó, desglosado en requisitos específicos. POR QUÉ: Mantiene los requisitos visibles para que no olvides lo que estás construyendo. CUÁNDO: Completa esto durante la Fase 1 (Requisitos y Descubrimiento). EJEMPLO: - Interfaz de línea de comandos - Agregar tareas - Listar todas las tareas - Eliminar tareas - Implementación en Python --> <!-- Capturado de la solicitud del usuario -->

Hallazgos de Investigación

<!-- QUÉ: Descubrimientos clave de búsquedas web, lectura de documentación o exploración. POR QUÉ: El contenido multimedia (imágenes, resultados del navegador) no persiste. Escríbelo inmediatamente. CUÁNDO: Después de CADA 2 operaciones view/browser/search, actualiza esta sección (Regla de 2 Acciones). EJEMPLO: - El módulo argparse de Python soporta subcomandos para diseño CLI limpio - El módulo JSON maneja persistencia de archivos fácilmente - Patrón estándar: python script.py <comando> [argumentos] --> <!-- Descubrimientos clave durante la exploración -->

Decisiones Técnicas

<!-- QUÉ: Elecciones de arquitectura e implementación que has tomado, con su razonamiento. POR QUÉ: Olvidarás por qué elegiste una tecnología o enfoque. Esta tabla preserva ese conocimiento. CUÁNDO: Actualiza cuando hagas una elección técnica significativa. EJEMPLO: | Usar JSON para almacenamiento | Simple, legible por humanos, soporte integrado en Python | | argparse con subcomandos | CLI limpio: python todo.py add "tarea" | --> <!-- Decisiones tomadas con justificación -->
DecisiónJustificación

Problemas Encontrados

<!-- QUÉ: Problemas que encontraste y cómo los resolviste. POR QUÉ: Similar a los errores en task_plan.md, pero enfocado en problemas más amplios (no solo errores de código). CUÁNDO: Documenta cuando encuentres bloqueos o desafíos inesperados. EJEMPLO: | Archivo vacío causa JSONDecodeError | Se agregó verificación explícita de archivo vacío antes de json.load() | --> <!-- Errores y cómo fueron resueltos -->
ProblemaResolución

Recursos

<!-- QUÉ: URLs, rutas de archivos, referencias de API, enlaces de documentación que has encontrado útiles. POR QUÉ: Referencia fácil para después. No pierdas enlaces importantes en el contexto. CUÁNDO: Agrega según descubras recursos útiles. EJEMPLO: - Documentación de argparse de Python: https://docs.python.org/3/library/argparse.html - Estructura del proyecto: src/main.py, src/utils.py --> <!-- URLs, rutas de archivos, referencias de API -->

Hallazgos Visuales/Navegador

<!-- QUÉ: Información que aprendiste de ver imágenes, PDFs o resultados del navegador. POR QUÉ: CRÍTICO - El contenido visual/multimedia no persiste en el contexto. Debe capturarse como texto. CUÁNDO: INMEDIATAMENTE después de ver imágenes o resultados del navegador. ¡No esperes! EJEMPLO: - La captura de pantalla muestra que el formulario de inicio de sesión tiene campos de email y contraseña - El navegador muestra que la API devuelve JSON con claves "status" y "data" --> <!-- CRÍTICO: Actualizar después de cada 2 operaciones view/browser --> <!-- El contenido multimedia debe capturarse como texto inmediatamente -->

<!-- RECORDATORIO: La Regla de 2 Acciones Después de cada 2 operaciones view/browser/search, DEBES actualizar este archivo. Esto previene que la información visual se pierda cuando el contexto se reinicia. -->

Actualiza este archivo después de cada 2 operaciones view/browser/search Esto previene que la información visual se pierda