Renames an aiwf entity's slug while preserving its id and references.
npx skills add https://github.com/23min/aiwf --skill aiwf-rename-23min
Please help me install this Agent Skill. Skill: aiwf-rename Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-rename Command: npx skills add https://github.com/23min/aiwf --skill aiwf-rename-23min
git mv breaks the audit trail and skips the structured commit trailers that aiwf history relies on. This Skill runs the dedicated aiwf rename verb so the slug changes while the stable id, references, and lifecycle history stay intact. ## Core Features & Use Cases - Slug-only rename: Changes the human-readable suffix of an entity's path (e.g., M-NNNN-things to M-NNNN-acceptance-criteria) without touching the id or title. - Automatic normalization: Converts the new slug to kebab-case, lowercasing and collapsing non-alphanumerics, and refuses only when normalization yields an empty string. - Auditable commits: Performs the git mv and commits with aiwf-verb: rename, aiwf-entity, and aiwf-actor trailers so aiwf history shows the rename. - Use Case: A milestone was created with a vague slug and the team wants the directory name to read M-0007-acceptance-criteria; run the rename verb and every id-based reference in other entities keeps working. ## Quick Start Ask the assistant to rename the slug of entity M-0007 to acceptance-criteria using the aiwf rename verb.High-intent search queries and answers about installing and using this skill.
Run `aiwf rename <id> <new-slug>` to change the slug portion of the entity's path. The tool performs a git mv, normalizes the slug to kebab-case, and commits with structured trailers so the id and all references stay valid.
aiwf rename changes the slug, the human-readable suffix in the file or directory name, while aiwf retitle changes the entity's title, the prose label in frontmatter. The verbs are kept separate so each mutation stays a single, local change.
No. References between entities use the stable id, not the slug, so renaming the slug leaves all references working. The frontmatter id and title are both unchanged by the rename operation.
A manual git mv skips the structured commit trailers that aiwf attaches to every mutation. Without those trailers, `aiwf history <id>` will not show the rename in the entity's lifecycle.
No. The rename verb only changes the slug; use `aiwf reallocate` to change the id portion. Changing an entity's kind is not supported — create a new entity and link it via addressed_by or relates_to instead.
WindXRanConvert an epic and GDD acceptance criteria into traceable story markdown files.
TMI-appsValidate and push committed Git changes to a remote repository.
dnsnamdangLog entity record modifications with user information and timestamps in PHP.
Avila-TekGenerate and update docs/domain_model.md from project context and logs.