MUST be loaded when setting up, installing, migrating, reviewing, auditing, or checking CLAUDE.md files in projects. Covers installing the promode CLAUDE.md into new projects, migrating existing CLAUDE.md content to READMEs (progressive disclosure), and auditing projects for conformance. Invoke PROACTIVELY when user mentions CLAUDE.md, project setup, agent configuration, or code meta files.
View on GitHubplugins/promode/skills/managing-claude-code-meta/SKILL.md
January 16, 2026
Select agents to install to:
npx add-skill https://github.com/mikekelly/opencode-promode/blob/main/plugins/promode/skills/managing-claude-code-meta/SKILL.md -a claude-code --skill managing-claude-code-metaInstallation paths:
.claude/skills/managing-claude-code-meta/<essential_principles> This skill manages projects that adopt the **promode methodology** — a set of principles and workflows for AI agents to develop software. The methodology emphasises TDD, context conservation, progressive disclosure, and clear delegation patterns. **1. CLAUDE.md is for main agent behaviour** CLAUDE.md defines the main agent's role: conversing with users, delegating to sub-agents, and following the promode methodology. It does NOT contain project-specific technical details — those belong in README.md files. **2. Sub-agents use the promode-subagent** Claude Code sub-agents don't inherit CLAUDE.md. The `promode-subagent` mirrors the same methodology so sub-agents apply the same principles. Main agents delegate to promode-subagent rather than instructing sub-agents to read CLAUDE.md. **3. README.md files are the knowledge graph** Each package/directory can have a README.md with domain-specific context. Agents read these just-in-time when working in that area. This keeps initial context lean while making deep knowledge available. **4. Tests are the documentation** Long-lived markdown should cover architecture and principles only. Detailed behaviour documentation belongs in executable tests. If behaviour isn't tested, it's not guaranteed. **5. CLAUDE.md is standardised** The standard CLAUDE.md (`standard/MAIN_AGENT_CLAUDE.md`) should be copied exactly into projects. It is designed to work universally. All project-specific content belongs in README.md files. </essential_principles> <never_do> - NEVER modify `standard/MAIN_AGENT_CLAUDE.md` content — it must be copied exactly into projects - NEVER add project-specific content to CLAUDE.md (use README.md files instead) - NEVER duplicate content between CLAUDE.md and README.md — single source of truth - NEVER skip verifying CLAUDE.md matches the standard after installation or migration </never_do> <escalation> Stop and ask the user when: - Project is not under git version control or has uncommited