cc-devflow 4.5.4 → 4.5.5

package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-002.v2`
 - Design version: `design.v2`
-- CC-Plan skill version: `3.7.1`
+- CC-Plan skill version: `3.7.5`
 - Source roadmap item: `RM-010`
 - Source roadmap version: `roadmap.v2`
 
@@ -15,6 +15,13 @@
 - Frozen decisions:
   - bulk invite results must classify each row
   - audit behavior must match visible results
+- PRD brief:
+  - Problem statement: admins need predictable CSV invite outcomes for duplicates, invalid rows, and seat limits
+  - Solution summary: freeze deterministic row outcomes before executing the bulk invite flow
+  - User stories covered: `US-001`, `US-002`, `US-003`, `US-EDGE-001`, `US-EDGE-002`
+  - Implementation decisions: reuse invite engine, billing checks, and audit contract after the row-outcome matrix is approved
+  - Testing decisions: test bulk-import rules, admin upload flow, and audit mapping
+  - Out of scope: SCIM provisioning, background jobs, rollback wizard
 - Read first:
   - `design.md`
   - `src/admin/BulkInvitePanel.tsx`

package/docs/examples/full-design-blocked/roadmap.json

@@ -0,0 +1,123 @@
+{
+  "version": 3,
+  "outputPolicy": {
+    "documentLanguage": "en"
+  },
+  "meta": {
+    "roadmapVersion": "roadmap.v2",
+    "skillVersion": "5.0.0",
+    "status": "active",
+    "lastUpdated": "2026-04-19",
+    "currentFocusStage": "Stage 2"
+  },
+  "context": {
+    "planningPosture": "",
+    "evidenceMaturity": "",
+    "canonicalTerms": [],
+    "durableDecisionSources": []
+  },
+  "evidence": [],
+  "route": {
+    "recommended": "",
+    "whyThisWinsNow": "",
+    "rejectedRoutes": [],
+    "firstSignal": "",
+    "killSignal": ""
+  },
+  "stages": [],
+  "items": [
+    {
+      "rmId": "RM-010",
+      "item": "Add CSV bulk invite import for admins",
+      "stage": "Stage 2",
+      "priority": "P1",
+      "primaryCapability": "cap-bulk-invite-import",
+      "secondaryCapabilities": [
+        "cap-workspace-membership"
+      ],
+      "expectedSpecDelta": "define import semantics before widening current truth",
+      "dependsOn": [],
+      "status": "Verification blocked",
+      "req": "REQ-002",
+      "progress": "80%",
+      "backlog": {
+        "capabilityGap": "admins can invite one user at a time but cannot safely import invite batches",
+        "evidence": "sales onboarding asks for spreadsheet-scale invites",
+        "parallelWith": [],
+        "unknowns": "duplicate-email policy, seat enforcement, audit fan-out",
+        "nextDecision": "reroute to full design before more execution work",
+        "ready": true,
+        "whyNow": "demand is real, but the contract is too wide to keep improvising in code",
+        "successSignal": "the capability has a trusted import contract before implementation resumes",
+        "entryConstraints": "must freeze limits, duplicates, warnings, and audit behavior first",
+        "openRisks": "another partial implementation pass would deepen the semantic drift",
+        "firstPlanningQuestion": "which subflows share one import contract and which need explicit splits?",
+        "requiredContextToLoad": "invite limits, billing rules, duplicate handling, audit logging",
+        "whyReadyNow": "the blocker is design truth, not implementation effort",
+        "parked": false,
+        "parkedReason": "",
+        "triggerToReopen": "",
+        "missingEvidence": ""
+      }
+    }
+  ],
+  "handoff": {
+    "readyForCcPlan": [
+      "RM-010"
+    ],
+    "parked": [],
+    "serialSpine": [
+      "RM-010"
+    ],
+    "parallelWaves": []
+  },
+  "architecture": {
+    "diagramType": "flowchart",
+    "nodes": [
+      {
+        "id": "roadmap_json",
+        "label": "roadmap.json"
+      },
+      {
+        "id": "roadmap_md",
+        "label": "ROADMAP.md"
+      },
+      {
+        "id": "backlog_md",
+        "label": "BACKLOG.md (deprecated)"
+      },
+      {
+        "id": "cc_plan",
+        "label": "cc-plan"
+      }
+    ],
+    "edges": [
+      {
+        "from": "roadmap_json",
+        "to": "roadmap_md",
+        "label": "renders"
+      },
+      {
+        "from": "roadmap_json",
+        "to": "backlog_md",
+        "label": "projects"
+      },
+      {
+        "from": "roadmap_md",
+        "to": "cc_plan",
+        "label": "hands off"
+      }
+    ]
+  },
+  "backlogMeta": {
+    "roadmapVersion": "roadmap.v2",
+    "skillVersion": "4.4.1",
+    "currentFocusStage": "Stage 2"
+  },
+  "dependencyHandoff": {
+    "serialSpine": "RM-010",
+    "parallelReadyNextWave": "-",
+    "notesOnBlockers": "verification is blocked until the import contract covers limits, duplicates, billing, and audit consistency"
+  },
+  "lastSyncedAt": "2026-04-19"
+}

package/docs/examples/local-handoff/BACKLOG.md

@@ -1,12 +1,14 @@
 # BACKLOG
 
+> Deprecated projection. Edit `roadmap.json` instead.
+
 ## Backlog Meta
 
 - Roadmap version: `roadmap.v2`
-- Skill version: `4.4.1`
+- Skill version: `5.0.0`
 - Last synced: `2026-04-19`
 - Current focus stage: `Stage 2`
-- Tracking source: `roadmap-tracking.json`
+- Roadmap state source: `roadmap.json`
 
 ## Queue
 

package/docs/examples/local-handoff/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@4.4.1`, `cc-plan@3.7.1`, `cc-do@1.6.1`, `cc-check@1.10.1`, `cc-act@1.8.1`
+- Bound skills: `cc-roadmap@5.0.0`, `cc-plan@3.7.5`, `cc-do@1.6.2`, `cc-check@1.10.1`, `cc-act@1.8.2`
 
 This example shows verified work that is **ready to move forward**, but `cc-act` still chooses `local-handoff`.
 
