refresh-context

Refresh docs-primary knowledge base docs and detect stale architecture context.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill refresh-context-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-context
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/refresh-context
Command: npx skills add https://github.com/toderian/project_template --skill refresh-context-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture and domain documentation drifts out of sync with code as repositories evolve, forcing agents and developers to re-derive system knowledge from scratch. This Skill audits the docs/resources knowledge base against actual code, task history, and git changes, updating only the docs that evidence shows are stale. ## Core Features & Use Cases - Drift Detection: Builds a candidate change set from git diffs, commit logs since last review dates, and task completion harvests, then maps changed files to registered areas and components. - Evidence-Based Updates: Edits area summaries, dependency graphs, feature contracts, runbooks, and component CONTEXT.md files only when code, tests, or task history prove them stale. - External Storage Support: Redirects writes to a central docs root via the CONTEXT_DOCS_DIR environment variable for cross-repo knowledge bases. - Use Case: After merging a feature that changed a service's public interface, ask the agent to refresh context so the component CONTEXT.md, area dependency graph, and glossary reflect the new reality. ## Quick Start Ask the agent to refresh context and check for documentation drift after the recent code changes.

Frequently Asked Questions about refresh-context

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

FAQPage Schema
How do I refresh stale architecture documentation in a repo?

Invoke the refresh-context workflow, which inventories docs under docs/resources, builds a change set from git diffs and task logs, maps files to areas and components, and updates only docs proven stale by code or task evidence.

How does documentation drift detection work with git history?

The skill runs git diff for uncommitted and upstream changes, plus git log since each doc's recorded review date (or the last 20 commits if none). Changed paths are deduplicated and mapped to registered areas before any edit is made.

Can I store knowledge base docs outside the source repository?

Yes. Set the CONTEXT_DOCS_DIR environment variable to redirect writes to a central docs root, either per area under resources/<area>/ or per repo under <source-repo>/. In-repo docs then serve as fallback evidence only.

When should I not update a context document?

Skip docs when ownership is ambiguous, when evidence only comes from draft or accepted specs, or when generated docs/areas pages are involved since those belong to the ledger generator. Report uncertainties instead of inventing boundaries.

What is the difference between refresh-context and distill-knowledge?

Refresh-context updates existing knowledge base docs using curated _digests as evidence, while raw _inbox processing belongs to the distill-knowledge skill. Refresh is a maintenance workflow, not initial knowledge extraction.