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

Ready to run

npx skills add https://github.com/joestump/claude-plugin-design --skill status-joestump

💬 Prompt for ChatGPT / Claude Chat▼

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.