sys-maintenance

Synchronize project documentation and AI environment context after merges or refactors.

Updated Jan 16, 2026

Search Tags:#automation #devops #documentation #sync #scripts #AI-env

Ready to run

npx skills add https://github.com/JuelHossain/kalshi-trading-team --skill sys-maintenance

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sys-maintenance
Source: https://github.com/JuelHossain/kalshi-trading-team/tree/main/ai-env/skills/sys-maintenance
Command: npx skills add https://github.com/JuelHossain/kalshi-trading-team --skill sys-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill ensures that the Project Intelligence (OpenCode Skills, ai-env/ personas, and Platform Configs) never desyncs from the actual Python/React code.

Core Features & Use Cases

Automated Alignment: Keeps AGENTS.md, CLAUDE.md, personas, and BrainAgent logic aligned with the current code pillars.
Lifecycle Consistency: Reconciles changes after major merges or refactors to avoid configuration drift.
Lightweight tooling: Uses minimal Python scripts to perform checks and create compact archives when needed.

Quick Start

Run the sync workflow after any major merge or refactor. For example, execute the included maintenance script to verify and align docs and configurations.

Frequently Asked Questions about sys-maintenance

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

FAQPage Schema

How do I keep AGENTS.md and CLAUDE.md synced with my codebase after a refactor?▼

To keep AGENTS.md and CLAUDE.md synced after a refactor, you can automate documentation alignment using lightweight Python scripts. These scripts compare your current docs against the actual code pillars to detect and prevent configuration drift.

What is AI environment documentation drift and how do I prevent it?▼

AI environment documentation drift occurs when project intelligence like personas and platform configs desync from your actual Python or React code. You prevent it by running automated checks that compare docs with code to maintain alignment.

Do I need external dependencies to run Python scripts for documentation sync?▼

No external dependencies are required to run these documentation sync scripts. The lightweight Python implementation relies solely on the standard library to compare current docs with code and generate alignment reports.

Can I automate alignment of ai-env personas and platform configs after major merges?▼

Yes, you can automate the alignment of ai-env personas and platform configs after major merges. The sync workflow leverages Python scripts to reconcile changes, verify consistency, and create compact archives when needed.

When should I run a documentation sync check for my AI environment?▼

You should run a documentation sync check after any major merge or refactor in your codebase. This lifecycle consistency check ensures your AGENTS.md, CLAUDE.md, and ai-env personas accurately reflect the updated code pillars.

What is the best way to reconcile project intelligence docs with Python and React code?▼

The best way to reconcile project intelligence docs with Python and React code is using an automated sync workflow. It compares documentation against your code pillars to identify gaps and generates reports to fix alignment issues.