Self Update

Self-Update Meta Skill

Purpose: Automatically update the AGENTS.md system when its components change. Keeps routing tables, README files, and documentation in sync.

Trigger

When: Any agent, skill, or instruction file is created, modified, or deleted Context Needed: Changed file, change type, current system state MCP Tools: read_file, replace_string_in_file, list_dir

Watched Paths

Update Chains

New Agent Added

Security.agent.md created
    ↓
1. Update agents/README.md (add to table)
2. Update AGENTS.md (add routing keywords)
3. Update copilot-instructions.md (if major)

New Skill Added

new-skill/skill.md created
    ↓
1. Update skills/README.md (add to table)
2. Update trigger events table
3. Link to relevant agents

Agent Modified

Backend.agent.md modified
    ↓
1. Check if keywords changed → update AGENTS.md
2. Check if tools changed → update README MCP section
3. Bump version in agent file

Auto-Update Fields

In Agent/Skill Files

version: "1.0.0" # Bump on changes
last_updated: "YYYY-MM-DD" # Set to today

In README Files

| Agent | File | Domain | Primary MCP Tools |

# Re-scan directory and rebuild table

In AGENTS.md

## Agent Routing

| Keywords | Route To |

# Re-scan agent keywords and rebuild

Version Bumping Rules

Consistency Checks

After any update:

• All agents in README table
• All skills in README table
• AGENTS.md routing matches agent keywords
• No duplicate agent_ids or skill_ids
• All file references resolve

Changelog Maintenance

When system changes, add to AGENTS.md changelog:

## Change Log

| Version | Date       | Changes                                                        |
| :------ | :--------- | :------------------------------------------------------------- |
| 4.0.0   | 2026-01-26 | Added @Security, @DataArchitect, @SyncEngineer, @DevOps agents |

Workflow

1. Detect change - What file changed?
2. Parse metadata - Read YAML frontmatter
3. Identify updates - What else needs changing?
4. Apply updates - Modify affected files
5. Validate - Run consistency checks
6. Report - List all changes made

Output Report

{
  "trigger": "Security.agent.md created",
  "updates": [
    { "file": "agents/README.md", "action": "add_row" },
    { "file": "AGENTS.md", "action": "add_routing" },
    { "file": "copilot-instructions.md", "action": "add_to_mcp_table" }
  ],
  "validation": "passed"
}

Reference

• AGENTS.md
• agents/README.md
• skills/README.md