context-maintenance

Update .context documentation by promoting retrospectives and pruning stale content.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/maestria-co/ai-playbook --skill context-maintenance-maestria-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-maintenance
Source: https://github.com/maestria-co/ai-playbook/tree/main/skills/context-maintenance
Command: npx skills add https://github.com/maestria-co/ai-playbook --skill context-maintenance-maestria-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps .context/ documentation accurate and current after non-trivial work. It prevents drift and duplication by promoting retrospective insights, pruning stale content, and guiding when to update versus create context documents. If you recently completed work and learned something valuable, this is the right skill to preserve, even if the user didn't explicitly ask. For full codebase-level syncs, use context-review instead.

Core Features & Use Cases

  • Retrospective Promotion: promote lessons from .context/retrospectives/ into permanent docs to avoid losing valuable insights.
  • Pruning & Duplication Control: remove stale task artifacts and consolidate duplicated information to keep the context lean.
  • Update vs Create Guidance: decide when to update existing .context/ files versus creating new entries.
  • Task Folder Lifecycle & Quality Checks: manage task-folder content over time and apply periodic consistency checks.

Quick Start

Review the latest task outcomes and promote applicable retrospective lessons into the relevant .context/ files.

Frequently Asked Questions about context-maintenance

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

FAQPage Schema
How do I keep project context documentation accurate after completing a task?

To keep project context documentation accurate, you should apply incremental updates to existing context files after tasks are completed. This enforces updating current documents rather than creating duplicates, preventing drift and keeping the context lean.

When should I update existing context files versus creating new ones?

You should update existing context files versus creating new ones to avoid duplication and stale content. This approach enforces consolidating duplicated information and pruning outdated task artifacts to maintain a lean, non-redundant codebase context.

How do I promote retrospective lessons into permanent codebase documentation?

To promote retrospective lessons into permanent codebase documentation, you move valuable insights from the retrospectives folder into relevant context files. This prevents losing valuable insights and ensures project standards are maintained over time.

What is the best way to prune stale content and manage task folder lifecycle in context docs?

The best way to prune stale content and manage task folder lifecycle is to apply periodic consistency checks. This process removes stale task artifacts and consolidates duplicated information to keep documentation concise and non-redundant.

Does this handle full codebase-level documentation syncs?

No, this does not handle full codebase-level documentation syncs. It applies to incremental updates after tasks, when new insights are learned, or retrospectives are promoted. For full codebase-level syncs, a context-review approach is needed.

Why does my project context documentation drift and become redundant over time?

Project context documentation drifts and becomes redundant over time when retrospective insights are not promoted into permanent docs and task artifacts are left unpruned. Applying incremental updates and duplication control prevents this drift.