skills.rest
23min
23minCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

aiwf-retitle

Updates entity frontmatter titles via the aiwf retitle verb with atomic commits.

Updated May 9, 2026
Search Tags:#markdown#project tracking#frontmatter#entity management#retitle#aiwf#git trailers
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwf-retitle-23min
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aiwf-retitle
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-retitle
Command: npx skills add https://github.com/23min/aiwf --skill aiwf-retitle-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an entity's scope changes, its frontmatter title becomes stale while the slug and body stay correct. Hand-editing the title bypasses the aiwf verb route, so the change never appears in aiwf history and the next aiwf check raises a provenance-untrailered-entity-commit warning. ## Core Features & Use Cases - Verb-route title updates: Runs aiwf retitle <id> "<new-title>" for any of the six entity kinds (epic, milestone, ADR, gap, decision, contract) in one atomic commit with proper trailers. - Composite AC retitling: Updates an acceptance criterion's title inside a parent milestone via aiwf retitle M-NNNN/AC-N, regenerating the matching ### AC-N body heading. - Slug and H1 sync: Re-derives the on-disk slug only when it still tracks the old title, preserves slugs set by aiwf rename, and rewrites canonical # <ID> — <title> H1 headings. - Use Case: After a milestone's scope shifts from "user auth" to "identity and access", retitle it so aiwf status, aiwf show, and the roadmap display the correct label without breaking history. ## Quick Start Ask the AI to retitle entity M-0003 to "identity and access management" using the aiwf retitle verb with a reason for the change.

Frequently Asked Questions about aiwf-retitle

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

FAQPage Schema
How do I change an entity title in aiwf?▼

Run `aiwf retitle <id> "<new-title>"` with an optional `--reason` flag. It rewrites the frontmatter title, syncs the canonical H1, and commits with proper trailers in one atomic commit.

What is the difference between aiwf retitle and aiwf rename?▼

Retitle changes the frontmatter title, the human-readable label shown in status and history. Rename changes only the slug, the path component. A slug set by rename is preserved by later retitles.

Can I retitle an acceptance criterion inside a milestone?▼

Yes, use a composite id like `aiwf retitle M-NNNN/AC-N "<new-title>"`. It updates the AC's title in the milestone's acs[] frontmatter and regenerates the matching `### AC-N` body heading atomically.

Why does hand-editing frontmatter cause aiwf check warnings?▼

Direct edits bypass the verb route, so no aiwf-verb trailer is recorded. The next `aiwf check` reports `provenance-untrailered-entity-commit`, and `aiwf history` cannot show the change.

What happens if I retitle to the same title?▼

If the canonical H1 already matches, the command reports nothing to retitle and exits 0 without committing. If the H1 has drifted, it rewrites the H1 and commits that fix.

Related Skills

Explore More Software Engineering Skills→
vddgmbhvddgmbh

create-justification

Create justification files with unique IDs and frontmatter in .agents/justifications/.

Official
Intermediate
penpotpenpot
59.4k

create-issue

Creates or updates GitHub issues from PRs, draft bodies, or retitling workflows.

Official
Basic
TMI-appsTMI-apps
2

push

Validate and push committed Git changes to a remote repository.

Official
Intermediate
autopus-aiautopus-ai
111

lore-commit

Writes structured commit messages with Lore decision-record trailers.

Official
Basic