archive

Visión general de archive skill

Lo que archive hace bien

archive skill está pensado para equipos y desarrolladores individuales que quieren convertir el conocimiento de una sesión puntual en memoria reutilizable del proyecto. En lugar de dejar soluciones enterradas en el historial del chat, guarda resoluciones de debugging, notas de despliegue y aprendizajes de proceso en .archive/YYYY-MM-DD/ como markdown estructurado, y luego mantiene un índice ligero en .archive/MEMORY.md.

Quién debería instalar archive

Este archive skill encaja mejor con quienes vuelven una y otra vez sobre los mismos problemas de infraestructura, CI, releases o debugging y quieren resolverlos más rápido en el futuro. Es especialmente útil si tu trabajo se reparte entre varias sesiones, varios agentes o varios colaboradores que necesitan un registro compartido de “¿qué pasó la última vez?”.

El trabajo real que resuelve

Los usuarios no necesitan otro hábito de tomar notas. Necesitan una forma fiable de capturar contexto técnico de alto valor justo después de terminar una tarea importante y de recuperar ese contexto antes de empezar la siguiente tarea parecida. archive está diseñado alrededor de ese flujo de trabajo, no como documentación genérica.

Por qué archive es distinto de un prompt normal

Un prompt normal puede decirle a una IA “resume lo que hicimos”. archive skill añade un patrón de almacenamiento repetible, una actualización obligatoria del índice de memoria y un hook de inicio de sesión que carga .archive/MEMORY.md automáticamente cuando existe. Eso hace que archive for Knowledge Bases sea realmente práctico: el archivo pasa a formar parte del contexto de trabajo futuro, no se queda como un markdown olvidado.

Tradeoffs clave antes de instalarlo

archive es intencionadamente simple. No ofrece base de datos, búsqueda vectorial ni una canalización automática de categorización. Su valor viene de una estructura de archivos disciplinada, etiquetas buscables y un índice de memoria. Si tu equipo no va a mantener .archive/MEMORY.md, archive skill pierde gran parte de su ventaja.

Cómo usar archive skill

archive install y archivos del repositorio que conviene leer primero

Una ruta práctica para archive install es:

1. Añadir el skill desde el repositorio ReScienceLab/opc-skills en tu sistema de skills.
2. Leer primero skills/archive/SKILL.md para entender el flujo de trabajo.
3. Leer skills/archive/references/TEMPLATE.md para ver la estructura obligatoria del archivo.
4. Revisar skills/archive/hooks/hooks.json y skills/archive/hooks/load-memory.py si te importa cómo se carga el contexto al inicio.
5. Comprobar skills/archive/.factory-plugin/plugin.json para confirmar el comportamiento esperado.

Si solo vas a hojear un archivo de apoyo, que sea references/TEMPLATE.md; ahí se ve con claridad qué aspecto tiene una “salida archive” bien hecha.

Qué necesita archive skill como entrada

archive skill funciona mejor si le das:

• la tarea o incidente ya completado
• el resultado principal
• los pasos clave que se siguieron
• los comandos críticos, cambios de configuración o decisiones de código
• los puntos de fallo y las soluciones finales
• la categoría y las etiquetas probables
• cualquier entrada anterior de archive relacionada

Sin esas entradas, el archivo quedará demasiado vago como para ayudar más adelante.

Cuándo activar archive

Usa archive después de:

• un despliegue exitoso
• una sesión de debugging complicada
• una migración o un cambio de infraestructura
• la finalización de una funcionalidad importante
• cualquier instrucción del usuario como “archive this”

No lo uses para cada edición menor. El skill está pensado para aprendizajes duraderos, no para registros ruidosos de actividad.

Cómo funciona archive en la práctica

El flujo previsto es:

1. Revisar .archive/MEMORY.md para ver trabajo anterior relacionado.
2. Crear o reutilizar .archive/YYYY-MM-DD/.
3. Escribir un archivo markdown usando la estructura de la plantilla y YAML frontmatter.
4. Añadir una línea de índice a .archive/MEMORY.md.
5. Vincular entradas relacionadas mediante el campo related.

