maintenance

Archive completed tasks and split oversized session logs.

39|46|Updated May 29, 2026
One-click install
npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill maintenance-maxwell2732
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintenance
Source: https://github.com/maxwell2732/claudecode-research-harness-workflow/tree/main/skills/maintenance
Command: npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill maintenance-maxwell2732

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

File clutter in Plans.md, session-log.md, logs, and state files can hinder reproducibility and audits. This skill automates cleanup and archival tasks to keep workspaces lean and SSOT-aligned.

Core Features & Use Cases

  • Archive completed tasks from Plans.md by moving old entries to an archive section.
  • Split oversized session-log.md into monthly archives to maintain readability.
  • Delete stale log files and trim state files to manage storage and performance.
  • Ensure safeguards to avoid removing in-progress items and to require SSOT sync before destructive actions.

Quick Start

Run /maintenance to perform a safe, selective cleanup of Plans.md, session-log.md, old logs, and state files.

Frequently Asked Questions about maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up cluttered Plans.md and session-log.md files in my repository?

Automated cleanup of Plans.md and session-log.md moves completed tasks to an archive section and splits oversized logs into monthly archives. This keeps workspaces lean, readable, and SSOT-aligned while preserving project history.

What is the best way to archive old log files and trim state files without losing data?

Archiving old logs and trimming state files safely requires a selective cleanup process with dry-run options and SSOT synchronization checks. These safeguards prevent removing in-progress items and verify state alignment before executing destructive actions.

Can I delete stale log files and manage storage without affecting active research workflows?

Yes, you can delete stale log files while protecting active research workflows by enforcing safeguards that check for in-progress items. Per-target subcommands and SSOT sync requirements ensure only obsolete files are removed during maintenance.

How does SSOT synchronization work before performing destructive file cleanup?

SSOT synchronization checks verify that your single source of truth is fully aligned before any destructive cleanup occurs. This mechanism prevents data loss by blocking the removal of state files or logs that have not been properly synced.

When should I not use automated file cleanup and archiving in my project?

You should not use automated file cleanup when your project has unsynchronized state files or active in-progress items in Plans.md. Bypassing SSOT checks or dry-run options risks permanent data loss during the maintenance process.