maintaining-project-context

Update CLAUDE.md files to reflect API changes and architectural decisions.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/brmatola/gremlins --skill maintaining-project-context-brmatola
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintaining-project-context
Source: https://github.com/brmatola/gremlins/tree/main/skills/maintaining-project-context
Command: npx skills add https://github.com/brmatola/gremlins --skill maintaining-project-context-brmatola

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures CLAUDE.md context files stay current when code changes affect contracts, APIs, or architectural decisions.

Core Features & Use Cases

  • Context change detection: Identifies diffs that impact domain contracts, dependencies, invariants, and key decisions.
  • Context update orchestration: Maps changes to appropriate CLAUDE.md files and coordinates updates.
  • Branch/phase readiness: Guides updates at branch completion, release, or end-of-development phase.

Quick Start

Analyze the latest commit set and update affected CLAUDE.md files to reflect new contracts and decisions.

Frequently Asked Questions about maintaining-project-context

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

FAQPage Schema
How do I keep CLAUDE.md documentation updated after code changes affect API contracts?

Keeping CLAUDE.md documentation updated after code changes requires analyzing commit diffs to identify impacts on domain contracts, dependencies, and invariants, then orchestrating updates across affected files to reflect architectural decisions.

What is the best way to maintain project context across different branches and releases?

Maintaining project context across branches and releases involves coordinating documentation updates at branch completion or release phases, ensuring domain context stays accurate and recording changes with a current timestamp.

When do I need to update domain contracts in my project documentation?

Updating domain contracts in project documentation is needed when code diffs impact APIs, architectural decisions, or system invariants, requiring updates to be mapped and applied across appropriate context files.

How do I detect which code changes require documentation updates for architectural decisions?

Detecting code changes that require documentation updates involves analyzing the latest commit set to identify diffs that impact domain contracts, dependencies, and key architectural decisions, then mapping those changes to the appropriate files.

Can I use CLAUDE.md files to track invariants across multiple domains during change management?

Using CLAUDE.md files to track invariants across multiple domains during change management allows teams to map API changes and architectural decisions to specific domains, keeping distributed context accurate throughout development phases.

Does maintaining project context require updates at the end of a development phase?

Maintaining project context does require updates at the end of a development phase, as well as at branch completion and release, to guide teams in keeping domain context accurate and contracts aligned with the latest code state.