¿Qué hace Iterar Proyecto de Investigación?
Usa este skill para mantener un proyecto de investigación honesto a medida que cambia. El hábito central es: clasificar el trabajo, escribir en el lugar más específico y duradero, registrar la evidencia, y luego sincronizar solo los resúmenes y el tablero que los colaboradores necesitan.
Dos reglas lo gobiernan todo:
- Markdown primero, tablero después. Actualiza primero el markdown fuente o la nota
_ai. Solo entonces sincronizaPROJECT_BOARD.html. - El tablero es un mapa, no un registro.
PROJECT_BOARD.htmlmuestra el estado actual y apunta a la evidencia. Nunca almacena registros sin procesar, datos privados o rutas absolutas.
Y un hábito que impulsa la iteración: nueva idea → nuevo subproyecto. Los intentos de experimentación son el núcleo del trabajo. Cuando hay algo que probar, crea un nuevo 0-Project/<fecha>_<slug>/ e itera allí en lugar de sobrescribir o reiterar un intento sin fin. Mantén los subproyectos pequeños y de un solo propósito; no temas a la duplicación. Esto mantiene un historial de solo añadidura y comparable (ver references/project-iteration-system.md).
Los subproyectos también tienen carriles:
- Línea principal — intentos actuales que definen la ruta activa.
- Aparcados — ideas de intentos futuros capturadas temprano porque el pensamiento de investigación no es completamente serial, pero aún no ejecutadas. Nota por defecto:
0-Project/_parking-lot.md. - Archivados — intentos abandonados o reemplazados, mantenidos con una razón de parada y evidencia. Carpeta por defecto:
0-Project/_archive/.
Aparca de forma ligera. Una idea futura puede ser una entrada corta en _ai/task_plan.md, 1-Docs/ o 0-Project/_parking-lot.md; crea una carpeta de intento completa solo cuando la idea tenga suficientes entradas, criterios o valor de transferencia.
Enruta la discusión y los intentos por separado: la discusión, decisión, comparación y explicación del método van a 1-Docs/<fecha>_<tema>.md; las pruebas concretas con entradas, criterios, salidas o resultados van a 0-Project/<fecha>_<slug>/; la discusión local del intento va a 0-Project/<intento>/docs/<fecha>_<tema>.md.
Independiente o dentro de un portafolio. Este skill es autónomo: úsalo solo para un proyecto único en cualquier ruta — no se requiere portafolio. Todo lo que el proyecto necesita (carpetas, archivos de entrada, tablero, memoria de trabajo, política de git) vive dentro de la carpeta del proyecto. Opcionalmente, cuando el proyecto se encuentra dentro de un portafolio (<slug>-project/<project>/), sincroniza el estado, propietario, prioridad y estado público con el tablero del portafolio usando el skill manage-research-portfolio. Cuando se ejecuta de forma independiente, omite cada paso de "tablero de portafolio" y "registro" en este skill — son integraciones opcionales, nunca requisitos previos.
Contrato del Proyecto
Usa esta estructura a menos que el proyecto ya tenga nombres equivalentes. Es el esqueleto copiable de _PROJECT_TEMPLATE.
<project>/
├── README.md entrada: objetivo de una frase, mapa de carpetas, inicio rápido, estado actual
├── PROJECT_GUIDELINES.md reglas de sincronización locales del proyecto, límites de carpetas, clasificación HTML
├── PROJECT_BOARD.html el tablero: mapa del estado actual y navegación
├── GIT_WORKFLOW.md identidad de git + política de confirmación por cambio para este proyecto
├── scripts/
│ └── init_project_git.sh ayudante opcional para establecer identidad y primer commit
├── 0-Project/ intentos / experimentos concretos (un `0-Project/<fecha>_<slug>/` por intento)
├── 1-Docs/
│ └── README.md la entrada de Documentos fija única + índice de temas
├── 2-Data/
│ └── DATA.md fuente, procedencia, permisos, versiones, esquema, QC, límites
├── 3-Paper_Survey/
│ └── README.md cola de lectura, notas de artículos, matriz de evidencia, fuentes de métodos
├── 4-Skills/
│ └── PROJECT_SKILLS.md indicaciones locales del proyecto, reglas de IA, procedimientos reutilizables
└── _ai/
├── project_overview.md objetivo, alcance, estado, propietario, prioridad, siguiente
├── project_board_spec.md cómo se genera/sincroniza PROJECT_BOARD.html desde las fuentes
├── task_plan.md fase actual, plan, bloqueadores, siguiente
├── findings.md hallazgos estables, preguntas abiertas
└── progress.md la sincronización significativa más reciente, acciones, validación, commit
Los archivos raíz son entrada + reglas + tablero + política de git. Todo lo concreto va a la carpeta numerada más adecuada; nunca apiles materiales en la raíz del proyecto, y nunca pongas la visión general del proyecto, las reglas del tablero o las pautas a largo plazo dentro de 0-Project/ (esa carpeta es solo para intentos concretos).
Clasificar Antes de Escribir
Cuando el usuario proporcione material nuevo, elige un lugar de aterrizaje, luego decide si el tablero cambia.
| Intención del usuario | Lugar de aterrizaje | Vista del tablero que puede tocar |
|---|---|---|
| "Esto es una discusión / método / decisión / comparación" | 1-Docs/<fecha>_<tema>.md + actualizar 1-Docs/README.md | Mapa de Documentos |
| "Esto es un experimento / intento concreto" | 0-Project/<fecha>_<slug>/; coloca notas locales del intento bajo su docs/ | Tareas (intentos) |
| "Esto es una nota sobre un intento existente" | 0-Project/<intento>/docs/<fecha>_<tema>.md | usualmente Tareas, a veces Mapa de Documentos si cambia el índice a nivel de proyecto |
| "Esto es una idea de intento futuro" | _ai/task_plan.md, 1-Docs/ o 0-Project/_parking-lot.md; carpeta de intento completa solo si es concreto | usualmente ninguno, o un carril de Tareas aparcadas |
| "Este intento está abandonado / reemplazado" | mantén la carpeta del intento o muévela bajo 0-Project/_archive/; marca como archivado con razón de parada, evidencia y reemplazo | carril de Tareas archivado/colapsado |
| "Esto es información de datos / benchmark" | 2-Data/DATA.md | Materiales (datos) |
| "Esto es un artículo / fuente externa / evidencia" | 3-Paper_Survey/README.md + matriz de evidencia | Referencias |
| "Esto es un flujo de trabajo reutilizable / indicación / regla de IA" | 4-Skills/PROJECT_SKILLS.md | (usualmente ninguno) |
| "Esto cambia el estado / siguiente acción / bloqueador" | _ai/project_overview.md, _ai/task_plan.md | Resumen superior + Progreso del proyecto |
Si la clasificación cambia el alcance del proyecto, los criterios de evaluación, el límite de datos, la exposición pública o si un intento pertenece al proyecto, pregunta antes de tratarlo como confirmado. Para nombres/formato de bajo riesgo, elige la opción conservadora y registra la suposición en _ai/progress.md.
El Tablero
PROJECT_BOARD.html es el tablero de un solo proyecto. Responde de un vistazo: qué es este proyecto, qué es actual, qué cambió, dónde está la evidencia y dónde continuar. Está coordinado con las carpetas — cada vista se alimenta de una carpeta o archivo _ai específico.
Elementos básicos:
-
Enlace de inicio / volver (persistente): un enlace al frente mismo de la página, en el área de la marca superior izquierda. Dentro de un portafolio, hazlo un enlace
Volver al tableroque apunte a la raíz del sitio/; independiente, omítelo o apunta alREADME.mddel propio proyecto. Conserva lo que elijas al crear, copiar, publicar o actualizar la página. -
Estado de la versión: versión de la página
YYYY-MM-DD-vNy marcador de última sincronización (opcionalmente un control de frescura/actualización). -
Resumen superior (siempre visible, ligero): nombre del proyecto, descripción de una frase, estado, propietario, sincronización reciente, enfoque actual y como máximo una línea corta de progreso. Fuente:
_ai/project_overview.md. No coloques listas de fases, tarjetas de versión, listas de intentos o rutas a largo plazo aquí. -
Cinco vistas mutuamente excluyentes, cada una mapeada a una carpeta:
Vista Alimentada por Muestra Progreso del proyecto _ai/progress.md,_ai/findings.md,1-Docs/README.mdsolo cambios mayores a nivel de proyecto: objetivo, alcance, fase, resultado clave, juicio, estado público, resumen de versión compacto Mapa de Documentos 1-Docs/README.md+ estructura raízíndice de temas de docs + un árbol de estructura al estilo de VS Code Explorer (archivos/carpetas de nivel 1 raíz y nivel 2 mediante <details>/<summary>), solo nombres seguros para el públicoTareas 0-Project/<intento>/intentos de línea principal primero; intentos futuros aparcados y archivados/obsoletos solo en carriles colapsados separados Materiales 2-Data/DATA.mdbloques de datos, publicidad, versión, calidad, límites de uso Referencias 3-Paper_Survey/README.mdartículos, fuentes de métodos, estado de la evidencia, impacto; solo si hay contenido
Reglas del tablero: no inventes propietarios, estado, prioridad o fases futuras; no añadas una vista independiente de "próximo paso" (la siguiente acción vive en el resumen superior, _ai/task_plan.md o un intento); usa <details> colapsados para intentos y el árbol de estructura; mantenlo como un banco de trabajo de investigación silencioso, no una página de destino. Las ideas futuras y los intentos abandonados no deben competir visualmente con la ruta activa. Las reglas de generación viven en _ai/project_board_spec.md. Consulta references/project-board.md para el contrato completo.
Bucle de Iteración
- Restaura el contexto desde
_ai/project_overview.md,_ai/project_board_spec.md,_ai/task_plan.md,_ai/findings.md,_ai/progress.mdy el README de la carpeta relevante. - Confirma la identidad de Git del operador antes de editar los archivos del proyecto; si falta, pide al usuario que configure la suya y haz una pausa.
- Nombra la iteración actual en una frase: pregunta, intento o decisión.
- Crea o actualiza primero el archivo fuente más específico.
- Registra los hallazgos que cambien la dirección en
_ai/findings.md; registra acciones, validación y rutas fallidas en_ai/progress.md. - Actualiza
_ai/task_plan.mdcuando la fase, el bloqueador o la siguiente acción cambien. - Antes de la compresión de contexto, después de completar un pequeño paso, o antes de cambiar de tema/subproyecto, escribe una transferencia compacta en el archivo Markdown coincidente más específico.
- Aplica la Escala de Sincronización para decidir si tocar
PROJECT_BOARD.html, luego confirma los archivos seguros cambiados con rutas explícitas.
Compresión de Contexto e Higiene de Transferencia
Escribe el contexto de forma proactiva antes de que la conversación se vuelva costosa de mantener. Haz esto cuando la ventana de contexto se esté haciendo grande, un pequeño paso termine, un subproyecto llegue a un punto de decisión, o la siguiente acción vaya a cambiar a otro tema, proyecto o intento.
Elige el hogar más específico:
| Situación | Ubicación de la transferencia |
|---|---|
| Discusión, decisión o nota de método a nivel de proyecto | 1-Docs/<fecha>_<tema>.md |
| Paso, observación o discusión local a nivel de intento | 0-Project/<intento>/docs/<fecha>_<tema>.md |
| Estado del proyecto, bloqueador, siguiente acción o resumen de validación | _ai/progress.md, _ai/findings.md, _ai/task_plan.md |
| Contexto entre proyectos o de portafolio | <slug>-ai/<fecha>_<tema>.md del portafolio si existe un portafolio |
Campos mínimos de la transferencia: objetivo actual, paso completado, decisiones clave, rutas de evidencia, preguntas no resueltas, siguiente acción y si se necesita sincronización del tablero. Mantenlo compacto; no pegues transcripciones completas o registros sin procesar.
Escala de Sincronización
Juzga cada cambio contra esta escala antes de editar el tablero.
| Nivel | Desencadenante | Actualización |
|---|---|---|
| 0 | Exploración de solo lectura, sin nueva decisión | Nada |
| 1 | Hallazgo menor, pequeña rama fallida, nota temporal | Solo Markdown o _ai |
| 2 | Nuevo artefacto/ruta/resultado de QC, bloqueador, siguiente acción, estado, mapa de documentos, árbol de estructura, límite de datos, referencia o cambio de intento | Markdown fuente o _ai, luego sincronizar PROJECT_BOARD.html |
| 3 | Fase, hito, afirmación pública, propietario, prioridad o estado público cambiado | Markdown fuente, tablero, PROJECT_GUIDELINES.md y — solo si el proyecto pertenece a un portafolio — el tablero del portafolio |
Las notas de transferencia de contexto son generalmente de Nivel 1. Elévalas a Nivel 2 solo cuando cambien la siguiente acción, el estado, el bloqueador, el mapa de documentos, el límite de datos, el estado de la referencia o el estado del intento.
No sincronices el tablero en cada edición. Sincroniza cuando un colaborador necesitaría el nuevo estado.
Registros de Subproyectos
Cada 0-Project/<fecha>_<slug>/README.md debe responder: qué pregunta pone a prueba el intento; qué entradas, artículos, notas de datos o suposiciones usa; qué se ejecutó o razonó (objetivo, hipótesis, entradas, comando, métricas); qué falló, cambió o se estabilizó; la conclusión y la siguiente acción; y si afecta el estado del proyecto, las notas de datos, las notas de literatura o el tablero. Coloca las discusiones locales del intento, las transferencias de paso y las notas de diseño en la carpeta docs/ de ese intento.
Registra los intentos fallidos. Una ruta fallida con una razón clara es un activo útil del proyecto. Si está abandonado o reemplazado, márcalo como archivado con la razón de parada, el reemplazo si lo hay, la última evidencia y qué no repetir; muéstralo en el tablero solo como un elemento colapsado secundario una vez que alcance una fase estable o un punto de decisión.
Datos y Literatura
- Usa
2-Data/DATA.mdpara la procedencia, versiones, clase de acceso, ubicaciones permitidas, esquema, QC y límites de artefactos derivados. Mantén los datos derivados del proyecto (características, trayectorias, tablas listas para análisis, intermediarios de QC) bajo el2-Data/de este proyecto, no en el área de datos global. Nunca escribas registros sensibles sin procesar, ejemplos con identidad, credenciales o extractos no publicados en notas, el tablero o copias públicas. - Usa
3-Paper_Survey/README.mdpara la evidencia que puede cambiar métodos, evaluación, alcance o interpretación. Resume los artículos por problema, método, datos o benchmark, resultado, limitación e implicación para este proyecto. Usa una matriz de evidencia cuando varias fuentes se refieran a una misma afirmación. Prefiere una paráfrasis concisa y enlaces sobre citas largas.
Referencias
- Lee
references/project-iteration-system.mdal crear la estructura del proyecto, archivos de entrada, subproyectos, archivos de memoria de trabajo o reglas de sincronización. - Lee
references/project-board.mdal crear, revisar o sincronizarPROJECT_BOARD.html. - Lee
references/data-and-literature.mdantes de manejar notas de datos, procedencia de benchmarks, resúmenes de literatura o actualizaciones de evidencia a decisión.