Paths: All file refs relative to skills repo root.

Agent Instructions Manager

When to Use

• After editing any instruction file
• After adding/removing MCP servers or hooks
• Before release or publishing
• When sessions degrade (context bloat symptoms)
• First-time project setup (instruction files missing)

Phase 1: Discover Files

CLAUDE.md

.claude/settings.local.json

AGENTS.md

.codex/instructions.md

GEMINI.md

AGENTS.md

found

missing

Phase 1b: Plugin Conflict Check

enabledPlugins

@levnikolaevich-skills-marketplace

1. Read

   ~/.claude/settings.json

   → parse

   enabledPlugins

2. Filter: enabled=true AND publisher ≠

   levnikolaevich-skills-marketplace

3. For each external plugin:
   • Locate cache:

     ~/.claude/plugins/cache/{publisher}/{plugin}/*/skills/*/SKILL.md

   • Read each skill description (frontmatter

     description:

     field)
   • Match against conflict signal keywords:

• Check for

  hooks/session-start

  directory (competing SessionStart injection)

1. Score: 2+ signal categories → CONFLICT. 1 → WARN. 0 → safe
2. CONFLICT:

   "CONFLICT: {plugin} overlaps with ln-* pipeline ({signals}). Disable?"

   → AskUserQuestion → if yes, set to

   false

   in settings.json
3. WARN: report, continue

Phase 2: Create Missing Files

dry_run == true

Step 2a: Detect Project Context

package.json

name

basename(cwd)

package.json

description

[TBD: Project description]

Step 2b: Create CLAUDE.md (if missing)

1. MANDATORY READ: Load

   skills/ln-111-root-docs-creator/references/templates/claude_md_template.md

2. Replace

   {{PROJECT_NAME}}

   ,

   {{PROJECT_DESCRIPTION}}

   ,

   {{DATE}}

3. Mark remaining

   {{...}}

   as

   [TBD: placeholder_name]

4. Write to target project root

Step 2c: Create AGENTS.md (if missing)

# AGENTS.md

Guides in \

Detailed guides in \

Claude Code

Claude

Codex

CLAUDE.md →

AGENTS.md →

| **Code Comments 15-20%** | Writing code | WHY not WHAT. No historical notes. Task/ADR IDs as spec refs only |

Step 2d: Create GEMINI.md (if missing)

# GEMINI.md

Codex

Gemini CLI

AGENTS.md →

GEMINI.md →

during /compact:

during context compression:

Code Comments

Step 2e: Report Creations

Phase 3: Token Budget Audit

wc -w {file}

Phase 4: Prompt Cache Safety

grep -E '\d{4}-\d{2}-\d{2}.\d{2}:\d{2}'

grep -E '\d+ skills|\d+ tools|\d+ servers'

if X then include Y

Phase 5: Content Quality

npm|cargo|pytest|dotnet

"write quality code"

"follow best practices"

NEVER|ALWAYS|MUST|DO NOT

## Compact Instructions

Phase 6: Cross-Agent Consistency

Phase 7: Report

Agent Instructions Manager:

Created:  (omit section if nothing created)
- CLAUDE.md (from template, context from package.json)
- AGENTS.md (derived from CLAUDE.md)

Audit:
| File       | Lines | ~Tokens | Cache-safe | Quality | Issues |
|------------|-------|---------|------------|---------|--------|
| CLAUDE.md  | 80    | 2,100   | OK         | 6/7     | Missing Compact Instructions |
| AGENTS.md  | 77    | 2,000   | OK         | 7/7     | OK |
| GEMINI.md  | 75    | 1,950   | OK         | 7/7     | OK |

Cross-agent: OK (or N inconsistencies listed)

Recommendations:
1. Run /init (ln-100) for full context-aware CLAUDE.md with project-specific rules
2. Add ## Compact Instructions to CLAUDE.md

Definition of Done

• All instruction files discovered
• Missing files created (CLAUDE.md from template, AGENTS/GEMINI derived)
• Token budget within limits (≤2,500 tokens each)
• No prompt cache breakers found (or reported as WARN)
• Content quality checks passed (or issues reported)
• Cross-agent consistency verified
• Report generated with creation log and actionable recommendations
• No conflicting external plugins detected (or user confirmed keep)