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.