computer-playbook/docs/agents/action/refactor.md

Refactoring and Optimization

After Every Commit

After every commit you MUST ask the user:

"Do you want to refactor and optimize the affected files?"

• If the user answers no, continue without refactoring.
• If the user answers yes, follow the steps below.

Refactoring Steps

1. You MUST re-read AGENTS.md and follow all instructions in it before proceeding.
2. You MUST apply all rules from AGENTS.md and docs/contributing/ to every affected file — not only code rules, but also documentation, naming, structure, and any other applicable guidelines.
3. For every affected documentation file, you MUST optimize the text so it follows the standards defined in documentation.md, including RFC 2119 keywords, link formatting, and writing style.
4. If the change affects an Ansible role, you MUST refactor and optimize the entire role, not only the files that were directly modified.
   • If the change affects more than one role, you MUST ask the user before proceeding:

     "The following roles are affected: [list]. Which roles should be refactored — specific ones, or all?"

   • Then refactor only the roles confirmed by the user.