business-context-os: Skill for Claude Code

Context Audit

Purpose

This skill IS:

• Auditing context data points for CLEAR compliance
• Finding duplication and ownership conflicts across data points
• Identifying boundary violations between context areas
• Enforcing consistency in naming, format, and structure
• Providing prioritized findings with improvement recommendations

This skill IS NOT:

• Making changes to context (audit only -- findings guide manual fixes)
• A fix-it tool (this finds problems, you fix them based on findings)
• Checking markdown syntax (use doc-lint for that)
• Planning new work (use clear-planner for that)

---

---

Instructions

Step 1: Define Audit Scope

Pre-read (cheap, do this first): if docs/document-index.md exists, read it before asking the scope question. It gives you the canonical inventory of active data points by cluster, ownership, and last-updated date — enough to suggest a smart default scope (e.g., "you have 14 data points across 3 clusters; 4 haven't been touched in 90+ days — audit those?") instead of asking blind. If absent, fall back to the question below directly.

If not specified, use the AskUserQuestion tool:

• Question: "What should I audit?"
• Options:
  • Specific area (e.g., competitive intelligence data points)
  • Full architecture (all active data points — comprehensive)
  • Recent changes (only docs modified recently)
  • Cross-cutting concern (e.g., all pricing-related data points across clusters)

---

Step 2: Gather and Check Metadata

Context window strategy: For scopes with 20+ documents, delegate the metadata scanning to an explore agent. Keep the main window for CLEAR analysis (Step 3).

# For large scopes:
Agent (Explore): "Read all .md files in [scope]. Skip dot-prefixed files
(.session-diary.md, .wake-up-context.md, .onboarding-checklist.md) — these are
conventions, not managed data points. For each remaining file, extract YAML
frontmatter and check: all 7 required fields present? status valid? last-updated
within 90 days (180 days for _planned/)? Return a validation table."