Skip to content
cccskills
FreePublished on GitHub

maintenance

Clean up project planning files, session logs, old logs, and state files by archiving completed work, splitting long logs, or trimming stored data. Preview proposed actions with dry-run and receive a before-and-after summary.

OriginalShow the original description

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.

Chachamaru127/claude-code-harness3,187 stars(GitHub 3,187 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Archiving completed tasks from Plans.md
  • Splitting a long session log by month
  • Cleaning up old log files
  • Previewing cleanup actions with dry-run

Files included (2)

  • SKILL.md4.4 KB
  • references/cleanup.md9.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Maintenance

散らかったファイルを整頓する単一目的スキル。auto-cleanup-hook が警告を出した時、 または定期的な家事として呼び出す。

前提: 破壊的操作(アーカイブ移動・行削除)の前に Plans.md / session-log.md の 重要情報が SSOT (decisions.md / patterns.md) に昇格済みか確認する。 未同期なら /memory sync を先に走らせる。

Quick Reference

サブコマンド対象典型トリガー
maintenance plansPlans.md 完了タスクのアーカイブ移動「Plans.md 整理」「古いタスクを移動」
maintenance session-logsession-log.md の月別分割「session-log 分割」「ログが長い」
maintenance logs.claude/logs/ の古いファイル削除「ログ掃除」「30日以上前のログ消して」
maintenance stateagent-trace.jsonl / harness-usage.json のトリム「trace 肥大」「state 圧縮」
maintenance all上記4つを順に実行「全部整理」「総掃除」

--dry-run を付けると何をするかだけ列挙して実行しない。自由記述の指示(例: 「古いアーカイブも消して」「この session-log だけ残して」)は Step 1 で 受け付けて Step 2 以降の処理パラメータに反映する。

実行手順

  1. ユーザー指示のパース: サブコマンド + 自由記述(除外対象、保存先、日数閾値)を抽出
  2. SSOT 同期チェック: .claude/state/.ssot-synced-this-session が無ければ /memory sync を促す(Plans.md を触る場合のみ必須)
  3. 参照ファイルを開く: ${CLAUDE_SKILL_DIR}/references/cleanup.md を読み対応セクションを実行
  4. Before/After を報告: 行数と削除件数を表示して完了

サブコマンド詳細

対象ごとの実行手順・閾値・アーカイブ先は cleanup.md を参照。

auto-cleanup-hook との連携

PostToolUse hook (scripts/auto-cleanup-hook.sh / Go 版 auto_cleanup_hook.go) は Plans.md・session-log.md・CLAUDE.md の行数超過を検知すると /maintenance で古いタスクをアーカイブすることを推奨します と feedback を返す。 警告を見たら対象と件数を読み取り、整理案を出す。警告そのものをアーカイブ移動や削除の承認として扱わない。 明示された maintenance の対象と除外条件がある場合は、その範囲で既存の SSOT 同期と破壊的操作のゲートに従う。

注意事項

  • 進行中タスクは動かさない: cc:WIP, pm:依頼中, cursor:依頼中 はアーカイブ対象外
  • アーカイブ先ディレクトリは固定: .claude/memory/archive/ — 別の場所に移すときは ユーザーに確認する
  • バックアップ: 200 行超のファイルを編集する前に cp <file> <file>.bak.$(date +%s) で ローカルバックアップを取る
  • CLAUDE.md は警告のみ: 自動編集しない。分割提案だけ出す

関連スキル

  • memory — Plans.md 整理前の SSOT 昇格(decisions.md / patterns.md 更新)
  • harness-setup — セットアップ直後の定期メンテは harness-setup 経由でも呼べる
  • session-init — セッション開始時のメンテ推奨通知を制御

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-browser

FreeSummary

Use the agent-browser CLI to navigate web pages, inspect interactive elements, fill forms, capture screenshots, and collect page information. It helps check web app behavior through browser actions and snapshots.

  • Navigate a page and inspect its current state
  • Fill and submit a web form
  • Capture a screenshot for a UI check
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

breezing

FreeSummary

Run planned work through a team workflow: delegate implementation to workers, coordinate independent review and revisions, then report the outcome. Select a task range or backend, or run all unfinished tasks in one command.

  • Run all unfinished planned tasks
  • Delegate a selected task range
  • Request implementation through the Codex or Cursor backend
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

breezing

FreeSummary

Run planned software tasks as a coordinated team workflow. It assigns ready tasks to isolated workers, performs per-task and integrated reviews, incorporates approved changes, and reports progress and completion. Worker execution can use the selected backend, including optional Cursor delegation.

  • Run all remaining planned tasks as a team
  • Delegate a selected task range to workers
  • Use Cursor for worker implementation
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

cc-update-review

FreeSummary

Review changes that integrate Claude Code or Codex updates. Classify each new Feature Table entry as implemented, inherited upstream, or tracked in Plans, and flag entries that are only documented without supporting work.

  • Review a Claude Code or Codex update integration
  • Check new Feature Table entries against implementation
  • Confirm future work is recorded in Plans
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

ci

FreeSummary

Diagnose failed CI runs by reviewing logs, reproduction details, specifications, and recent commits. Identify whether the cause lies in implementation, tests, or the environment, then make authorized fixes without hiding failures by skipping checks.

  • Find the cause of a failed CI run
  • Trace a build error to a recent commit
  • Fix implementation issues behind failing tests
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

cursor-ask

FreeSummary

Send a question, investigation, or design discussion to cursor-agent in read-only ask mode. It returns a second opinion or evidence-based findings that the host agent summarizes, without making file changes or running implementation work.

  • Ask for a second opinion on a design decision
  • Investigate code or configuration and request supporting evidence
  • Get an adversarial sanity check on a proposed change
Chachamaru127/claude-code-harness3.2KUpdated Oct 26, 2026

See all skills by Chachamaru127

Report a problem with this skill