Esa actualización del índice no es trabajo administrativo sin más. Es lo que hace que la búsqueda futura sea rápida.

Un prompt más sólido para archive skill

Prompt débil:

• “Archive this session.”

Prompt mejor:

• “Use the archive skill to document today’s ECS deploy issue. Include the IAM permission error, the CloudWatch clue, the exact fix, final deploy status, tags for ecs, iam, deploy, category infrastructure, and add a one-line entry to .archive/MEMORY.md. If a related archive exists, link it.”

La versión más sólida le da al modelo suficiente estructura como para producir algo que de verdad puedas reutilizar.

Cómo convertir un objetivo difuso en una solicitud completa para archive

Si tu objetivo inicial es “guardar lo que aprendimos”, amplíalo con:

• qué pasó
• por qué importaba
• qué falló
• qué lo solucionó
• qué habría que comprobar primero la próxima vez
• en qué categoría debería ir
• cómo debería poder encontrarse después mediante etiquetas

Este skill recompensa una escritura orientada a la recuperación de información, no una escritura narrativa.

Los campos de la plantilla de archive que más importan

De references/TEMPLATE.md, los campos más importantes son:

• tags: para recuperación con grep
• category: para organizar el índice
• related: para conectar incidentes a lo largo del tiempo

En el cuerpo, las secciones más valiosas suelen ser:

• Summary
• Issues Encountered & Solutions
• Key Changes

Si omites los detalles concretos de la solución, el archivo pierde mucha utilidad.

Cómo cambia el uso el hook de memoria al inicio de sesión

El hook carga .archive/MEMORY.md en el contexto de la sesión al arrancar, cuando el archivo existe. Eso significa que archive skill no sirve solo para escribir; también mejora automáticamente la capacidad de recordar en el futuro. En términos de adopción, esta es una de las razones más fuertes para instalar el skill en lugar de usar un archivo de notas improvisado.

archive for Knowledge Bases y memoria de equipo

Para archive for Knowledge Bases, piensa en .archive/MEMORY.md como la tabla de contenidos y en cada archivo markdown fechado como el registro de un incidente o una tarea. Esto funciona bien para:

• problemas operativos recurrentes
• checklists de release con trampas o matices importantes
• soluciones específicas de un entorno
• decisiones de diseño con consecuencias

Es menos adecuado para documentación amplia de producto o manuales orientados a usuarios.

Flujo práctico de búsqueda y consulta

El skill admite de forma explícita una búsqueda ligera:

• revisar .archive/MEMORY.md
• usar grep -ri "keyword" .archive/

Eso basta para muchos equipos de ingeniería porque el contenido guardado es acotado, técnico y estructurado. Usa etiquetas que la gente realmente vaya a buscar después: nombres de servicios, cadenas de error, nombres de plataformas y nombres de componentes.

FAQ de archive skill

¿Vale la pena instalar archive si ya tomo notas?

Sí, si tus notas actuales son difíciles de encontrar o nunca vuelven a entrar en el contexto del agente. archive skill resulta útil porque estandariza ubicación, estructura, indexación y carga de memoria al inicio de la sesión.

¿Este archive skill es apto para principiantes?

Sí, en general. El flujo es markdown sencillo más un archivo de índice. El principal riesgo para principiantes es escribir resúmenes demasiado abstractos. El skill es más fácil de usar si copias la plantilla y completas soluciones específicas, comandos y aprendizajes.

¿Cuándo no debería usar archive?

No uses archive para:

• ediciones triviales
• brainstorming temporal
• documentación extensa
• conocimiento que debería vivir en documentación permanente del repositorio como README.md o runbooks

Si la información debe orientar a todos los colaboradores en todo momento, quizá debería ir en la documentación estándar y no solo en .archive/.

¿En qué se diferencia archive de la documentación normal del proyecto?

