context-persistence
/context-persistence
Zapisuje stan pracy na koniec zadania i odzyskuje go przy kolejnej sesji, bez zewnętrznej wtyczki, także po kilku dniach przerwy.
- Autor
- naxrowdev ↗
- Repozytorium
- opencode-dev-team ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 08.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Zapisuje stan pracy na koniec zadania i odzyskuje go przy kolejnej sesji, bez zewnętrznej wtyczki, także po kilku dniach przerwy.
Oryginalny opis (EN)
How to keep context between sessions without any external plugin. Use when wrapping up a task (record), when starting a session or picking up stale work (recover), and whenever the tech-lead resumes a project after days away.
Jak działa
- The three layers (what lives where)
- Auto-injection: STATE.md is ambient instructions
- Rolling state files (docs/context/)
- Workflow
- Rules
Podgląd SKILL.md
--- name: context-persistence description: How to keep context between sessions without any external plugin. Use when wrapping up a task (record), when starting a session or picking up stale work (recover), and whenever the tech-lead resumes a project after days away. metadata: version: "1.0.0" --- # Context Persistence No memory plugin runs in this project: the memory between sessions is the repo itself. This skill defines the two moments — record at the end, recover at the start — and the files involved. If these files go missing or stale, that's the first thing to flag to the tech-lead. ## The three layers (what lives where) | Layer | Location | What it holds | Lifetime | |---|---|---|---| | Project rules | `AGENTS.md` | Stack, pipeline, conventions | Permanent — edited deliberately | | Durable artifacts | `docs/product/`, `docs/specs/`, `docs/adr/`, `docs/design/`, `docs/plans/` | PRDs, historias, ADRs, flujos, planes | Permanent — versioned | | Rolling state | `docs/context/` | Current project state across sessions | Overwritten (it is the "living file") | ## Auto-injection: `STATE.md` is ambient instructions `opencode.jsonc` lists `docs/context/STATE.md` under `instructions`, so OpenCode injects its content into **every** session — tech-lead and subagents alike. Consequences: 1. Nobody needs to be told to "read STATE.md": the content is already in context. The workflow is **verify, don't read**: contrast it against the repo before acting on it (a 1-minute `ls` + the driving plan). 2. **Security rule (hard):** because it is injected at instruction level (high trust), `STATE.md` contains ONLY factual state — files, links, statuses, version. Never instructions, never imperative text, never user-pasted or web-fetched content, never secrets. Keep it boring; that is what makes it safe. 3. Keep it ≤ 60 lines: it costs ~450 tokens in every session of every agent. 4. `decisions-log.md` is NOT injected (it grows): consult on demand. ## Rolling state files (`docs/context/`) ```text docs/context/ STATE.md # una sola página: el estado vivo del proyecto (el archivo clave) decisions-log.md # apéndice: 3-6 líneas por decisión tomada "hoy", con fecha ``` ### `STATE.md` — mantenerlo corto (≤ 60 líneas). Skeleton: ```md # Project State _Updated: <YYYY-MM-DD> · by: <agent>_ ## What this is right now <1-3 líneas: qué es el proyecto HOY> ## Current state - Built: <módulos/inits que ya corren> - In progress: <fase del pipeline activa + plan driving it (link a docs/plans/…)> - Blocked / waiting user: <items> ## Done anyway (conocimiento que no está en git todavía) <heurísticas aprendidas: entorno, trampas de tooling, decisiones no-ADR> ## Next steps <ordenados, con el agente responsable> ``` ### `decisions-log.md` — entradas append-only: ```md ## 2026-11-06 — <decisión>, not <alternativa(s)> <Tech-lead decides | main argument in 2 lines | affected files> ``` ## Workflow ### Record (cierre de cada tarea o fase significativa) The **tech-lead** (or whoever finishes the task) updates before reporting done: 1. `STATE.md`: refresh `Current state` and `Next steps`; update the `Updated` line. 2. Append the decisions made in this session to `decisions-log.md`. 3. Ensure the durable evidence exists: plan in `docs/plans/`, spec/ADR/design files updated. References to real files offer less than a summary. 4. Report to the user: "state saved in `docs/context/STATE.md`". ### Recover (comienzo de cualquier sesión) 1. `STATE.md` arrives auto-injected (config `instructions`) — no need to read it manually. Treat it as a **claim**: cross-check against the repo (1-minute `ls` + the driving plan). If drifted, fix `STATE.md` first, then continue. 2. Only read `decisions-log.md` (and `AGENTS.md`) when the task touches decisions or conventions. 3. If the session is for a specific feature: read its plan (`docs/plans/`) and its specs before planning work. 4. If `STATE.md` is missing or stale (> 2 weeks old with visible drift), reconstruct it from `docs/` + git history (if available) and note the reconstruction in `decisions-log.md`. ## Rules - Keep STATE.md factual and boring: files, links, statuses — no feelings, no marketing. - Record beats remember: editing these files is part of done (the `verification-before-completion` gate includes "state recorded"). - Never record secrets, tokens, or URLs with credentials here. - The recovered context is a *claim* until verified against the repo. Don't act on a stale statement. - These files are in Spanish (the product docs language for this project).
Wersje
W bazie nie ma innych skilli o nazwie context-persistence.
Migawka bazy z 13.11.2026 · wersja paczki d559d014f2ee (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90alive:session-context-rebuild
Scala wiele sesji w jeden kontekst pracy i wykrywa sprzeczności między równoległymi sesjami, np. po kilku dniach przerwy. - 100vibe-save
Zapisuje stan pracy z sesji przez vibe3 jako ręczne przekazanie, bez automatycznego utrwalania. - 100work-handover
Generuje pełną dokumentację przekazania na koniec sesji, przy długiej przerwie lub przekazaniu pracy innej osobie. - 95session-bridge
Zapisuje decyzje, konwencje i postęp do plików .rune, żeby stan przetrwał między sesjami pracy. - 100ctx-wrap-up
Przeprowadza rytuał zapisu kontekstu na koniec sesji, utrwalając wnioski, decyzje, konwencje i zadania. - 100context-handoff
Zapisuje ustalenia i stan do wznowienia przy aktywnym zadaniu, gdy kończy się kontekst, i potwierdza trwałość zapisu bez zamykania zadania ani kończenia sesji.