context-anchor

# Context Anchor Skill

Helps agents recover context after compaction by scanning memory files and generating a "here's where you are" briefing.

## Why This Exists

Context compaction loses memory. Files survive. But after waking up fresh, you need to:
1. Know what you were working on
2. See decisions that were made
3. Find open loops that need closing
4. Get oriented fast

This skill automates that recovery.

---

## Quick Start

```bash
# Full briefing (default)
./scripts/anchor.sh

# Just show current task
./scripts/anchor.sh --task

# Just show active context files
./scripts/anchor.sh --active

# Just show recent decisions
./scripts/anchor.sh --decisions

# Show open loops / questions
./scripts/anchor.sh --loops

# Scan specific number of days back
./scripts/anchor.sh --days 3
```

---

## What It Scans

| Source | What It Extracts |
|--------|------------------|
| `memory/current-task.md` | Current task status, blockers, next steps |
| `memory/YYYY-MM-DD.md` | Recent daily logs (last 2 days by default) |
| `context/active/*.md` | In-progress task files |
| Daily logs | Decisions (lines with "Decision:", "Decided:", "✅") |
| Daily logs | Open loops (lines with "?", "TODO:", "Blocker:", "Need to") |

---

## Output Format

The script outputs a structured briefing:

```
═══════════════════════════════════════════════════════════
                    CONTEXT ANCHOR
              Where You Left Off
═══════════════════════════════════════════════════════════

📋 CURRENT TASK
───────────────────────────────────────────────────────────
[Contents of memory/current-task.md or "No current task set"]

📂 ACTIVE CONTEXT FILES
───────────────────────────────────────────────────────────
• context/active/project-name.md (updated 2h ago)
  └─ First line preview...

🎯 RECENT DECISIONS (last 2 days)
───────────────────────────────────────────────────────────
[2026-01-30] Decision: Use Cloudflare Pages for hosting
[2026-01-30] ✅ Completed email capture setup

❓ OPEN LOOPS
────...

# Context Anchor

**Helps agents recover from context compaction by scanning memory files and surfacing where they left off.**

## The Problem

Context compaction loses memory. You wake up fresh, unsure what you were doing. Files survive, but you need to quickly orient yourself.

## The Solution

Run one command to get a briefing:

```bash
./scripts/anchor.sh
```

You'll see:
- **Current task** - What you were actively working on
- **Active context** - In-progress task files from `context/active/`
- **Recent decisions** - Key choices made in the last few days
- **Open loops** - TODOs, questions, and unfinished business

## Installation

Already installed if you're reading this. Just run:

```bash
./skills/context-anchor/scripts/anchor.sh
```

Or add it to your session startup routine.

## See Also

- [SKILL.md](./SKILL.md) - Full documentation
- [AGENTS.md](../../AGENTS.md) - Workspace conventions

## Zero Dependencies

Pure bash. Works on macOS and Linux. No external tools needed.