Instruction Manager

Instruction Manager

Orchestrates the synchronization of instruction templates to ensure consistent AI behavior across different platforms and projects.

Overview

The instruction-manager skill provides a unified workflow for maintaining the complex hierarchy of AI instructions used in this environment. It ensures that changes made to core principles in "Master" templates are correctly propagated to platform-specific configuration files.

Workflow: Global Instruction Sync

Use this workflow when you update core behavioral principles in the master template.

1. Edit Master Template: Modify templates/​global-instructions/​master.md.
2. Run Sync Script:

   ./​scripts/​update-global-instructions.sh --system=all
   

   • --system: gemini, claude, copilot, opencode, or all.
   • --dry-run: Show what would be updated without making changes.
3. Verify Changes: Check the target files (e.g., gemini/​.gemini/​GEMINI.md, claude/​.claude/​CLAUDE.md) to ensure the sync was successful.

SECTION Syntax (Inclusion/​Exclusion)

Use SECTION markers to include/​exclude content for specific systems:

<!-- SECTION:name:START:system1,system2 -->
Content for system1 and system2 only
<!-- SECTION:name:END -->

<!-- SECTION:name:START:!copilot -->
Content for all systems EXCEPT copilot
<!-- SECTION:name:END -->

• Include list: copilot,claude — only those systems see this block
• Exclude prefix: !copilot — all systems EXCEPT copilot see this block

Works in both global instructions (templates/​global-instructions/​master.md) and subagent masters (templates/​subagents/​master/​*.md).

Workflow: Project Initialization

Use this workflow when starting a new project or updating instructions for an existing one.

1. Generate Instructions:

   ./​scripts/​generate-project-instructions.sh [path/​to/​project]
   

2. Update Existing:

   ./​scripts/​generate-project-instructions.sh --update --force --set-technologies="React, TypeScript" .
   

   • This generates .claude/​CLAUDE.md, .gemini/​GEMINI.md, and AGENTS.md based on templates/​PROJECT_INSTRUCTIONS.template.md.

Workflow: Sub-Agent Management

Use this workflow when modifying specialized sub-agent (Planner, Reviewer, etc.) behaviors.

1. Edit Agent Master: Modify files in templates/​subagents/​master/ (e.g., planner.md). Use SECTION markers for platform-specific content.
2. Sync Agents:

   ./​scripts/​update-subagents.sh --agent=all --system=all
   

   • --agent: planner, reviewer, implementer, coordinator, prompt-creator, or all.
   • --system: copilot, opencode, claude, or all.
   • --dry-run: Show what would be updated without making changes.
3. Validate Sync:

   ./​scripts/​validate-subagents.sh
   

Reference: Instruction Hierarchy

Resources

scripts/

The skill leverages the following root-level scripts:

• update-global-instructions.sh: Syncs global master to platform headers.
• generate-project-instructions.sh: Scaffolds project-specific context.
• update-subagents.sh: Populates sub-agent instruction files.
• validate-subagents.sh: Checks consistency between agent platforms.

references/

• templates/​global-instructions/​metadata.json: Defines target paths and header requirements for each tool.
• templates/​subagents/​master/​METADATA.json: Defines agent names, descriptions, and platform-specific overrides.