@@ -36,9 +36,9 @@ But the current environment is local-only:
 
 ## Artifact Map
 
-- `ROADMAP.md`
-- `roadmap-tracking.json` (shared roadmap/backlog truth)
-- `BACKLOG.md`
+- `roadmap.json` (editable roadmap truth)
+- `ROADMAP.md` (generated view)
+- `BACKLOG.md` (deprecated projection)
 - `changes/REQ-003-audit-log-export/planning/design.md`
 - `changes/REQ-003-audit-log-export/planning/tasks.md`
 - `changes/REQ-003-audit-log-export/planning/task-manifest.json`

package/docs/examples/local-handoff/ROADMAP.md

@@ -3,7 +3,7 @@
 ## Roadmap Meta
 
 - Roadmap version: `roadmap.v3`
-- Skill version: `4.4.1`
+- Skill version: `5.0.0`
 - Status: `active`
 - Last updated: `2026-04-16`
 - Owner / decider: `product-owner`
@@ -36,10 +36,24 @@
 - Kill signal / stop condition: if export requires a shared reporting pipeline redesign
 
 ## Implementation Tracking
-- Tracking source: `roadmap-tracking.json`
+- Roadmap state source: `roadmap.json`
 
 <!-- roadmap-tracking:start -->
 | RM-ID | Item | Stage | Priority | Primary Capability | Secondary Capabilities | Expected Spec Delta | Depends On | Status | REQ | Progress |
 |------|------|------|------|------|------|------|------|------|------|------|
 | RM-020 | Add an audit-log export summary download | Stage 2 | P1 | cap-audit-log-export | - | codify local export summary truth | - | Local handoff | REQ-003 | 100% |
 <!-- roadmap-tracking:end -->
