rag-tracking Skill

External persistent memory for document ingestion and issues, designed for agents without built-in memory. This skill uses ctx under the hood for cross-session persistence.

When to Use This Skill

Use this skill when:

• Working with agents that lack persistent memory (Claude Code, Codex, OpenCode, etc.)
• Sharing ingestion state across multiple agents or team members
• Running in CI/CD environments where agent memory doesn't persist

NOT needed for:

• Letta Code — has built-in persistent memory (system, progressive, recall)
• Any agent platform with native long-term memory support

For Letta Code users, simply store collection state in your agent's memory files instead.

Memory Files

ctx Default Files (created by ctx init)

Dragster-Specific Files (our templates)

Location

These files live in .context/ (ctx's directory) for cross-session persistence:

.context/
├── COLLECTIONS.md     # What we've indexed
├── ISSUES.md          # What's broken
├── TASKS.md           # (ctx default) Active work
├── DECISIONS.md       # (ctx default) Architecture decisions
├── LEARNINGS.md       # (ctx default) Patterns learned
└── CONVENTIONS.md     # (ctx default) Conventions

Templates vs Runtime Files

The files in this skill directory (skills/memory/) are templates for reference.

Runtime files live in .context/ (managed by ctx):

.context/
├── COLLECTIONS.md     # Created by ctx init or copied from template
├── ISSUES.md          # Created when first issue is recorded
└── ...

Initial Setup

1. Install ctx: brew install worktrunk (or see ctx.ist)
2. Initialize ctx in your project: ctx init

- This creates .context/ with TASKS.md, DECISIONS.md, LEARNINGS.md, CONVENTIONS.md

1. Copy dragster templates to .context/:

``bash cp skills/memory/COLLECTIONS.md .context/ cp skills/memory/ISSUES.md .context/ ``

1. Copy ctx configuration (optional, enables hooks):

``bash cp skills/memory/ctxrc.template .ctxrc ``

1. Add dragster-specific patterns to LEARNINGS.md:

``bash ctx add learning "French government PDFs require --ocr-language fra" ctx add learning "Scanned documents benefit from --dpi 300" ``

Enable/Disable

Set enabled: false in the frontmatter to disable this skill.

When disabled, the skill won't be loaded by Letta Code and hooks won't fire.

To re-enable: change back to enabled: true.

Commands

Record Ingestion

After successfully ingesting documents, add an entry to COLLECTIONS.md and update the Collections table.

Record Issue

When encountering a parsing problem, add an entry to ISSUES.md with the error and any workaround found.

Promote to Learning

When a pattern is discovered, promote to LEARNINGS.md via:

ctx add learning "<pattern-description>"

Workflow

Starting a Session

1. Read .context/COLLECTIONS.md to understand current state
2. Check .context/ISSUES.md for any open problems
3. Proceed with document processing

After Ingestion

1. Update COLLECTIONS.md with ingestion details
2. If issues occurred, add entries to ISSUES.md
3. If patterns discovered, promote to LEARNINGS.md

Session Wrap-up

1. Review open issues in ISSUES.md
2. Mark resolved issues
3. Ensure collections table is accurate

Integration with ctx

This skill integrates with ctx's memory system:

• ctx agent includes COLLECTIONS.md and ISSUES.md in context packets
• ctx add learning promotes patterns to persistent memory
• ctx status shows memory file health

Hooks

Hooks provide automatic reminders at key points in the agent lifecycle.

Available Hooks

Configuration

Hooks are configured in .ctxrc (copy from skills/memory/ctxrc.template):

# .ctxrc
[hooks.session_start]
reminder = "📦 Memory: Read .context/COLLECTIONS.md and .context/ISSUES.md"

[hooks.post_tool_use]
match = "lit parse|qmd collection"
reminder = "Record this ingestion in .context/COLLECTIONS.md"

[freshness_files]
  - path: .context/COLLECTIONS.md
    desc: Document collection state
  - path: .context/ISSUES.md
    desc: Parsing problems and workarounds

Disabling Hooks

Set enabled: false in this skill's frontmatter to disable all hooks.