context-review

Synchronize .context/ documentation with the current codebase state.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scans the current codebase and synchronizes .context/ documentation with the actual state of the code. This keeps architecture, domain decisions, and standards docs accurate without human effort.

Core Features & Use Cases

  • Pre-flight checks to ensure the codebase has a valid context baseline and reads from .context/cache/context_update.md to determine freshness.
  • Step-by-step execution that updates overview.md, domains/, architecture.md, and standards.md sections in .context/.
  • Cache-write behavior that produces a context_update.md reflection of the changes and preserves hand-authored narratives.

Quick Start

Run the context-review skill at the start of an architect task to refresh the .context/ documentation for the current codebase.

Frequently Asked Questions about context-review

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

FAQPage Schema
How do I synchronize architecture documentation with my codebase?

You can synchronize architecture documentation by scanning the current codebase and updating the `.context/` directory to align architecture, domain decisions, and standards docs with the actual code state without modifying source files.

When do I need to update my codebase context documentation?

You need to update codebase context documentation at the start of an architect or design task, especially when the context cache is stale or missing for more than five days, or when targeting a full project or specific modules.

What is the best way to keep domain decisions and standards docs accurate without manual effort?

The best way to keep domain decisions and standards docs accurate is to run an automated context synchronization process that reads the codebase and updates `.context/` files, preserving hand-authored narratives while reflecting code changes.

Does context synchronization modify my source code during execution?

Context synchronization does not modify source code during execution. It strictly reads the codebase to update documentation files like `overview.md`, `architecture.md`, and domain standards, then writes a cache record.

How does the context cache determine documentation freshness?

The context cache determines documentation freshness by reading `.context/cache/context_update.md` during pre-flight checks to verify if the existing context baseline is valid or if a resynchronization is required.

Can I target a specific module for documentation synchronization instead of the full project?

Yes, you can target a specific module for documentation synchronization. The process operates on either a full project or specific modules, updating the corresponding `.context/` files to match the targeted code areas.