// Runs the harness garbage collection to clean up stale worktrees and branches. Use when user asks to "run gc", "clean up worktrees", "harness cleanup", or "gc".
| name | harness-gc |
| description | Runs the harness garbage collection to clean up stale worktrees and branches. Use when user asks to "run gc", "clean up worktrees", "harness cleanup", or "gc". |
main or master branch.Run the GC script in dry-run mode to list what would be cleaned without making any changes:
./scripts/harness/gc.sh --dry-run
If the script does not support --dry-run, manually inspect and list:
done or failed status beyond config.workspace.retentionDaysShow the user the full list before proceeding.
Present the dry-run output to the user and ask:
The following worktrees and branches will be removed. Confirm to proceed? (yes / no)
Do not proceed if the user does not confirm. If the user says no, stop and report that no changes were made.
After confirmation, run the GC script:
./scripts/harness/gc.sh
GC targets per docs/harness/ENTROPY.md:
| Target | Criteria | Action |
|---|---|---|
| Completed worktrees | PR merged, worktree still present | git worktree remove |
| Stale branches | Last commit > 30 days ago | git branch -d (local and remote) |
| Unreferenced utilities | No import references + > 30 days old | Flag only — do not delete, ask user |
After the script completes, report:
Harness GC Complete
===================
Worktrees removed: N
- symphony/ACR-42
- symphony/ACR-55
Branches deleted: N
- symphony/ACR-42 (local + remote)
- symphony/ACR-55 (local)
Flagged for review (not deleted):
- src/utils/legacyParser.ts — no import references since 2024-02-01
Nothing else was changed.
If the script produced errors, report them with the full error message and suggested remediation.
scripts/harness/gc.sh — GC scriptdocs/harness/ENTROPY.md — GC targets, soft-delete policy, run scheduledocs/harness/LEGIBILITY.md — worktree lifecycledocs/specs/workspace-manager.md — retention policy (config.workspace.retentionDays).github/workflows/harness-gc.yml — automated weekly GC workflowBackend specialist for APIs, databases, authentication with clean architecture (Repository/Service/Router pattern). Use for API, endpoint, REST, database, server, migration, and auth work.
Generate Conventional Commits spec git commits (auto-separate by feature)
Task-based multi-agent coordination (includes Issue Remediation Loop)
oh-my-agent project setup verification and configuration
Audits the current implementation for Symphony SPEC compliance and architecture rule adherence. Use when user asks to "check conformance", "audit symphony", or "verify spec compliance".
Implements one of the 7 Symphony components (Workflow Loader, Config Layer, Tracker Client, Orchestrator, Workspace Manager, Agent Runner, Observability). Use when user asks to "implement [component name]", "build orchestrator", or "add tracker client".