Keeping context
Why context loss is a primary failure mode in multi-step work — and concrete practices for carrying it forward.
Why context degrades
Every phase and gate in solveOS produces learning. That learning only has value if it travels into the next step — explicitly, in writing.
The problem isn't bad intentions or poor execution. It's silent drift: how projects fail not from bad execution but from losing the original goal. At some point during Build, the work stopped connecting to the brief — not because anyone decided to change direction, but because the context that held it together was never explicitly carried forward.
This matters everywhere in solveOS, but it is critical when working with AI. AI has no memory between sessions. If you do not carry the context forward — decisions made, directions cut, constraints discovered, things that didn't work — the next session starts from zero. The cycle degrades.
What context actually means at each transition
| Transition | What to carry forward | What happens without it |
|---|---|---|
| Plan → Build | The Plan Brief (goal, constraints, success criteria, rabbit holes, out of scope) | AI makes silent assumptions; the builder drifts from the goal |
| Build → Build Validation | What was built, what changed from the plan, what was deferred | Validation checks the wrong thing; scope drift goes undetected |
| Build Validation → Ship | Known issues and their decisions (fix now / defer / accept) | Deferred items are forgotten, not fed into the next cycle |
| Ship → Review → Plan | What worked, what didn't, what was discovered, what assumptions were wrong | Each cycle starts from scratch; the same mistakes repeat |
Practical practices
- Update the Plan Brief in writing when Build reveals new information. Don't silently change course. When the goal, constraints, or success criteria change, write it down before continuing.
- When handing off to AI: include the Plan Brief + reference files + a note on what changed since last session. Never assume the AI retained context from a previous conversation.
- After every gate: write a one-paragraph summary of what was decided and why, before proceeding. This creates a trail that the next phase can follow.
- At Review: write the Feed Forward section before starting the next Plan. The Feed Forward section is the context input for the next Plan — it is not optional for teams that want to improve.
The reference files concept
Reference files are critical for AI-assisted work. When AI is building, it needs two inputs: the Plan Brief (what to build) and reference files (the space to build within). A strong Plan Brief without reference files produces well-intentioned but uninformed work. Reference files without a clear Plan Brief produce directionless work. Both are needed.
Reference files are not the problem description. They are the working environment: existing code, documentation, API specs, style guides, design files — anything that gives AI the information it needs to produce correct output.
Each phase document includes specific guidance on where AI adds the most value and where human judgment must lead. Context carrying is the mechanism that makes multi-session AI collaboration work.
Mantener el contexto
Por qué la pérdida de contexto es un modo de fracaso principal en el trabajo de múltiples pasos — y prácticas concretas para trasladarlo hacia adelante.
Por qué se degrada el contexto
Cada fase y gate en solveOS produce aprendizaje. Ese aprendizaje solo tiene valor si se traslada al siguiente paso — de forma explícita, por escrito.
El problema no es la mala intención ni la ejecución deficiente. Es la deriva silenciosa: cómo fracasan los proyectos no por mala ejecución sino por perder el objetivo original. En algún punto durante el Build, el trabajo dejó de conectarse con el brief — no porque alguien decidiera cambiar de dirección, sino porque el contexto que lo mantenía unido nunca se trasladó explícitamente hacia adelante.
Esto importa en todas partes en solveOS, pero es crítico al trabajar con IA. La IA no tiene memoria entre sesiones. Si no trasladas el contexto hacia adelante — decisiones tomadas, direcciones descartadas, restricciones descubiertas, cosas que no funcionaron — la siguiente sesión comienza desde cero. El ciclo se degrada.
Qué significa el contexto en cada transición
| Transición | Qué trasladar | Qué ocurre sin ello |
|---|---|---|
| Plan → Build | El Plan Brief (objetivo, restricciones, criterios de éxito, pozos sin fondo, fuera de alcance) | La IA hace suposiciones silenciosas; el constructor se desvía del objetivo |
| Build → Build Validation | Qué se construyó, qué cambió del plan, qué se difirió | La validación verifica lo incorrecto; la deriva de alcance pasa desapercibida |
| Build Validation → Ship | Problemas conocidos y sus decisiones (corregir ahora / diferir / aceptar) | Los elementos diferidos se olvidan, no se incorporan al siguiente ciclo |
| Ship → Review → Plan | Qué funcionó, qué no, qué se descubrió, qué supuestos estaban equivocados | Cada ciclo comienza desde cero; los mismos errores se repiten |
Prácticas concretas
- Actualiza el Plan Brief por escrito cuando el Build revela información nueva. No cambies de rumbo en silencio. Cuando el objetivo, las restricciones o los criterios de éxito cambien, escríbelo antes de continuar.
- Al entregar a la IA: incluye el Plan Brief + archivos de referencia + una nota sobre qué cambió desde la última sesión. Nunca asumas que la IA retuvo el contexto de una conversación anterior.
- Después de cada gate: escribe un resumen de un párrafo sobre qué se decidió y por qué, antes de proceder. Esto crea un rastro que la siguiente fase puede seguir.
- En Review: escribe la sección Feed Forward antes de iniciar el siguiente Plan. La sección Feed Forward es el insumo de contexto para el siguiente Plan — no es opcional para los equipos que quieren mejorar.
El concepto de archivos de referencia
Los archivos de referencia son críticos para el trabajo asistido por IA. Cuando la IA construye, necesita dos insumos: el Plan Brief (qué construir) y los archivos de referencia (el espacio dentro del cual construir). Un Plan Brief sólido sin archivos de referencia produce trabajo bien intencionado pero desinformado. Los archivos de referencia sin un Plan Brief claro producen trabajo sin dirección. Ambos son necesarios.
Los archivos de referencia no son la descripción del problema. Son el entorno de trabajo: código existente, documentación, especificaciones de API, guías de estilo, archivos de diseño — cualquier cosa que dé a la IA la información que necesita para producir el resultado correcto.
Cada documento de fase incluye orientación específica sobre dónde la IA agrega más valor y dónde el juicio humano debe liderar. El traslado de contexto es el mecanismo que hace funcionar la colaboración con IA en múltiples sesiones.