skills.rest
joestump
joestumpCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

status

Update status fields in ADR and spec YAML frontmatter.

30|2|Updated Feb 13, 2026
Search Tags:#documentation#adr#spec#status#yaml frontmatter#architecture-governance
One-click install
npx skills add https://github.com/joestump/claude-plugin-design --skill status-joestump
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: status
Source: https://github.com/joestump/claude-plugin-design/tree/main/skills/status
Command: npx skills add https://github.com/joestump/claude-plugin-design --skill status-joestump

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keep architecture decision records (ADRs) and specification documents accurately reflected by making it easy to change their status metadata without manually editing files or risking content corruption.

Core Features & Use Cases

  • Automated Frontmatter Updates: Parse YAML frontmatter and update or add a status field for ADR or spec documents.
  • Discovery and Validation: Scan the repository for matching ADR- or SPEC-identifiers, present choices when ambiguous, and enforce valid status values for ADRs and specs.
  • Non-destructive Edits: Modify only the YAML frontmatter and report the exact change made, preventing accidental edits to document content.

Quick Start

Update ADR-0003 to accepted.

Frequently Asked Questions about status

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

FAQPage Schema
How do I update the status of an ADR or spec document without editing the content?▼

To update an ADR or spec status without altering content, this Skill parses and modifies only the YAML frontmatter. It locates the target file using glob patterns and safely updates the status field while preserving the document body.

What status values can I assign to architecture decision records?▼

Allowed status values for architecture decision records include proposed, accepted, review, implemented, deprecated, and superseded. The Skill validates any requested status change against this allowed list to enforce proper governance workflows.

Can I add YAML frontmatter to a spec file that does not have any metadata yet?▼

Yes, you can add YAML frontmatter to a spec file lacking metadata. The Skill will parse the document, insert the missing YAML frontmatter block, apply the desired status field, and leave the existing document content untouched.

What is the best way to batch update multiple ADR statuses during a release process?▼

The best way to batch update ADR statuses during a release is by using glob patterns to locate matching files. The Skill scans the repository for ADR-identifiers, validates the new status, and reports each exact frontmatter change individually.

How does this tool handle ambiguous ADR or spec file names in a repository?▼

When ambiguous file names are found, the Skill presents the matching ADR- or SPEC-identifiers as choices. This discovery mechanism ensures you select the correct document before any frontmatter validation or status editing occurs.

Does this Skill work with repositories that have no existing ADR directory structure?▼

The Skill applies to repositories with ADRs and specs by locating files using glob patterns. Without existing ADR or spec files matching the pattern, it will not find targets to parse or add YAML frontmatter to for status updates.

Related Skills

Explore More Software Engineering Skills→
b12consultingb12consulting
2

specs-setup

Initializes a spec-driven project structure with templates for requirements and governance.

Official
Intermediate
DhumitechDhumitech

architecture-decision-records

Document architecture decisions with standardized ADR templates and lifecycle statuses.

Community
Advanced
CuriousCrow123CuriousCrow123

compound-docs

Generate categorized Markdown documents with YAML frontmatter for solved problems.

Community
Advanced
tiweentiween

bmad-spec

Converts intent input into structured SPEC kernels using Python scripts and YAML configurations.

Official
Advanced