La documentación normal describe el sistema previsto. El uso de archive captura lo que realmente ocurrió durante una tarea o incidente: los caminos fallidos, la solución exacta y el contexto que normalmente se pierde. Es una capa de memoria operativa e histórica, no un sustituto de la documentación canónica.

¿archive requiere herramientas especiales?

No demasiadas. El formato central son archivos markdown más .archive/MEMORY.md. El repositorio también incluye un hook que carga la memoria al inicio de la sesión, pero incluso sin eso, archive skill sigue funcionando como un patrón disciplinado de almacenamiento.

Cuáles son los límites de esta guía de archive

Esta guía de archive refleja lo que soporta el repositorio: archivos de archive basados en ficheros, memoria indexada, categorías simples, enlaces relacionados y recuperación mediante hooks. No promete canalizaciones automáticas de resumen, búsqueda semántica ni sincronización con bases de conocimiento externas.

Cómo mejorar archive skill

Escribe entradas de archive para recuperarlas, no para contar una historia

La mejor salida de archive es fácil de escanear después. Pon el problema, la solución y los comandos críticos donde alguien que vuelva en el futuro pueda encontrarlos rápido. Una narrativa pulida vale menos que un registro directo y fácil de buscar.

Usa etiquetas que la gente realmente vaya a buscar

Buenas etiquetas:

• nombres de servicios o herramientas
• nombres exactos de subsistemas
• nombres de plataformas de despliegue
• palabras clave de errores
• nombres de entornos afectados

Malas etiquetas:

• palabras vagas como issue, work o update

Esta es una de las mejoras de mayor impacto para la calidad de uso de archive.

Haz que MEMORY.md sea útil, no ceremonial

Una entrada de índice débil dice:

• “Fixed deployment issue”

Una más sólida dice:

• “ECS deploy failed due to missing IAM permission for secret access; resolved by updating task role policy”

El índice debería ayudar a alguien a decidir qué archivo de archive abrir a continuación.

Captura intentos fallidos cuando cambian decisiones futuras

Si el equipo probó dos soluciones equivocadas antes de llegar a la correcta, inclúyelas cuando ayuden a evitar repetir pérdidas de tiempo. Aquí es donde archive skill suele superar a la documentación estándar: conserva los callejones sin salida que realmente importan.

Da mejores entradas para obtener una mejor salida de archive

Antes de pedirle al skill que archive algo, reúne:

• el texto exacto del error
• los comandos relevantes
• los archivos o ajustes modificados
• el estado final verificado
• por qué funcionó la solución final

Estos detalles mejoran de forma material la reutilización futura y la capacidad de búsqueda.

Modos de fallo habituales al usar archive skill

Los problemas típicos incluyen:

• falta de actualización de .archive/MEMORY.md
• etiquetas demasiado genéricas
• ausencia de una categoría clara
• resúmenes sin detalle operativo
• entradas de archive sin relación con incidentes previos

La mayoría de los malos resultados con archive vienen de entradas incompletas, no de la plantilla en sí.

Itera después del primer borrador de archive

Después del primer borrador, comprueba:

• ¿Alguien podría encontrar esto con términos de búsqueda probables?
• ¿El resumen dice cuál fue el resultado y la causa?
• ¿Se incluyen los comandos clave o los cambios de configuración?
• ¿Un agente futuro sabría qué probar primero?
• ¿Debería enlazarse a una entrada relacionada más antigua?

Una segunda pasada corta suele elevar bastante la calidad de archive.

Usa archive junto con la documentación permanente, no en lugar de ella

Si la sesión reveló una regla permanente, actualiza también la documentación canónica. archive skill debe preservar conocimiento a nivel de evento; no debería convertirse en el único lugar donde vive la orientación crítica del equipo.

Mejora la adopción de archive con un disparador claro de equipo

Los equipos obtienen mejores resultados cuando definen disparadores explícitos como:

• cada despliegue a producción con sorpresas
• cada incidente con una solución no obvia
• cada migración
• cada petición del usuario de “save this for next time”

Eso mantiene archive valioso sin llenarlo de ruido.