workspace-organize

Workspace Organize

Inputs

$ARGUMENTS:

• --dry-run (default) — propose only, don't move.
• --apply — execute the proposed moves/dedupes after user confirms each batch.
• --stale-days=N — inbox staleness threshold (default 14).

Procedure

1. Resolve config

${CAREER_DATA_DIR}/config.json → WORKING_FOLDER, CONTEXT_STORE. Bail early if CONTEXT_STORE != markdown with: "vector-mode workspace — run /career:vector-conflict-check instead."

2. Inventory

find $WORKING_FOLDER -maxdepth 4 -type f excluding .git/, cache/, node_modules/. For each file capture: relative path, size, sha256 (cap to files <1 MB; larger files use size+name only), mtime.

3. Detect issues

Walk the inventory once and bucket findings:

• Loose root files — anything at WORKING_FOLDER/ that isn't ground-truth.md, CLAUDE.md, README.md, .gitignore. Propose a target folder by content sniff (see table below).
• Mis-rooted files — file lives in folder X but content matches Y's shape (e.g. a research brief sitting in domain-notes/). Detect via filename pattern + first 200 chars.
• Duplicates — same sha256 in two paths. Keep the one in the canonical folder; propose deleting the other.
• Near-duplicates — same basename across different folders OR levenshtein <3 on basename. Show side-by-side; let user decide.
• Stale inbox — inbox/*.md with status: pending-route AND mtime older than --stale-days. Propose archiving to inbox/_stale/.
• Empty folders — propose removal.

4. Routing table (content sniff → target)

Signal	Target
frontmatter classification: or filename YYYY-MM-DD-HHMM.md	inbox/
heading # Outreach log or rows like | company | date |	crm/
heading # Company Overview / # Glassdoor Signal / # Cultural Fit etc.	research/companies/<slug>/
heading # Communities / # Conferences / # Hackathons etc.	domain-notes/<slug>/
filename cv*, resume*	resume/
filename cold-pitch*, *-followup*	templates/
pdf, png, jpg with no clear mate	branding/ if filename suggests a profile asset, else flag as unrouted

If no signal matches, mark unrouted and surface for user decision.

5. Propose

Print a per-bucket summary (counts) and a per-file table for moves/dedupes:

LOOSE ROOT (3)
  notes-from-call.md            → inbox/2026-04-29-notes-from-call.md
  acme-research.md              → research/companies/acme/company-overview.md
  cv-final-final.pdf            → resume/cv-final-final.pdf

DUPLICATES (2)
  resume/cv.pdf  ==  branding/cv.pdf      keep resume/cv.pdf, delete branding copy

STALE INBOX (4 older than 14d)
  inbox/2026-03-12-1100.md      → inbox/_stale/

UNROUTED (1)
  weird-file.txt                — needs your call

If --dry-run, stop here.

6. Apply (only if --apply)

Confirm per-bucket (AskUserQuestion: apply moves / apply dedupes / archive stale / each separately). Execute confirmed batches. Always mkdir -p the target. Never overwrite — if target exists, append -1, -2, etc. and surface for review.

After apply: print a one-line audit row to ${WORKING_FOLDER}/cache/organize-log.md.

Idempotency

Re-running on a clean workspace finds nothing and exits with "workspace tidy."

Failure modes

• Workspace path missing → bail with /career:onboard instruction.
• Filesystem error mid-apply → stop, print what completed, leave the rest as proposals.