Skill

maintenance-cycle

Automated IDEA maintenance workflow: backup, sync, scope generation, verify, and report. Orchestrates idea-tools skills for comprehensive maintenance.

npx claudepluginhub teslasoft-de/claude-skills-marketplace --plugin idea

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Automated maintenance workflow that orchestrates idea-tools skills.

Supporting Assets

meta.json

SKILL.md

Similar Skills

using-git-worktrees

169.2k

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

subagent-driven-development

169.2k

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

3 files

superpowers

dispatching-parallel-agents

169.2k

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitFeb 10, 2026

Actions

View Source View Plugin View on GitHub View README

Skill: IDEA Maintenance Cycle

Automated maintenance workflow that orchestrates idea-tools skills.

When to Use

Regular IDEA project maintenance
After multiple structural changes
Before/after major development phases
Weekly/monthly maintenance routine

When NOT to Use

For single operations (use idea-tools skills directly)
For new project setup (use /idea onboard)
For quick sync only (use /idea sync-modules)

Workflow Steps

1. Pre-Flight Check

[ ] Verify .idea directory exists
[ ] Check for uncommitted IDEA config changes
[ ] Validate current module structure

2. Safety Backup

Invoke idea-tools:config-backup:

/idea backup

Creates timestamped backup before any modifications.

3. Module Synchronization

Invoke idea-tools:module-sync:

/idea sync-modules

Discover Git submodules
Scan PARA folders
Update modules.xml
Create/update .iml files

4. Scope Generation

Create/update file scopes:

Individual PARA category scopes
Composite scopes (Active Work, Knowledge Base)
Configuration scopes (Claude Config, Obsidian Config)

5. Verification

[ ] Modules load without errors
[ ] Scopes are accessible
[ ] VCS mappings correct
[ ] No orphaned .iml files

6. Status Report

Generate maintenance report:

IDEA Maintenance Report - 2026-01-31

Backup: idea_config_2026-01-31-xyz.zip
Modules: 12 synced (3 new, 0 removed)
Scopes: 15 updated
VCS Mappings: 8 configured

Status: SUCCESS

Command Reference

`/idea maintenance`

Full maintenance cycle with all steps.

Options:

--dry-run - Preview changes without applying
--skip-backup - Skip safety backup (not recommended)
--verbose - Detailed output

Example:

/idea maintenance --verbose

Orchestrated Skills

This skill orchestrates:

Skill	Purpose
`idea-tools:config-backup`	Safety backup creation
`idea-tools:module-sync`	Module synchronization

Error Handling

Error	Recovery
Backup failed	Check disk space, permissions
Sync failed	Restore from backup: `/idea restore`
Scope error	Manual scope recreation in IDEA
Verification failed	Review report, fix issues manually

Best Practices

Run weekly - Keep IDEA config in sync with project changes
Before major changes - Always backup first
Review reports - Check for unexpected changes
Keep backups - Don't delete old backups prematurely

Security & Permissions

Required tools: Read, Write, Bash
Files modified: .idea/*, .backups/idea/*
Confirmations: None (backup protects against issues)

Metadata

author: Christian Kusmanow / Claude
version: 1.0.0
last_updated: 2026-01-31
depends_on:
  - idea-tools:config-backup
  - idea-tools:module-sync