Archive fix-repo-tag-worktree change (tags spec merge)

[winjer]

User description

Bookkeeping follow-up: PR #24 was squash-merged before the planflow archive stage ran, so the spec merge and archive move did not ride that PR.

This PR completes the archive stage post-merge:

• Creates the living spec planflow/specs/tags/spec.md from the change's delta (4 ADDED requirements + the org-tag-derivation requirement; the delta's REMOVED entry was a no-op as no prior living spec existed).
• Moves planflow/changes/fix-repo-tag-worktree/ intact to planflow/archive/2026-09-25-fix-repo-tag-worktree/ (all four artefacts, verified as 100% renames by git).

No code changes. You can squash-merge this directly after CI.

---

PR Type

Documentation, Other

---

Description

• Archives the fix-repo-tag-worktree change to planflow/archive/2026-09-25-fix-repo-tag-worktree/

• Creates living spec planflow/specs/tags/spec.md from the change's spec delta

• Includes design, implementation, work plan, and spec documents for repo tag fix

---

Diagram Walkthrough

flowchart LR
  A["fix-repo-tag-worktree change"] --> B["planflow/archive/2026-09-25-fix-repo-tag-worktree/"]
  A --> C["planflow/specs/tags/spec.md"]
  B --> D["design.md"]
  B --> E["implementation.md"]
  B --> F["work.md"]
  B --> G["specs/tags/spec.md"]

Loading

File Walkthrough

Relevant files

Documentation

design.md Design document for repo tag fix                                                  planflow/archive/2026-09-25-fix-repo-tag-worktree/design.md Design document for deriving repo: tag from origin remote URL instead of show-toplevel basename Covers architecture, fallback ordering, implementation phases, and acceptance criteria Documents repo_from_remote_url function mirroring existing org_from_remote_url [link]    implementation.md Implementation plan for repo tag fix                                          planflow/archive/2026-09-25-fix-repo-tag-worktree/implementation.md Implementation plan with 5 tasks (T1–T5) and dependency graph Includes code snippets for repo_from_remote_url and restructured gather_env_tags Contains acceptance-criteria traceability table and verification commands [link]    spec.md Spec delta for repo tag requirements                                          planflow/archive/2026-09-25-fix-repo-tag-worktree/specs/tags/spec.md Spec delta adding requirements for repo tag derivation from remote URL Includes scenarios for SSH, HTTPS, ssh://, GitLab subgroups, and local path fallback Documents modified org tag requirement and removed old show-toplevel-based repo tag requirement [link]    work.md Work plan and task allocation                                                        planflow/archive/2026-09-25-fix-repo-tag-worktree/work.md Work plan with task table, dependency graph, and allocation All five tasks agent-owned with human checkpoint after T5 Documents parallel streams and task sizes [link]    spec.md Living tags spec from change delta                                              planflow/specs/tags/spec.md New living spec created from the change's spec delta Defines requirements for repo: tag derivation from origin remote URL with show-toplevel fallback Includes scenarios for all URL forms and fallback behavior +95/-0

---

[isotoma-pr-agent]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis 🔶 24 - Partially compliant Compliant requirements: Archive the change directory to planflow/archive/ Create living spec planflow/specs/tags/spec.md from the change's spec delta Non-compliant requirements: Derive repo: tag from origin remote URL instead of show-toplevel basename (code change was in prior PR Fix repo tagging for git worktrees and non-standard clone directories #24, not this PR) Add repo_from_remote_url function mirroring org_from_remote_url (code change was in prior PR Fix repo tagging for git worktrees and non-standard clone directories #24) Fall back to show-toplevel basename when no remote or unparseable URL (code change was in prior PR Fix repo tagging for git worktrees and non-standard clone directories #24) Add unit and integration tests (code change was in prior PR Fix repo tagging for git worktrees and non-standard clone directories #24) Requires further human verification: Verify that the archived files are exact renames of the original change directory (git rename detection) Verify the living spec content matches the change's spec delta with no omissions or alterations

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ No major issues detected

[isotoma-pr-agent]

PR Code Suggestions ✨

No code suggestions found for the PR.