non-destructive-bootstrap

Install agent docs without overwriting or deleting existing content.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

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.
namenon_destructive_bootstrap
descriptionInstall agent docs without overwriting or deleting existing content.
short-descriptionIdempotent bootstrap

Purpose

Integrate templates safely into an existing repository.

Steps

  1. Follow the merge protocol for all changes.
  2. Add missing files without renaming existing ones.
  3. Update references in place using markers only.
  4. Log changes in ACTION_LOG.md and ACTION_LOG.jsonl.

Guardrails

  • Never delete or rename by default.
  • Use .agent-docs/compat/ for conflicts.