agent-md-refactor

Refactor bloated agent instruction files by applying progressive disclosure principles to separate core instructions from non-essential details. The process identifies contradictions, extracts essentials, and groups related instructions into logical files for better maintainability.

Progressive disclosure for agent instructions is an organization method that keeps the root file minimal and concise while grouping non-essential details into categorized logical files. This structure prevents contradictions and flags redundant instructions for deletion.

Yes, you need pnpm installed in your environment to execute the scripts required by this refactoring process. The scripts identify contradictions, extract essentials, categorize content, and suggest deletions to clean up your documentation.

Identify contradictions and redundant instructions in agent documentation by running refactoring scripts that analyze the file content. The process flags conflicting instructions for resolution, extracts universal rules, and suggests outdated content for deletion.

Yes, you can extract essential instructions by separating core, universal instructions from non-essential details. The refactoring process ensures the root file contains only essential information while categorizing the remaining content into logical files.

The best way to maintain overgrown agent instruction files is to apply progressive disclosure principles. This involves categorizing related instructions, minimizing the root file, and removing redundant or outdated instructions to improve overall readability and maintainability.