+
+
+## Technical Architecture
+
+```mermaid
+flowchart TD
+  roadmap_json["roadmap.json"]
+  roadmap_md["ROADMAP.md"]
+  backlog_md["BACKLOG.md (deprecated)"]
+  cc_plan["cc-plan"]
+  roadmap_json -->|renders| roadmap_md
+  roadmap_json -->|projects| backlog_md
+  roadmap_md -->|hands off| cc_plan
+```

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-003.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.1`
+- CC-Plan skill version: `3.7.5`
 - Requirement ID: `REQ-003`
 - Design mode: `tiny-design`
 - Why this stays `tiny-design`: the patch adds one export action inside the existing admin audit UI without changing data contracts
@@ -34,6 +34,23 @@
   - keep the action inside the current admin panel
 - Upgrade trigger to `full-design`: if export needs background generation or new reporting contracts
 
+## PRD-Grade Brief
+
+- Problem statement: admins can review audit summary rows in the UI, but taking them into weekly reports requires manual copying.
+- Solution summary: admins can download the currently visible audit summary rows as a CSV from the existing admin panel.
+- Actors / personas:
+  - workspace admin reviewing weekly activity
+- User stories:
+  - US-001: As a workspace admin, I want to download visible audit summary rows as CSV, so that I can include them in weekly reporting without manual copying.
+- Implementation decisions:
+  - Export only the rows already visible in the panel.
+  - Keep CSV as the only output format.
+- Testing decisions:
+  - Test through the admin panel action and visible row data.
+  - Existing audit summary panel tests are the prior art.
+- Out of scope: JSON export, scheduled reporting, and shared reporting backend work.
+- Further notes: richer machine-readable exports should become a separate requirement.
+
 ## Validation
 
 - Primary check: targeted panel test proves the export action is available and uses current summary rows
@@ -56,6 +73,7 @@
 - Scope scan: pass
 - Ambiguity scan: pass
 - Feasibility scan: pass
+- PRD brief scan: pass; the export story and scope boundaries are explicit
 - Final recommendation: approved as `tiny-design`
 
 ## Approval

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json

@@ -5,6 +5,32 @@
   "updatedAt": "2026-04-16T14:20:00.000Z",
   "requirementId": "REQ-003",
   "requirementVersion": "REQ-003.v1",
+  "planningMeta": {
+    "reqPlanSkillVersion": "3.7.5",
+    "designVersion": "design.v1",
+    "approvedAt": "2026-04-16T13:10:00.000Z",
+    "approvedBy": "user",
+    "basedOnOption": "Tiny design card",
+    "requirementBrief": {
+      "problemStatement": "Admins can review audit summary rows in the UI, but weekly reporting requires manual copying.",
+      "solutionSummary": "Add a CSV download action for the currently visible audit summary rows.",
+      "actors": ["workspace admin reviewing weekly activity"],
+      "userStories": [
+        {
+          "id": "US-001",
+          "actor": "workspace admin",
+          "want": "download visible audit summary rows as CSV",
+          "benefit": "include them in weekly reporting without manual copying",
+          "acceptance": ["Panel behavior test proves the export action uses current summary rows"]
+        }
+      ],
+      "edgeOrRecoveryStories": [],
+      "implementationDecisions": ["Export only rows already visible in the panel", "Keep CSV as the only output format"],
+      "testingDecisions": ["Test through the admin panel action and visible row data"],
+      "outOfScope": ["JSON export", "scheduled reporting", "shared reporting backend"],
+      "furtherNotes": ["Richer machine-readable exports should become a separate requirement"]
+    }
+  },
   "currentTaskId": null,
   "activePhase": null,
   "tasks": [

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-003.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.1`
+- CC-Plan skill version: `3.7.5`
 - Source roadmap item: `RM-020`
 - Source roadmap version: `roadmap.v3`
 
@@ -15,6 +15,13 @@
 - Frozen decisions:
   - export only the visible audit summary rows
   - CSV is the only format in this requirement
+- PRD brief:
+  - Problem statement: admins manually copy audit summaries into weekly reports
+  - Solution summary: CSV download action for currently visible audit summary rows
+  - User stories covered: `US-001`
+  - Implementation decisions: export visible rows only, CSV only
+  - Testing decisions: test through admin panel action and visible row data
+  - Out of scope: JSON export, scheduled reporting, shared reporting backend
 - Read first:
   - `design.md`
   - `src/admin/AuditSummaryPanel.tsx`

