What is the difference between structural and semantic checks?

Structural checks are programmatic (finding missing files or dead paths), while semantic checks involve the AI analyzing the content to find outdated logic, superseded decisions, or contradictory rules.

What is context drift in AI coding?

Context drift occurs when project documentation, architectural notes, or conventions no longer match the actual state of the codebase, which can lead to AI hallucinations or errors.

How does ctx-drift fix structural issues?

It uses the 'ctx drift --fix' command to automatically remove or update references to files that have been moved, renamed, or deleted within the context files.

When should I run the ctx-drift skill?

It is best used after refactoring code, at the start of a session to verify health, or whenever you notice the AI is referencing files that no longer exist.

Can this skill update my local permissions automatically?

No. For security reasons, it only reports permission drift in settings.local.json and provides the user with a report to make manual updates.

Context Drift Detector

Name: Context Drift Detector
Author: ActiveMemory

byActiveMemory

•

学习与文档

Identifies and repairs inconsistencies between project documentation and actual code to maintain AI context accuracy.

The Context Drift Detector is an essential maintenance tool for the ctx system, ensuring that AI coding assistants always work with accurate, up-to-date project information. It performs dual-layer analysis: structural checks to find dead file paths or missing references, and semantic analysis to identify outdated conventions or superseded architectural decisions. By proactively resolving 'context rot,' this skill prevents the AI from making hallucinations based on stale data, streamlines session rehydration, and ensures that your project's ARCHITECTURE.md and CONVENTIONS.md files remain a source of truth.

主要功能

01Skill template verification to ensure local tools match canonical versions

02Semantic audit of conventions, decisions, and architectural diagrams

03Dual-layer detection of structural and semantic context drift

04Permission drift monitoring for secure and consistent agent access

0536 GitHub stars

06Automated fixing of stale file paths and broken references via CLI

使用场景

01Verifying project health and documentation accuracy at the start of a new coding session

02Syncing context files and architectural notes immediately after major refactors or file renames

03Cleaning up cluttered task lists and archiving irrelevant learnings to improve AI focus

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activememory/ctx ctx-drift

For use in Claude.ai and ChatGPT

Download Skill