AugmentClaude

Audit Context

Check your project files for conflicts before launching a team environment.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/audit-context-dheerg/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Evaluates ambient context artifacts (CLAUDE.md, memory, local skills, settings hooks) for compatibility with swarm governance. Returns a classified report so users can address interference before launching a team.

What this skill does

Audit Context

Evaluate the user's ambient context artifacts for compatibility with swarm's governance rules. You are a read-only diagnostic — never modify any files.

What to scan

  1. CLAUDE.md files. Read the project's CLAUDE.md (working directory root). If .claude/CLAUDE.md exists, read that too. Also check ~/.claude/CLAUDE.md (global config) — it loads into every session.
  2. Memory files. Find the project memory path by checking ~/.claude/projects/ for a directory matching the current working directory. Claude Code dash-encodes the project path (e.g., /Users/foo/my-project becomes -Users-foo-my-project). If a memory/MEMORY.md index exists, read it and follow links to individual memory files.
  3. Local skills and commands. List .claude/skills/ and .claude/commands/ in the project directory. Flag any skill whose name matches a swarm built-in: suggest-members, refine-outcomes, define-rubric, resolve-dispute, writing-style, code-mode, writing-mode, general-mode, workflow-rules, audit-context.
  4. Settings hooks. Check both .claude/settings.json (project) and ~/.claude/settings.json (global) for a hooks section. Flag any hook that intercepts tools used by swarm (the Agent tool, SendMessage, CronCreate, or TeamCreate on older Claude Code).

How to classify

For each artifact, classify as one of three categories:

  • Complementary — Does not conflict with any swarm rule. Style preferences (brevity, tone, formatting), domain conventions, and tool permissions are complementary by default. No action needed.
  • Potentially Interfering — Could conflict with a swarm rule depending on context. The artifact's intent is benign but its phrasing is broad enough to suppress or alter expected swarm behavior. Worth reviewing.
  • Conflicting — Directly contradicts a named swarm governance rule. Will likely cause unexpected behavior during a team run. Should be addressed before launching.

Swarm governance rules to evaluate against

These are the rules that matter for interference detection:

Workflow control

  • After greenlight, execution is autonomous — no mid-phase confirmations unless escalating per hard rules.
  • The user's request wording is not a greenlight — members wait for the lead to assign work.
  • Phase transitions require facilitator signals (RESEARCH COMPLETE, CONVERGED, CONFIDENCE REACHED).
  • Final delivery requires explicit user sign-off.

Communication

  • facilitator signal obligations are protocol mechanics — they must be sent regardless of communication preferences.
  • Favor brevity during roundtables. No idle chatter.
  • SendMessage is the only channel between teammates — plain text output dies with the turn.

Execution

  • All members except the lead are read-only.
  • The lead is the sole executor — only the lead writes, edits, or runs commands.
  • No code changes during review rounds.
  • Wait for ALL reviews before making changes.

Team structure

  • Briefing templates are fixed — no added sections, task framing, or acknowledgment rituals.
  • Hard rules are non-negotiable and take precedence over ambient preferences.

Common interference patterns

Flag these specific patterns when you encounter them:

PatternExampleClassificationConflicting rule
Confirmation injection"Always confirm before editing"ConflictingAutonomous post-greenlight execution
Auto-commit/push"Commit after completing work"ConflictingFinal delivery requires user approval
Silence preferences"Don't repeat yourself", "Stay silent while waiting"Potentially Interferingfacilitator signal obligations
Verbosity injection"Explain your reasoning step by step"Potentially InterferingFavor brevity during roundtables
Methodology injection"Always use TDD", "Write tests first"Potentially InterferingPhase arc is defined by mode skill
Tool restrictions"Don't spawn agents", "Never use TeamCreate"ConflictingCreate the team per Step 8a
Briefing expansion"Add detailed context to all briefs"ConflictingBriefing templates are fixed
Skill name collisionLocal suggest-members skillConflictingShadows swarm built-in
Hook tool interceptionHook that blocks the Agent tool, TeamCreate, or SendMessageConflictingTeam creation and communication require these tools

Output format

Present findings as a structured report grouped by source:

## Audit Results

### CLAUDE.md — [path]
- [excerpt] — **[Classification]** — conflicts with: [rule name]. [One-line recommendation.]

### Memory — [path]
- [excerpt] — **[Classification]** — conflicts with: [rule name]. [One-line recommendation.]

### Local Skills / Commands
- [name] — **[Classification]** — [reason]. [One-line recommendation.]

### Settings Hooks — .claude/settings.json
- [hook name / tool target] — **[Classification]** — [reason]. [One-line recommendation.]

### Summary
- Complementary: [count]
- Potentially Interfering: [count]
- Conflicting: [count]

If no artifacts are found, say so. If all artifacts are complementary, say "No interference detected — your environment is clean for swarm runs."

Related skills