ai-instruction-and-memory-files

Audit placement of AI instructions across CLAUDE.md, AGENTS.md, and auto-memory files.

4|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/jcdendrite/claude-config --skill ai-instruction-and-memory-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-instruction-and-memory-files
Source: https://github.com/jcdendrite/claude-config/tree/main/claude/.claude/skills/ai-instruction-and-memory-files
Command: npx skills add https://github.com/jcdendrite/claude-config --skill ai-instruction-and-memory-files

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents duplicated, stale, or mis-scoped guidance by helping you decide whether a rule belongs in CLAUDE.md, a skill-specific SKILL.md, or Claude Code auto-memory.

Core Features & Use Cases

  • Stops instruction rot via de-duplication: checks whether the same rule already exists in CLAUDE.md or AGENTS.md so it is not restated in MEMORY.
  • Correctly routes by scope: distinguishes global team instructions (CLAUDE.md/AGENTS.md) from per-skill instructions (skill SKILL.md) and per-user learnings (project auto-memory).
  • Enforces Claude Code memory discipline: ensures MEMORY.md remains an index and that loaded memory content stays within the documented startup-load constraints.
  • Aligns with deterministic gating: activates a session marker so the workflow can reliably validate routing decisions before memory writes proceed.

Quick Start

Use the ai-instruction-and-memory-files skill when you are updating CLAUDE.md, AGENTS.md, or a ~/.claude/projects/<project>/memory file and need to decide where the new rule should live.

Frequently Asked Questions about ai-instruction-and-memory-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent duplicate rules across CLAUDE.md and Claude Code auto-memory files?

Claude Code memory routing determines whether rules belong in CLAUDE.md, AGENTS.md, or auto-memory files based on scope. Global team instructions go in CLAUDE.md, per-skill rules in SKILL.md, and personal learnings in project auto-memory.

What is the best way to organize Claude Code instructions by team-wide, personal, or skill scope?

When updating CLAUDE.md or AGENTS.md, activate a memory-skill gate session to validate routing decisions before writes proceed. This enforces anti-duplication heuristics and aligns with Claude Code load constraints.

Why does Claude Code load stale or duplicated instructions from memory files?

Claude Code auto-memory files should capture per-user learnings, not team-wide instructions. Global rules belong in CLAUDE.md or AGENTS.md, while skill-scoped rules go in SKILL.md to prevent duplication and instruction rot.

Does Claude Code enforce import precedence between AGENTS.md and CLAUDE.md memory?

Before writing new rules to CLAUDE.md or auto-memory, audit existing entries to check for duplicates. This skill enforces anti-duplication heuristics and activates a session marker to validate routing decisions before memory writes proceed.