guardian-session

Guardian Session — Context Loader

Purpose

Each session starts fresh. This skill restores context from memory.db so you know what's been done, what's in progress, and what needs attention next.

When to Load

• At the start of every coding session
• When switching between projects
• When resuming work after a break
• When the user says "what was I working on?"

Core Workflow

1. Load Project State

Search for the current project or topic first:

search_nodes query="<project-or-topic>"

Use read_graph only when the graph is known to be small or a full view is explicitly needed. Scan for:

• Project entities (root nodes)
• Active tasks (not marked [COMPLETE])
• Open bugs (not marked [FIX])
• Recent observations (check updated_at)

2. Contextualize to Current Directory

If working in a subdirectory, search for relevant files:

search_nodes query="file:<current-dir>"

If working on specific files, search for those:

search_nodes query="file:<filename>"

3. Surface Active Work

Find incomplete tasks:

query_data table="entities" conditions={"entity_type": "task"} limit=20

Find open bugs:

query_data table="entities" conditions={"entity_type": "bug"} limit=10

Find recent changes:

query_data table="entities" conditions={} orderBy="updated_at" orderDirection="DESC" limit=10

4. Build Session Summary

Create a mental model of the project state:

PROJECT: <name>
├── ACTIVE TASKS: <count>
│   ├── task:<id>:<title> — <status from observations>
│   └── ...
├── OPEN BUGS: <count>
│   ├── bug:<id>:<slug> — <severity>
│   └── ...
├── RECENT CHANGES: <count>
│   ├── <file or entity> — <what changed>
│   └── ...
└── NEXT UP: <suggested next action based on dependencies>

5. Report to User

Provide a concise briefing:

• What was last worked on (most recent observation)
• What's currently in progress (active tasks)
• What's blocking progress (open bugs, dependency chains)
• Suggested next action