pelizzai-writing-skills

To maintain AI agent skills during stack upgrades, use proactive maintenance to detect version drift in project manifests and propose updates to existing domain skills. This ensures agent behavior remains grounded in current conventions.

The best way to author project-specific domain skills is using a structured engine that generates grounded rules based on project patterns and official documentation, enforcing validation through trigger tests and diff-based approval workflows.

Diff-based approval prevents unauthorized overwrites by requiring explicit review of proposed changes before any skill updates are applied. This rigorous validation stops blind automated overwrites and maintains documentation integrity.

Yes, you can automate workflow maintenance by analyzing git history patterns. The system detects repeating patterns in your repository history and proactively proposes updates to keep domain skills relevant.

Yes, you need Node.js installed in your environment to run the scripts required for authoring and maintaining project-specific domain skills, as it is a required dependency for executing the validation and maintenance workflows.

You should not use automated proactive maintenance when you need strict manual control over documentation changes, because the system automatically proposes updates based on version drift and git patterns that could alter existing conventions.