archive-increments

What This Skill Does

The archive-increments skill is an intelligent file management agent designed specifically for the .specweave ecosystem. It automates the maintenance of your project workspace by monitoring, organizing, and archiving increment files based on status, age, and activity. By adhering to the '10-10-10 Rule'—keeping the 10 most recent increments accessible, archiving inactive files after 10 days, and executing operations in under 10 seconds—it ensures that developers can maintain a high-velocity workflow without the clutter of obsolete project files.

Installation

To install this skill, run the following command in your terminal or via the OpenClaw agent console: clawhub install openclaw/skills/skills/anton-abyzov/sw-archive-increments Once installed, the skill integrates directly with your workspace, providing hooks to manage your local increment directories.

Use Cases

• Workspace Maintenance: Ideal for projects with high-frequency iteration where hundreds of increment files accumulate over time.
• Pre-Release Cleanup: Quickly clean up feature branches or experimental increments before cutting a new release tag.
• Archive Auditing: Automatically identify abandoned experiments or stale tasks that are consuming storage and slowing down indexing.
• Historical Retrieval: Easily locate and restore past development states from the structured _archive directory if a regression occurs.

Example Prompts

1. "OpenClaw, clean up my workspace. Use the default 10-10-10 rule to move stale increments into the archive."
2. "I'm preparing for the v0.8 release. Can you archive all increments related to v0.7 that haven't been touched in over 30 days?"
3. "Restore increment 0015 from the archive, I need to check the logic used in that specific session."

Tips & Limitations

• Safety First: The skill is designed to never touch active or paused increments. Always verify the status of your work before running aggressive cleanup commands.
• Configuration: Use the JSON configuration settings to shift from manual, cautious archiving to automated, aggressive workspace hygiene.
• Collaboration: If you are working in a team environment, ensure your archive settings are synced in your repository configuration to prevent conflicting file movements across different local environments. Remember that while this tool manages files, it does not delete them permanently—it strictly moves them into organized subfolders, allowing for safe recovery if needed.