skills.rest
zorgentech
zorgentechOFFICIAL
Explore all skills by this author →
GitHub

adr-approve

Move approved ADR files to docs/adr and update status via GitHub CLI.

Updated Aug 27, 2026
Search Tags:#automation#git#github#adr#approval#docs-management#architecture-decision-record
One-click install
npx skills add https://github.com/zorgentech/archon --skill adr-approve
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-approve
Source: https://github.com/zorgentech/archon/tree/main/.claude/skills/adr-approve
Command: npx skills add https://github.com/zorgentech/archon --skill adr-approve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the manual, error-prone process of approving Architectural Decision Records by automating the move from the pending folder to the canonical ADR directory, updating status metadata, modifying the README index, labeling the related pull request, and committing the changes so repository status checks can proceed.

Core Features & Use Cases

  • Safe Approval Workflow: Identifies a target ADR file, asks for explicit user confirmation before any destructive action, and then executes the approval steps.
  • Repository Automation: Moves ADR from docs/adr/potential-adr to docs/adr, updates frontmatter status and date, updates README sections, adds adr-approved label to the associated PR, and commits and pushes the change.
  • Use Case: When an architecture proposal has been reviewed and accepted, use this Skill to finalize the ADR, update documentation and CI status with a single, guided operation.

Quick Start

Approve ADR number 0013 by running the adr-approve skill with the ADR number so it moves the file to docs/adr, updates status and README, labels the PR, commits, and pushes the change.

Frequently Asked Questions about adr-approve

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

FAQPage Schema
How do I approve and publish an Architectural Decision Record from a pending directory to the main docs folder?▼

To approve an Architectural Decision Record, the Skill moves the ADR file from docs/adr/potential-adr to docs/adr, updates its frontmatter status and date, adjusts the README, and commits the changes after user confirmation.

How do I automatically label a pull request when an ADR is approved?▼

When an ADR is approved, the Skill uses the GitHub CLI to add an adr-approved label to the associated pull request, helping clear repository status checks automatically as part of the commit and push workflow.

What is the safest way to move ADR files and update repository documentation without losing metadata?▼

The safest way to move ADR files is using a guided approval workflow that requests explicit user confirmation before performing any file move, frontmatter status change, README update, or git commit.

Can I update ADR frontmatter status and date automatically during the publication process?▼

Yes, the Skill updates ADR frontmatter status and date automatically when moving the file from the pending directory to the canonical ADR directory, ensuring the published record reflects the current approval state.

Does the ADR approval process also update the README index for the repository?▼

Yes, the ADR approval process updates the README index sections automatically when the ADR file is moved and published, ensuring repository documentation remains synchronized with the newly approved architectural decision record.

Related Skills

Explore More Software Engineering Skills→
im9im9
1

adr-done

Update ADR status and archive the file in docs/ai/adr.

Community
Intermediate
canpok1canpok1

github

Automate GitHub issues, pull requests, and review threads via gh CLI.

Community
Advanced
lachlanchenlachlanchen
1

publish-repo

Automates Git-to-GitHub publishing with multilingual READMEs, metadata, and CITATION.cff files.

Community
Advanced
c-tomiokac-tomioka

adr-madr

Generate MADR-compliant architectural decision records from git logs, pull requests, or freeform text.

Community
Intermediate