deckhearth/.convoys/rename-collections-vocabulary.md
Randall Stillwell f666a885b9 chore(convoys): mark shipped convoys and refresh ship-readiness
Close stale convoy frontmatter for merged scanner, lint, and hygiene work;
record P1 #11.5 and queued follow-ups as RESOLVED with PR references.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-02 08:48:42 -05:00

2.7 KiB

name classification success_metric skip status created closed pr
rename-collections-vocabulary feature UI copy reads "My Collection" (ownership) and "Lists" / "Binders" (curated lists); no rendered string "Owned Cards" / "Mark Owned" / "All My Cards" remains in pages/ or components/; schema unchanged; AGENTS.md extended with vocabulary table.
arch
shipped 2026-05-27 2026-05-29 54

Convoy: rename-collections-vocabulary

Align user-facing copy with the product taxonomy: owned cards vs curated lists.

As-shipped: PR #54 (squash fd78114, 2026-05-29) + vocabulary follow-up PR #55 (c197dc6, 2026-05-29).

Why

The scanner audit and IA review found inconsistent vocabulary: "Owned Cards", "Mark Owned", and "All My Cards" imply a different mental model than the schema (global cards catalog vs per-user ownership via user_cards vs curated collections). Users confuse "my collection" (everything I own) with "lists/binders" (curated subsets). This convoy is copy + docs only — no schema migration.

Scope

In scope

  • Brief 1 — UI copy sweep (~20 files in pages/ + components/):
    • Replace stale strings per vocabulary table (IA architect supplies full inventory).
    • Target removals: "Owned Cards", "Mark Owned", "All My Cards".
    • Canonical replacements: "My Collection" (ownership), "Lists" / "Binders" (curated lists).
  • Brief 2 — docs + rules
    • AGENTS.md § Branding — vocabulary table.
    • .cursor/rules/ui-and-theming.mdc — copy conventions.
    • docs/SCHEMA_MAP.md — clarify naming vs UI labels (no DDL change).
  • .github/workflows/ci.yml — new forbidden-stale-strings grep gate (~30s): fail if "Mark Owned", "Owned Cards", or "All My Cards" appear in pages/ or components/.

Out of scope

  • Schema renames — table/column names stay; UI copy only.
  • URL slug changes/collections path unchanged in v1.
  • Architecture decisionsskip: arch; IA + UX run explicitly.
  • Admin UI — separate pass if needed.

Todos

  • IA: publish vocabulary table + grep inventory of stale strings
  • UX: review scanner + nav + collection views for consistency
  • Brief 1 — pages/ + components/ copy sweep
  • Brief 2 — AGENTS.md + rules + SCHEMA_MAP glossary
  • Add forbidden-stale-strings CI job

Out of scope follow-ups

  • schema-cleanup-from-scanner-auditis_system_collection vs user_cards unification (separate convoy).
  • rename-repo-and-vercel-project — infra naming, not UI copy.
  • Existing DB seed descriptions — users registered pre-#54 retain the old system-list description until a one-off data migration or manual edit.