| name | ai-guidelines-maintenance |
| description | Maintain Genesix AI instructions, AGENTS.md, Claude/Copilot adapters, skills, and subagent profiles. Use when editing AI guidelines, adding workflows, syncing skills, changing agent behavior, or checking compatibility across Claude, Codex, and GitHub Copilot. |
AI Guidelines Maintenance
Use this skill when maintaining the repository AI guidance system.
Source Of Truth
AGENTS.md is canonical.CLAUDE.md and .github/copilot-instructions.md are adapters..agents/skills is the canonical skill source..claude/skills and .github/skills mirror canonical skills.- Native subagent profiles differ by tool and must remain behaviorally aligned.
Workflow
- Update
AGENTS.md first for shared rules.
- Update adapters only for tool-specific discovery or compatibility.
- Keep skill frontmatter concise and trigger-focused.
- Keep skill bodies short, procedural, and free of duplicated
AGENTS.md content.
- Sync mirrored skills after canonical skill changes.
- Keep subagent roles narrow and explicit.
Compatibility
- Codex reads
AGENTS.md, .agents/skills, and .codex/agents.
- Claude reads
CLAUDE.md, .claude/skills, and .claude/agents.
- Copilot reads
.github/copilot-instructions.md, AGENTS.md, .github/skills, .agents/skills, and .github/agents.
- Do not assume one tool understands another tool's agent profile format.
Validation
Check Markdown readability, expected paths, mirrored skill consistency, and stale references to old source-of-truth language.
