contextdocs

---
name: contextdocs
description: Your AI agent maintains its own context files — a Claude Code plugin with an AGENTS-first model that covers Codex, Copilot, Cursor, Gemini, and 3 more tools. Signal Gate filtering, Context Guard hooks, health scoring, and MEMORY.md promotion.
version: "1.5.0" # x-release-please-version
author: Little Bear Apps
tags:
  - ai-context
  - agents-md
  - claude-md
  - context-guard
  - signal-gate
  - claude-code-plugin
---

# ContextDocs — AI Context File Management

## Overview

ContextDocs is a pure Markdown Claude Code plugin that generates, maintains, and audits AGENTS-first AI IDE context files for 8 tools. `AGENTS.md` carries the shared project conventions, and every generated bridge file follows the Signal Gate principle — only what agents cannot discover on their own — keeping context lean and effective.

3 skills, 3 slash commands, 2 quality rules, 6 opt-in hooks, 13 verification checks. 100% Markdown, zero runtime dependencies, MIT licensed.

## When to Use

- Starting a new project and need canonical `AGENTS.md` plus bridge files for multiple tools
- Existing context files have drifted out of date with your codebase
- CLAUDE.md or other bridge files are bloated with content that belongs in `AGENTS.md`
- You want to promote patterns from MEMORY.md into CLAUDE.md
- Need to score context file quality for CI/CD enforcement

## Instructions

1. Install the plugin:
   ```
   /plugin marketplace add littlebearapps/lba-plugins
   /plugin install contextdocs@lba-plugins
   ```

2. Navigate to any project repository

3. Run commands:
   - `/contextdocs:ai-context init` — Bootstrap canonical `AGENTS.md` plus all needed bridges
   - `/contextdocs:ai-context update` — Patch only what drifted
   - `/contextdocs:ai-context promote` — Move MEMORY.md patterns to CLAUDE.md
   - `/contextdocs:ai-context audit` — Check for staleness and drift
   - `/contextdocs:context-guard install` — Install freshness hooks (Claude Code only)
   - `/contextdocs:context-verify` — Score context file health (0–100)

## Output Format

Each generated file is written directly to the repository. `AGENTS.md` is the shared source of truth; bridge files add only tool-specific guidance.

| File | Role | Budget |
|------|------|--------|
| AGENTS.md | Canonical shared context | <120 lines |
| CLAUDE.md | Claude bridge | <80 lines |
| .cursorrules | Cursor bridge | <60 lines |
| .github/copilot-instructions.md | Copilot bridge | <60 lines |
| .windsurfrules | Windsurf compatibility bridge | <60 lines |
| .clinerules | Cline bridge | <60 lines |
| GEMINI.md | Gemini compatibility bridge | <60 lines |

## Notes

- Works with Claude Code and OpenCode natively; generated files support 8 AI tools total
- Signal Gate filtering excludes directory listings, file trees, and architecture overviews
- Context Guard hooks are Claude Code only (opt-in)
- For public-facing documentation (README, CHANGELOG, ROADMAP), see [PitchDocs](https://github.com/littlebearapps/pitchdocs)