[hyperpolymath]

Summary

Comment-only follow-up. An earlier PR replaced "uuid is immortal" in the CLADE status comment with "uuid follows the forge path". This one makes it exact. gv-clade-index ADR 0007 (accepted 2026-11-10) derives the uuid from the GitHub path (UUIDv5 over github.com/<owner>/<name>): a move or rename on GitHub mints a new one, and a mirror move or a phase change never does.

A2ML is retired for new content. Correcting a factually wrong comment in an existing file is an edit, not new content.

Changes

• .machine_readable/CLADE.a2ml: "uuid follows the forge path" → "uuid follows the GitHub path (a move or rename there mints a new one, gv-clade-index ADR 0007; a mirror move or a phase change never does)"; "A prefixed-name (clade code) change is NOT a phase change" → "A prefixed-name (clade code) change with the GitHub path unchanged is NOT a phase change". The paragraph is re-wrapped at 80 columns. No data values change. The owner approved this wording for the whole estate. It refines the wording merged earlier.

RSR Quality Checklist

Required

• Tests pass (just test or equivalent): not run locally. Comment-only change, left to CI.
• Code is formatted (just fmt or equivalent): n/a, no code
• Linter is clean (no new warnings or errors): n/a, no code
• No banned language patterns
• No unsafe blocks without // SAFETY: comments
• No banned functions
• SPDX license headers present on all new/modified source files (not touched)
• No secrets, credentials, or .env files included

Testing

The diff is one comment paragraph in one file. Every line is ≤80 characters. The commit is signed.

---

Generated by Claude Code

[coderabbitai]

No actionable comments were generated in the recent review.

Summary

Summary by CodeRabbit

• Documentation
  • Clarified that an item’s UUID follows its GitHub path and remains unchanged when its mirror location or phase changes.
  • Clarified that changing the prefixed name without changing the GitHub path records the previous name as an alias, while preserving the UUID and phase.

The lifecycle comment now defines UUID identity by the GitHub path. It clarifies how mirror moves, phase changes, and prefixed-name changes affect UUIDs, phases, and aliases.

Changes: Lifecycle identity

Layer / File(s)	Summary
UUID and alias rules .machine_readable/CLADE.a2ml	The lifecycle comment states that mirror moves and phase changes do not mint a UUID. If the prefixed name changes while the GitHub path stays the same, the old name moves to aliases[], and the UUID and phase stay unchanged.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Change: Other

Possibly related PRs

• hyperpolymath/docudactyl#93: Both PRs revise the lifecycle comment’s rules for UUID changes.

Merge Risk: Minimal · up to dca4a

The change clarifies UUID and alias rules. No merge-blocking risk is evident from the supplied evidence.

Pre-merge checks: 4

Check name	Status	Explanation
Title check		The title clearly describes the main change: clarifying that UUID identity follows the GitHub path and qualifying the prefixed-name case.
Description check		The description relates directly to the comment changes and explains the distinction between GitHub path changes, mirror moves, and phase changes.
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

Recent review info

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 46fb16bd-6f6d-49c2-ab84-eb004b190f37

Commits

Reviewing files that changed from the base of the PR and between cbd8445 and dca4ab8.

Files selected for processing: 1

• .machine_readable/CLADE.a2ml

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Recent review details

Context from checks skipped due to timeout: 7

• GitHub Check: CodeRabbit
• GitHub Check: analyze (actions, none)
• GitHub Check: Groove manifest check
• GitHub Check: Empty-linter (invisible characters)
• GitHub Check: Validate DEED manifests
• GitHub Check: Validate K9 contracts
• GitHub Check: semgrep-cloud-platform/scan

Additional comments: 1

.machine_readable/CLADE.a2ml: 1

29-35: LGTM!