upkeep-context

Maintain repository context memory documenting architecture, subsystem interfaces, and risks.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/Capataina/agent-skills --skill upkeep-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upkeep-context
Source: https://github.com/Capataina/agent-skills/tree/main/upkeep-context
Command: npx skills add https://github.com/Capataina/agent-skills --skill upkeep-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains a repository-level context folder as durable implementation memory — a living memory of current implementation reality, subsystem boundaries, decisions, and lessons that helps future engineers understand and safely change the project without re-deriving everything from code.

Core Features & Use Cases

  • Establishes and maintains a repository memory layer in context/, including architecture anchors, subsystem boundaries, decision rationale, and durable notes.
  • Enables on-demand loading of canonical references, notes, and project plans to ground ongoing work.
  • Supports deterministic upkeep activities (repo scanning and context linting) to keep the memory layer aligned with code reality across sessions.

Quick Start

Invoke the upkeep-context workflow to initialise or refresh the repository memory by scanning the repository and producing canonical context documents grounded in current code reality.

Frequently Asked Questions about upkeep-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve repository memory to maintain accurate architecture context?

You can preserve repository memory by maintaining a context/ folder that documents architecture anchors, subsystem boundaries, and decision rationale to ground future engineering work in current code reality.

What is the best way to lint repository context against current code boundaries?

Linting repository context involves deterministic upkeep activities like scanning the repository to ensure the memory layer accurately reflects current interfaces, trade-offs, and canonical ownership boundaries.

How does maintaining a context folder help with subsystem repair or restructuring tasks?

A context folder provides durable implementation memory that documents cross-system alignment and risks, enabling engineers to safely repair or restructure subsystems without re-deriving boundaries from code.

Can I use repository memory to onboard engineers to existing subsystem interfaces?

Yes, repository memory stores canonical references, durable notes, and guiding principles that document subsystem interfaces, allowing new engineers to understand implementation reality on-demand.

Do I need a context folder for every repository to track architecture decisions?

A context folder is essential when repositories have complex subsystem boundaries and cross-system alignment needs, serving as a living memory that tracks decisions, risks, and trade-offs across sessions.

Why does repository context drift from actual implementation reality over time?

Repository context drifts because code changes outpace documentation, requiring deterministic repo scanning and context linting to realign durable notes and references with current code boundaries.