Claude-skill-registry context-curation-base

Framework for managing project file context after retros/planning. Trigger after weekly retro + planning complete, after monthly retro + planning complete, or when context feels bloated. Also triggers with "context curation", "clean up project files", "archive old summaries", "what can we remove". Uses fractal compression with fold-before-archive pattern.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/context-curation-base" ~/.claude/skills/majiayu000-claude-skill-registry-context-curation-base && rm -rf "$T"
manifest: skills/data/context-curation-base/SKILL.md
source content

Context Curation Skill

Created: Monday, January 19, 2026 Updated: Monday, January 20, 2026 Purpose: Systematic process for managing project file context after retros/planning sessions Status: Experimental


Overview

Context curation follows the "fractal compression" pattern: each level of summary makes the previous level's raw inputs archivable. Before archiving, fold extractable data into addendums or reference docs.

Trigger phrases:

  • "context curation"
  • "clean up project files"
  • "archive old summaries"
  • "what can we remove"

Compression Hierarchy

Daily summaries → Weekly retros → Monthly retros → Quarterly retros → Yearly retros
After completing...These can be archived...
Daily summaryRaw conversation logs for that day
Weekly retroDaily summaries for that week
Monthly retroWeekly retros for that month
Quarterly retroMonthly retros for that quarter
Yearly retroQuarterly retros for that year

Principle: Keep at least one copy at each granularity level.


Retention Minimums

Keep at least one document at each granularity level:

LevelMinimum to Keep
Daily1-2 most recent summaries
WeeklyCurrent week's plan + most recent retro
MonthlyCurrent month's plan + most recent retro
QuarterlyCurrent quarter's plan + most recent retro
YearlyCurrent year's plan + most recent retro

Principle: Even after compression, maintain the ability to see recent state at each time scale.


Fold Before Archive

Before archiving daily summaries, extract data that should persist in reference docs.

What to Extract

  • Quantitative progress (reps, times, measurements, PRs)
  • Protocol changes or discoveries
  • Status updates for tracked items
  • Confirmed additions (new safe foods, new movements, etc.)

Where to Extract

Addendum files for reference docs that accumulate data:

  • Reference-Doc.md
    Reference-Doc-Addendum-YYYY-MM-DD-to-DD.md
  • Date range matches the weekly retro period
  • Example:
    Training-Log-Addendum-2026-02-16-to-22.md

Direct updates for simple status changes:

  • Single value changes can go directly to main doc
  • Level progressions, status flips, etc.

Addendum Naming Pattern

{Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md

Where date range matches the weekly retro being processed.

When Addendums Get Compressed

During weekly curation, fold addendums into their main docs:

  1. Review addendum content
  2. Integrate into appropriate sections of main doc
  3. Update revision date on main doc (e.g.,
    **Updated:** 2026-02-23
    )
  4. Save updated doc to project (replaces old version)
  5. Archive the processed addendum

Why revision dates matter: When Claude produces an artifact for a reference doc, the revision date makes it clear which version is current. Old version can then be archived/removed from project.

Reference Doc Versioning

Date-in-filename (preferred for periodic revisions):

  • Identity-Ecosystem-2025-12.md
    Identity-Ecosystem-2026-03.md
  • Old version archived when new version created

Updated-in-content (for incremental updates):

  • Keep same filename, update internal
    **Updated:** YYYY-MM-DD
  • Works when addendums fold in small changes

File Categories

Always Keep (Reference Docs)

Documents with ongoing reference value that don't get "rolled up":

  • Protocol docs (training plans, nutrition guidelines, recovery routines)
  • Framework docs (goal hierarchies, progress tracking systems)
  • Context docs (current status, background information)
  • Research plans (active investigation threads)

Keep Current Layer

Most recent documents at each temporal scale:

  • Current week's plan + most recent weekly retro
  • Current month's plan + most recent monthly retro
  • 1-2 most recent daily summaries (bridge to current conversation)

Archive Candidates

Documents whose content has been synthesized into higher-level summaries:

  • Daily summaries covered by weekly retro (after extraction complete)
  • Weekly retros covered by monthly retro
  • Past weekly plans (executed, retro complete)
  • Past monthly plans (after monthly retro captures outcomes)
  • Processed addendums (folded into main docs)
  • Old versions of reference docs (replaced by updated version)

Process

1. Identify Temporal Boundary

What retro just completed?

  • Weekly retro → daily summaries for that week can archive
  • Monthly retro → weekly retros for that month can archive

2. Review Dailies for Extractable Data

Scan the daily summaries being archived for:

  • Quantitative data that belongs in reference docs
  • Protocol changes or confirmations
  • Progress markers that should persist

3. Extract to Addendums

For each reference doc with extractable data:

  • Create or append to addendum file for this week
  • Use naming:
    {Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md

4. Compress Addendums into Main Docs

If any addendums exist from previous weeks:

  • Review addendum content
  • Integrate into appropriate sections of main doc
  • Mark addendum for archiving

5. List Archive Candidates

Quick pass through project files:

  • Reference docs: List, confirm keeping, check freshness
  • Current layer: Identify most recent at each scale
  • Archive candidates: List with reasoning

Format:

**EXTRACT - From this week's dailies:**
- [file]: "[data]" → [addendum file]

**COMPRESS - Addendums ready to fold:**
- [addendum file] (N entries) → [main doc]

**KEEP - Reference Docs:**
- [file] - [brief reason if not obvious]

**KEEP - Current Layer:**
- [file] - [which layer: daily/weekly/monthly]

**REFRESH - May Be Stale:**
- [file] - [why it may need updating]

**ARCHIVE - Folded into [Retro Name]:**
- [file]
- [file]

Refresh triggers (reference docs don't get archived, but they do get stale):

  • Time-based: Last updated 30+ days ago
  • Event-based: Major milestone, level change, protocol shift
  • Content-based: Information contradicts recent summaries/retros

6. User Confirms and Archives

User reacts with:

  • ✓ (agree with recommendation)
  • ✗ (keep/reconsider specific file)
  • Additional context ("also archive X" or "actually keep Y because...")

User then:

  • Extracts data to addendums
  • Compresses addendums into main docs
  • Removes archived files from project

Edge Cases

Files Not Clearly Covered

If a time period's retro is missing or incomplete:

  • Keep the lower-level docs until coverage exists
  • Example: Keep Week 11 retro if December monthly doesn't clearly cover that period

Reference Docs That Need Updates

Some "reference" docs get stale:

  • Training plans → update as fitness levels change
  • Equipment/gear lists → update as needs evolve
  • Goal frameworks → update after major milestone shifts

Flag these for refresh rather than archive.

Blended Summaries

When daily summaries span multiple days (due to missed days or combined entries):

  • Still archive after weekly retro covers the period
  • The blending itself is captured in the retro
  • Extract any quantitative data before archiving

No Extractable Data

If dailies have no quantitative/protocol data to extract:

  • Skip the extract step
  • Proceed directly to archiving
  • Retro synthesis is sufficient

Decision Principles

  1. Fold before archive: Extract persistent data before removing source
  2. When in doubt, keep: Can always archive later
  3. Compression preserves signal: Higher-level synthesis captures what mattered
  4. Context is finite: Project files affect conversation quality
  5. Recent > old: Prefer keeping recent docs over historical
  6. Reference > temporal: Reference docs have longer shelf life than summaries

Example Session

After Week 8 Retro (Rob's running project):

Claude: Let's do context curation. First, any data to extract before archiving?

**EXTRACT - From this week's dailies:**
- Summary-02-16: "3.1mi at 9:45 pace" → Training-Log-Addendum-2026-02-16-to-22.md
- Summary-02-18: "New stretching routine working well" → Recovery-Protocol-Addendum-2026-02-16-to-22.md
- Summary-02-20: "PR: 5K in 28:32" → Training-Log-Addendum-2026-02-16-to-22.md

**COMPRESS - Addendums ready to fold:**
- Training-Log-Addendum-2026-02-09-to-15.md (4 entries) → Training-Log.md
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (2 entries) → Recovery-Protocol.md

**KEEP - Reference Docs:**
- Training-Plan-5K.md
- Race-Schedule-2026.md
- Training-Log.md
- Recovery-Protocol.md

**KEEP - Current Layer:**
- Weekly-Plan-2026-02-23.md (current)
- Weekly-Retro-2026-02-16.md (just created)
- Summary-02-21.md, Summary-02-22.md (most recent)

**REFRESH - May Be Stale:**
- Training-Plan-5K.md - last updated 6 weeks ago, you've progressed past Week 4 intervals

**ARCHIVE - Folded into Week 8 Retro:**
- Weekly-Plan-2026-02-16.md
- Summary-02-16.md through Summary-02-20.md
- Training-Log-Addendum-2026-02-09-to-15.md (after compression)
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (after compression)

User: Extracted the training data to addendums. Compressed last week's addendums into main docs. Archived the rest.

Claude: Good. Data preserved in reference docs. Context curated.

Integration Notes

When to trigger:

  • After weekly retro + planning complete
  • After monthly retro + planning complete
  • When context feels bloated / conversation quality degrading

Typical weekly curation flow:

  1. Weekly retro (summary-of-summaries)
  2. Weekly planning
  3. Context curation: a. Extract from dailies → addendums b. Compress addendums → main reference docs c. Archive dailies (now folded into retro) d. Archive processed addendums (now folded into main docs)

Cognitive load:

  • Keep it lightweight (quick pass, not deep analysis)
  • User makes final call on each file
  • Don't force decisions when depleted

Skill dependencies:

  • Works alongside retrospective skills (uses their outputs)
  • Works alongside planning skills (happens after planning complete)

"Fold before archive. Keep most recent at each layer."