Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From claudecode-research-harness-workflow
Tidies up bloated Plans.md, session-log.md, old logs, and state files. Invoke via /maintenance for file cleanup, archiving, and organization.
npx claudepluginhub maxwell2732/claudecode-research-harness-workflow --plugin claudecode-research-harness-workflowHow this skill is triggered — by the user, by Claude, or both
Slash command
/claudecode-research-harness-workflow:maintenance [plans|session-log|logs|state|all] [--dry-run][plans|session-log|logs|state|all] [--dry-run]This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
A single-purpose skill for tidying up messy files. Invoke when auto-cleanup-hook issues a warning,
Cleans up and archives bloated Plans.md, session-log.md, old logs, and state files. Useful for periodic file organization and reducing clutter.
Batch-archives ideation, discussion, debug, plans, and requests sessions in Claude Code's Maestro mode, keeping recent N and archiving old completed ones. Invocable via /mst:cleanup or keywords like '정리'.
Manages Claude Code user config (~/.claude/) with actions for audit/status, backup/restore, cleanup sessions/agents/debug/logs, costs/storage/session-stats, history/transcript-search, plugin-reset, and more.
Share bugs, ideas, or general feedback.
A single-purpose skill for tidying up messy files. Invoke when auto-cleanup-hook issues a warning, or as routine housekeeping.
Prerequisite: Before destructive operations (archiving, line deletion), confirm that important information in Plans.md / session-log.md has been promoted to SSOT (decisions.md / patterns.md). If not yet synced, run
/memory syncfirst.
| Subcommand | Target | Typical Trigger |
|---|---|---|
maintenance plans | Archive completed tasks in Plans.md | "Organize Plans.md", "Move old tasks" |
maintenance session-log | Monthly split of session-log.md | "Split session-log", "Log is too long" |
maintenance logs | Delete old files in .claude/logs/ | "Clean up logs", "Delete logs older than 30 days" |
maintenance state | Trim agent-trace.jsonl / harness-usage.json | "Trace is bloated", "Compress state" |
maintenance all | Run all 4 in sequence | "Organize everything", "Full cleanup" |
Add --dry-run to only list what would be done without executing. Free-form instructions (e.g.
"delete old archives too", "keep only this session-log") are parsed in Step 1 and applied
to processing parameters in Step 2 and beyond.
.claude/state/.ssot-synced-this-session is absent,
prompt to run /memory sync (required only when touching Plans.md)${CLAUDE_SKILL_DIR}/references/cleanup.md and execute the relevant sectionFor execution steps, thresholds, and archive destinations per target, see cleanup.md.
The PostToolUse hook (scripts/auto-cleanup-hook.sh / Go version auto_cleanup_hook.go) detects
line count overruns in Plans.md, session-log.md, and CLAUDE.md and returns
Recommend archiving old tasks with /maintenance as feedback.
When you see this warning, run the relevant subcommand.
cc:WIP, pm:requested, cursor:requested are excluded from archiving.claude/memory/archive/ — confirm with user before moving elsewherecp <file> <file>.bak.$(date +%s)memory — SSOT promotion before organizing Plans.md (updates decisions.md / patterns.md)harness-setup — Periodic maintenance after setup can also be invoked via harness-setupsession-init — Controls maintenance recommendation notifications at session start