package/docs/examples/local-handoff/roadmap.json

@@ -0,0 +1,121 @@
+{
+  "version": 3,
+  "outputPolicy": {
+    "documentLanguage": "en"
+  },
+  "meta": {
+    "roadmapVersion": "roadmap.v2",
+    "skillVersion": "5.0.0",
+    "status": "active",
+    "lastUpdated": "2026-04-19",
+    "currentFocusStage": "Stage 2"
+  },
+  "context": {
+    "planningPosture": "",
+    "evidenceMaturity": "",
+    "canonicalTerms": [],
+    "durableDecisionSources": []
+  },
+  "evidence": [],
+  "route": {
+    "recommended": "",
+    "whyThisWinsNow": "",
+    "rejectedRoutes": [],
+    "firstSignal": "",
+    "killSignal": ""
+  },
+  "stages": [],
+  "items": [
+    {
+      "rmId": "RM-020",
+      "item": "Add an audit-log export summary download",
+      "stage": "Stage 2",
+      "priority": "P1",
+      "primaryCapability": "cap-audit-log-export",
+      "secondaryCapabilities": [],
+      "expectedSpecDelta": "codify local export summary truth",
+      "dependsOn": [],
+      "status": "Local handoff",
+      "req": "REQ-003",
+      "progress": "100%",
+      "backlog": {
+        "capabilityGap": "admins can export raw audit data but not a compact summary for review",
+        "evidence": "support escalations keep asking for a lightweight summary bundle",
+        "parallelWith": [],
+        "unknowns": "csv-only or csv-plus-markdown summary",
+        "nextDecision": "resume from local handoff once remote access returns",
+        "ready": true,
+        "whyNow": "the implementation and proof already exist, only the landing path is deferred",
+        "successSignal": "admins can download a concise audit summary without manual spreadsheet cleanup",
+        "entryConstraints": "stay local-only and avoid remote automation",
+        "openRisks": "handoff may age if schema changes before the next maintainer resumes",
+        "firstPlanningQuestion": "does the summary format need another review before remote landing?",
+        "requiredContextToLoad": "admin export screen, generated summary fixture, local handoff notes",
+        "whyReadyNow": "the requirement is already proven and only needs a clean resume point",
+        "parked": false,
+        "parkedReason": "",
+        "triggerToReopen": "",
+        "missingEvidence": ""
+      }
+    }
+  ],
+  "handoff": {
+    "readyForCcPlan": [
+      "RM-020"
+    ],
+    "parked": [],
+    "serialSpine": [
+      "RM-020"
+    ],
+    "parallelWaves": []
+  },
+  "architecture": {
+    "diagramType": "flowchart",
+    "nodes": [
+      {
+        "id": "roadmap_json",
+        "label": "roadmap.json"
+      },
+      {
+        "id": "roadmap_md",
+        "label": "ROADMAP.md"
+      },
+      {
+        "id": "backlog_md",
+        "label": "BACKLOG.md (deprecated)"
+      },
+      {
+        "id": "cc_plan",
+        "label": "cc-plan"
+      }
+    ],
+    "edges": [
+      {
+        "from": "roadmap_json",
+        "to": "roadmap_md",
+        "label": "renders"
+      },
+      {
+        "from": "roadmap_json",
+        "to": "backlog_md",
+        "label": "projects"
+      },
+      {
+        "from": "roadmap_md",
+        "to": "cc_plan",
+        "label": "hands off"
+      }
+    ]
+  },
+  "backlogMeta": {
+    "roadmapVersion": "roadmap.v2",
+    "skillVersion": "4.4.1",
+    "currentFocusStage": "Stage 2"
+  },
+  "dependencyHandoff": {
+    "serialSpine": "RM-020",
+    "parallelReadyNextWave": "-",
+    "notesOnBlockers": "export work stays local-only until the next maintainer has remote access"
+  },
+  "lastSyncedAt": "2026-04-19"
+}

package/docs/examples/pdca-loop/BACKLOG.md

