maxwell2732/claudecode-research-harness-workflow/maintenance

Claude Code and agent skill by maxwell2732/claudecode-research-harness-workflow

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

File cleanup and archiving. Tidies up bloated Plans.md, session-log.md, old logs, and state files. Trigger: /maintenance, cleanup, archive, organize, split session-log. Do NOT load for: implementation, review, release, new feature development.

Install

npx vskill@latest install maxwell2732/claudecode-research-harness-workflow/maintenance

SKILL.md

Maintenance

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 sync first.

Quick Reference

SubcommandTargetTypical Trigger
maintenance plansArchive completed tasks in Plans.md"Organize Plans.md", "Move old tasks"
maintenance session-logMonthly split of session-log.md"Split session-log", "Log is too long"
maintenance logsDelete old files in .claude/logs/"Clean up logs", "Delete logs older than 30 days"
maintenance stateTrim agent-trace.jsonl / harness-usage.json"Trace is bloated", "Compress state"
maintenance allRun 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.

Execution Steps

  1. Parse user instructions: Extract subcommand + free-form details (exclusions, destination, day threshold)
  2. SSOT sync check: If .claude/state/.ssot-synced-this-session is absent,

prompt to run /memory sync (required only when touching Plans.md)

  1. Open reference file: Read ${CLAUDE_SKILL_DIR}/references/cleanup.md and execute the relevant section
  2. Report Before/After: Display line counts and deletion counts when done

Subcommand Details

For execution steps, thresholds, and archive destinations per target, see cleanup.md.

Integration with auto-cleanup-hook

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.

Notes

  • Do not move in-progress tasks: cc:WIP, pm:requested, cursor:requested are excluded from archiving
  • Archive destination directory is fixed: .claude/memory/archive/ — confirm with user before moving elsewhere
  • Backup: Before editing files over 200 lines, take a local backup with cp <file> <file>.bak.$(date +%s)
  • CLAUDE.md is warning-only: Do not auto-edit. Only propose a split

Related Skills

  • memory — SSOT promotion before organizing Plans.md (updates decisions.md / patterns.md)
  • harness-setup — Periodic maintenance after setup can also be invoked via harness-setup
  • session-init — Controls maintenance recommendation notifications at session start

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/maxwell2732/claudecode-research-harness-workflow/maintenance/badge)](https://verified-skill.com/skills/maxwell2732/claudecode-research-harness-workflow/maintenance)

Something wrong with this skill or its page? Tell us.