Overview
One file per piece of work (<sessions-root>/<NN>-<slug>.md) that declares its current state: what is agreed, ruled out, and open. Items point to files, sections, or outside items when a source holds the detail; otherwise the session holds it. Each process — ideation, specs, design, implementation, or any other — reads the state, opens only the sources relevant to its task, and edits the state in place. Process-agnostic: the skill never knows or predicts which process comes next. Rules: session-contract.md.
Agent workflow
Runs when the user names this skill, or references a session file (doc_type: context-session) under a marked sessions root. Once loaded, it stays active for the rest of the chat. Works wherever the agent can read and write repository files. Match one Recipes row; open exactly that reference.
Recipes
| Intent | Example phrasing | Read |
|---|---|---|
| Create | "Create a session: …", "Create a session for saved cards", "new session" | creating-session.md |
| Continue | "Continue @sessions/03-… by building the PRD", "Continue the saved cards session" | continuing-session.md |
| Update | "Update the session", "Update sessions/03-… with this work" |
updating-session.md |
| Close | "Close the session", "Close sessions/03-…" |
closing-session.md |
Reference index
Contract
session-contract.md — root marker, layout, frontmatter, session body, item and pointer rules, lifecycle, index mirror.
| Doc | When to use |
|---|---|
| session-contract.md | Resolve root, find a session by name, session body, lifecycle |
| creating-session.md | New session file; record state the chat already settled |
| continuing-session.md | Brief from a session, run the task, update the state |
| updating-session.md | Edit the state in place for finished work |
| closing-session.md | Mark a session closed |
Templates
assets/index.md— sessions root markerassets/session.md— session file with state sections