Skills / Skills / Offboard Brand
All skills

/ skill

offboard-brand

Skills/offboard-brand.md

Sunset a brand — mark sunset, archive folder, update Brands.md. Never deletes data.

Open as raw file

Run this skill

Runs with bypassPermissions — local dev only.

offboard-brand

Retire a brand. Always non-destructive — sunset, never delete. The brand's history stays in the vault for future reference.

Pre-flight checks

  1. Brands/{brand_slug}/ exists. Reject if not.
  2. Brand's current status is not already sunset. If yes, surface — likely a no-op or intent-mismatch.
  3. No active project in Departments/Projects/ references brand: {brand_slug} in its frontmatter. If yes, list them and ask Adam to resolve first.

Procedure

1. Mark the brand

Update Brands/{brand_slug}/BrandContext.md frontmatter:

  • status: sunset
  • sunset_date: {today}
  • sunset_reason: {reason}

2. Archive (default)

If archive: true:

  • mkdir -p Brands/_archive/
  • mv Brands/{brand_slug}/ Brands/_archive/{brand_slug}/
  • Update internal links across the vault: any Brands/{brand_slug}/... reference → Brands/_archive/{brand_slug}/.... Use grep + targeted edits — don't blanket-replace without verifying.

If archive: false: leave folder in place but with status: sunset. (Useful for soft-sunsetting a brand we expect to revive.)

3. Update the roster

Edit Context/Brands.md:

  • If archived: remove the row from the active table; add an entry under a "## Sunset / archived" section at the bottom (creating the section if needed).
  • If not archived: change the row's status cell from active to sunset.

4. Update the wiki node

Edit Wiki/Companies/{brand_slug}.md:

  • status: stale
  • last_synthesized: {today}
  • Append a brief paragraph: Sunset {today}: {reason}.
  • Update wikilink path if the brand was archived (<a class="wikilink wikilink-broken" href="#">Brands/_archive/{brand_slug}/...</a>).

5. Append Log entry

Via log-operation:

  • agent: ea-orchestrator
  • skill: offboard-brand
  • input: {brand_slug}, reason={reason}, archive={archive}
  • output: archived path or current path
  • artifacts: <a class="wikilink wikilink-broken" href="#">Wiki/Companies/{brand_slug}</a>
  • notes: must include the reason

Failure modes

  • Active project references the brand: stop, list referencing projects, ask Adam.
  • Wikilinks broken after archive move: flag in next lint-wiki run; this skill should pre-flight check and update its known link patterns, but linting catches drift.
  • _archive/ folder missing: create it. (One-line fix; don't surface as error.)

Hard rules

  • Never delete files. Sunset = move + mark, not destroy.
  • Always log the reason. A sunset without reason is meaningless future-context loss.
  • If unsure whether to archive vs soft-sunset, default to soft-sunset (status change only). Adam can run offboard-brand again with archive: true later.