Przejdź do treści
Biblioteka skilli
Produktywność osobista · Planowanie

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.

Licencja
MIT
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. The three layers (what lives where)
  2. Auto-injection: STATE.md is ambient instructions
  3. Rolling state files (docs/context/)
  4. Workflow
  5. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 84 linii, 652 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.