renumber-adr

Renumber conflicting ADR files and update references before merging a pull request.

Updated May 31, 2026
One-click install
npx skills add https://github.com/ascerra-fullsend-rehearsal/fullsend --skill renumber-adr-ascerra-fullsend-rehearsal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: renumber-adr
Source: https://github.com/ascerra-fullsend-rehearsal/fullsend/tree/main/skills/renumber-adr
Command: npx skills add https://github.com/ascerra-fullsend-rehearsal/fullsend --skill renumber-adr-ascerra-fullsend-rehearsal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Prevents number collisions in ADRs when merging a PR that adds new ADRs to avoid issues with concurrently merged ADRs.

Core Features & Use Cases

  • Conflict Detection: Identifies ADR numbers that conflict with existing ADRs on the target branch.
  • Renumbering: Automatically renumbers conflicting ADRs to avoid conflicts.
  • Repository-wide Updates: Updates all internal and external references to the ADR.
  • Use Case: Before merging a PR that introduces new ADRs, run this skill to ensure that ADR numbers do not conflict with existing ones.

Quick Start

Run the renumber-adr skill before merging a PR that adds new ADRs.

Frequently Asked Questions about renumber-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent ADR number conflicts when merging a pull request?▼

To prevent ADR number conflicts when merging a pull request, you can run a renumbering process that automatically renames conflicting ADR files to ensure unique four-digit identifiers across the target branch.

Why do my ADR files have number collisions after a GitHub PR merge?▼

ADR files have number collisions after a GitHub PR merge when concurrently merged pull requests introduce new records with identical four-digit identifiers, causing conflicts on the target branch.

How does ADR renumbering update internal and external references?▼

ADR renumbering updates internal and external references by automatically detecting conflicting ADR numbers and renaming the files across the entire repository to maintain consistent links.

When should I renumber ADR files in my repository?▼

You should renumber ADR files in your repository immediately before merging a pull request that introduces new ADRs, ensuring they do not conflict with existing records on the target branch.

Can I automatically resolve ADR numbering conflicts across a whole repository?▼

Yes, you can automatically resolve ADR numbering conflicts across a whole repository by running a script that detects collisions and renames files to establish unique four-digit identifiers.