non-destructive-bootstrap
Install agent docs without overwriting or deleting existing content.
When & Why to Use This Skill
The non_destructive_bootstrap Claude skill provides a safe, idempotent method for integrating agent documentation and templates into existing repositories. It ensures that new agent infrastructure is added without compromising or overwriting pre-existing project content by following a strict merge protocol and utilizing guardrails against file deletion.
Use Cases
- Legacy Codebase Integration: Safely inject agent-related documentation and configuration markers into established projects without the risk of disturbing existing file structures or custom settings.
- Idempotent Environment Setup: Execute repository bootstrapping multiple times across different developer environments while ensuring that no files are accidentally deleted or renamed.
- Conflict-Free Template Updates: Automatically manage file conflicts during template updates by utilizing a dedicated compatibility directory and logging all changes for transparent audit trails.
| name | non_destructive_bootstrap |
|---|---|
| description | Install agent docs without overwriting or deleting existing content. |
| short-description | Idempotent bootstrap |
Purpose
Integrate templates safely into an existing repository.
Steps
- Follow the merge protocol for all changes.
- Add missing files without renaming existing ones.
- Update references in place using markers only.
- Log changes in
ACTION_LOG.mdandACTION_LOG.jsonl.
Guardrails
- Never delete or rename by default.
- Use
.agent-docs/compat/for conflicts.