@@ -1,12 +1,14 @@
 # BACKLOG
 
+> Deprecated projection. Edit `roadmap.json` instead.
+
 ## Backlog Meta
 
 - Roadmap version: `roadmap.v1`
-- Skill version: `4.4.1`
+- Skill version: `5.0.0`
 - Last synced: `2026-04-19`
 - Current focus stage: `Stage 1`
-- Tracking source: `roadmap-tracking.json`
+- Roadmap state source: `roadmap.json`
 
 ## Queue
 

package/docs/examples/pdca-loop/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@4.4.1`, `cc-plan@3.7.1`, `cc-do@1.6.1`, `cc-check@1.10.1`, `cc-act@1.8.1`
+- Bound skills: `cc-roadmap@5.0.0`, `cc-plan@3.7.5`, `cc-do@1.6.2`, `cc-check@1.10.1`, `cc-act@1.8.2`
 
 This folder shows one minimal but complete `cc-roadmap -> cc-plan -> cc-do -> cc-check -> cc-act` loop.
 
@@ -27,9 +27,9 @@ The sample requirement is:
 
 ## Artifact Map
 
-- `ROADMAP.md`: what `cc-roadmap` decided and why this item is first
-- `roadmap-tracking.json`: machine-readable roadmap/backlog truth that renders `ROADMAP.md` and `BACKLOG.md`
-- `BACKLOG.md`: capability-aware handoff that makes `RM-001` ready for `cc-plan`
+- `roadmap.json`: editable roadmap truth that renders the generated views
+- `ROADMAP.md`: generated view of what `cc-roadmap` decided and why this item is first
+- `BACKLOG.md`: deprecated capability-aware projection that makes `RM-001` ready for `cc-plan`
 - `changes/REQ-001-copy-invite-link/planning/design.md`: approved tiny design
 - `changes/REQ-001-copy-invite-link/planning/tasks.md`: executable task handoff
 - `changes/REQ-001-copy-invite-link/planning/task-manifest.json`: machine-readable execution truth

package/docs/examples/pdca-loop/ROADMAP.md

@@ -3,7 +3,7 @@
 ## Roadmap Meta
 
 - Roadmap version: `roadmap.v1`
-- Skill version: `4.4.1`
+- Skill version: `5.0.0`
 - Status: `active`
 - Last updated: `2026-04-15`
 - Owner / decider: `product-owner`
@@ -122,7 +122,7 @@
 - What changed in this version: narrowed Stage 1 to the smallest visible sharing fix
 
 ## Implementation Tracking
-- Tracking source: `roadmap-tracking.json`
+- Roadmap state source: `roadmap.json`
 
 <!-- roadmap-tracking:start -->
 | RM-ID | Item | Stage | Priority | Primary Capability | Secondary Capabilities | Expected Spec Delta | Depends On | Status | REQ | Progress |
@@ -131,3 +131,17 @@
 | RM-002 | Add copied-state feedback to the share dialog | Stage 1 | P2 | cap-invite-links | - | extend invite-link feedback truth | RM-001 | Planned | - | 0% |
 | RM-004 | Collaboration analytics follow-up | - | - | - | - | - | - | - | - | - |
 <!-- roadmap-tracking:end -->
+
+
+## Technical Architecture
+
+```mermaid
+flowchart TD
+  roadmap_json["roadmap.json"]
+  roadmap_md["ROADMAP.md"]
+  backlog_md["BACKLOG.md (deprecated)"]
+  cc_plan["cc-plan"]
+  roadmap_json -->|renders| roadmap_md
+  roadmap_json -->|projects| backlog_md
+  roadmap_md -->|hands off| cc_plan
+```

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-001.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.1`
+- CC-Plan skill version: `3.7.5`
 - Requirement ID: `REQ-001`
 - Design mode: `tiny-design`
 - Why this stays `tiny-design`: the patch is limited to an existing dialog and test file, with no API or data model changes
@@ -34,6 +34,23 @@
   - show a lightweight copied-state confirmation inside the current dialog
 - Upgrade trigger to `full-design`: if clipboard support requires new platform fallbacks, or if the patch spills into shared share-service contracts
 
