maintain-agentic-system
Installation
SKILL.md
Maintain Agentic System
Use this skill to upgrade, evolve, or audit an existing repository-local Agentic System.
Mission
Move a generated system forward without losing what the repository deliberately changed. Every proposal is a three-way merge against the maintenance baseline Bootstrap wrote, so an upgrade never overwrites a customization by accident and a customization never silently blocks an upgrade.
Non-Negotiable Principles
- Maintain agent-system files only. Never touch application code, schema, migrations, runtime config, or product tests.
- Never read, enumerate, or modify session-folder contents. The session root is a configured path, not a source of evidence.
- Produce a maintenance plan and wait for explicit approval before editing files. Approval is false by default.
- Compare per region against the baseline. A region that only upstream changed is taken; a region that only the repository changed is kept; a region both changed is a question.
- Never declare a Bootstrap delta missing from changelog text alone. Check the repository files first.
- Do not restate the generated-system checklist. It lives in the sibling Bootstrap skill's audit contract; cite the checks that fail.
- Refresh the baseline, the answers file, and the customization register only after the user approves the changes, never before.
- Do not rewrite a working system to match wording. Propose the smallest change that closes a real gap.