ClawdContext: A VS Code Markdown OS for AI Programming Agents

ClawdContext is a VS Code extension with the core philosophy of 'Stop prompting. Start orchestrating'. It treats Markdown files for AI programming agents as an operating system rather than a pile of prompts. Through features like the CER dashboard, Markdown OS rule checks, lesson governance, and SKILL.md security scans, it enables systematic context management and improves AI programming efficiency.

With the popularity of AI programming assistants like Claude Code and GitHub Copilot, developers face new challenges in context management for complex projects—simple prompt stacking can no longer meet their needs. ClawdContext emerged to address this issue, elevating the context management of agents to a systematic operation.

ClawdContext proposes a structured file organization model where different types of information correspond to specific files:

File	Role
CLAUDE.md / AGENTS.md	Kernel: invariants, non-negotiables, short checklists
SKILL.md	On-demand procedures: reusable workflows, operation manuals
todo.md	Local task status: plans, constraints, completion criteria
lessons.md	Governed learning cache: validated lessons + metadata + TTL
This model ensures each type of information has a clear location and purpose, avoiding context confusion.

ClawdContext's core features run locally without external AI services:

1. CER Dashboard and Status Bar: Monitors token consumption of "always loaded" context and remaining reasoning space, displays the Context Efficiency Ratio (CER) metric in real time, and provides a visual distribution overview.
2. Markdown OS Rule Checker: An mdcc-style diagnostic tool that checks for rule violations (format issues, structural inconsistencies, missing metadata, etc.) in kernel, skill, lesson, and task files.
3. Lesson Governance: Supports TTL detection, staleness detection, metadata enforcement, and pruning/archiving workflows to manage lesson files.
4. SKILL.md Security Scanner: Detects suspicious patterns, provides rulings, quantifies security scores for each skill, and prevents harmful instructions.
5. Refactoring and Code Operations: Offers quick-fix features (extract procedures to SKILL.md, move heuristics to lessons, etc.).

After configuring an AI provider, enhanced features can be unlocked: diagnostic explanations, semantic contradiction detection, intelligent experience verification, refactoring suggestions, and deep security reviews. Supported providers include OpenAI-compatible, Anthropic-compatible, Azure OpenAI, Ollama (local), and DeepSeek-compatible.

Value: Addresses context window limitations (optimizes token usage), improves maintainability (governance tools keep files organized), enhances security (SKILL.md security scans), and promotes team collaboration (standardized check mechanisms). Application Scenarios: Individual developers (managing AI assistant configurations), small teams (standardizing usage), large organizations (governing context files), open-source projects (lowering contribution barriers).

Limitations: Currently mainly supports Claude-centric Markdown conventions; support for specific formats of other AI assistants like GPT and Gemini is limited. Future Directions: Expand support for more AI provider formats, add team collaboration features, integrate context quality checks with CI/CD, and strengthen AI-assisted refactoring functions.

ClawdContext represents the evolution direction of AI programming tools—from focusing on individual prompts to managing systematic contexts, treating AI assistant configurations as an operating system that needs governance, monitoring, and optimization. For developers who use AI programming assistants seriously, it not only improves efficiency but also establishes sustainable AI-assisted development practices, serving as an important distinguishing mark between professional and amateur users.