+## PRD-Grade Brief
+
+- Problem statement: users can see the invite URL, but copying it still requires manual selection and creates avoidable share-flow friction.
+- Solution summary: users get a one-click copy action in the existing share dialog and see lightweight confirmation after the link is copied.
+- Actors / personas:
+  - workspace member sharing an invite
+- User stories:
+  - US-001: As a workspace member, I want to copy the invite link with one click, so that I can share it without manually selecting text.
+- Implementation decisions:
+  - Reuse the existing invite URL source and dialog props.
+  - Keep clipboard behavior inside the current share dialog surface.
+- Testing decisions:
+  - Test through the dialog behavior, not an internal helper.
+  - Existing share-dialog tests are the prior art.
+- Out of scope: new invite generation, role controls, analytics, or clipboard fallback redesign.
+- Further notes: if confirmation remains unclear, open a separate UX requirement.
+
 ## Validation
 
 - Primary check: targeted dialog test proves the button renders and copies the current invite URL
@@ -57,6 +74,7 @@
 - Scope scan: pass; no backend, no permission work
 - Ambiguity scan: pass; execution does not need to re-decide button placement or clipboard source
 - Feasibility scan: pass; existing dialog and tests already cover the target surface
+- PRD brief scan: pass; problem, story, implementation decision, testing decision, and out-of-scope are durable
 - Final recommendation: approved as `tiny-design`
 
 ## Approval

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json

@@ -9,7 +9,7 @@
   "sourceRoadmap": {
     "itemId": "RM-001",
     "roadmapVersion": "roadmap.v1",
-    "roadmapSkillVersion": "4.4.1",
+    "roadmapSkillVersion": "5.0.0",
     "sourceStage": "Stage 1",
     "successSignal": "Users can copy the invite link with one click",
     "killSignal": "The patch requires backend or permission changes",
@@ -22,11 +22,30 @@
     ]
   },
   "planningMeta": {
-    "reqPlanSkillVersion": "3.7.1",
+    "reqPlanSkillVersion": "3.7.5",
     "designVersion": "design.v1",
     "approvedAt": "2026-04-15T10:05:00.000Z",
     "approvedBy": "user",
-    "basedOnOption": "Tiny design card"
+    "basedOnOption": "Tiny design card",
+    "requirementBrief": {
+      "problemStatement": "Users can see the invite URL, but copying it still requires manual selection.",
+      "solutionSummary": "Add a one-click copy action with lightweight confirmation inside the existing share dialog.",
+      "actors": ["workspace member sharing an invite"],
+      "userStories": [
+        {
+          "id": "US-001",
+          "actor": "workspace member",
+          "want": "copy the invite link with one click",
+          "benefit": "share it without manually selecting text",
+          "acceptance": ["Dialog behavior test proves the current invite URL is copied"]
+        }
+      ],
+      "edgeOrRecoveryStories": [],
+      "implementationDecisions": ["Reuse the existing invite URL source and dialog props"],
+      "testingDecisions": ["Test through the share dialog behavior, not an internal helper"],
+      "outOfScope": ["invite generation", "role controls", "analytics", "clipboard fallback redesign"],
+      "furtherNotes": ["Richer copied-state feedback is a separate UX requirement"]
+    }
   },
   "currentTaskId": null,
   "activePhase": null,

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-001.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.1`
+- CC-Plan skill version: `3.7.5`
 - Source roadmap item: `RM-001`
 - Source roadmap version: `roadmap.v1`
 
@@ -16,6 +16,13 @@
   - copy from the existing invite URL source
   - keep the patch inside the current dialog
   - leave richer feedback for a future requirement if needed
+- PRD brief:
+  - Problem statement: copying the visible invite URL still requires manual selection
+  - Solution summary: one-click copy action with lightweight confirmation
+  - User stories covered: `US-001`
+  - Implementation decisions: reuse existing invite URL source and dialog props
+  - Testing decisions: test through share dialog behavior
+  - Out of scope: invite generation, role controls, analytics, clipboard fallback redesign
 - Read first:
   - `design.md`
   - `src/features/share/ShareDialog.tsx`