[docs] docs: reduce code-simplifier.md bloat by 46%

[github-actions]

File Improved

.github/workflows/code-simplifier.md

Bloat Removed

1. Consolidated repetitive principles — Merged sections 2.1-2.4 (lines 97-157) into a single, focused section that covers project standards review and simplification principles together
2. Merged validation steps — Combined three separate subsections (test/lint/build) into a unified Phase 3 with inline commands
3. Removed boilerplate template — Eliminated verbose PR description template (lines 226-273) and replaced with concise requirements
4. Eliminated redundant guidelines — Removed "Important Guidelines" section (lines 279-299) that duplicated core principles already stated earlier
5. Simplified exit conditions — Consolidated repeated "Exit Conditions" mentions into a brief summary section

Statistics

• Lines before: 309
• Lines after: 166
• Reduction: 143 lines (46% reduction)
• Word count reduction: ~25% fewer words

Content Preserved

✅ All essential instructions for identifying, analyzing, validating, and submitting code simplifications
✅ All code examples and commands
✅ Core principles and guidelines
✅ Exit conditions and success criteria

Improvements

• Clarity: Removed duplication makes guidance easier to follow
• Conciseness: Streamlined language while preserving technical accuracy
• Navigation: Clearer phase structure despite shorter content
• Maintenance: Easier to update and maintain with less redundancy

---

Warning

Protected Files — Push Permission Denied

This was originally intended as a pull request, but the patch modifies protected files. A human must create the pull request manually.

Protected files

• .github/workflows/code-simplifier.md

The push was rejected because GitHub Actions does not have workflows permission to push these changes, and is never allowed to make such changes, or other authorization being used does not have this permission.

Create the pull request manually

# Download the patch from the workflow run
gh run download 34623599117 -n agent -D /tmp/agent-34623599117

# Create a new branch
git checkout -b docs/unbloat-code-simplifier-deedc18fc1f424b4 main

# Apply the patch (--3way handles cross-repo patches)
git am --3way /tmp/agent-34623599117/aw-docs-unbloat-code-simplifier.patch

# Push the branch and create the pull request
git push origin docs/unbloat-code-simplifier-deedc18fc1f424b4
gh pr create --title '[docs] docs: reduce code-simplifier.md bloat by 46%' --base main --head docs/unbloat-code-simplifier-deedc18fc1f424b4 --repo droosma/WitnessSharp

🗜️ Compressed by Documentation Unbloat

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/unbloat-docs.md@1c6668b751c51af8571f01204ceffb19362e0f66

• expires on Sep 13, 2026, 4:49 PM UTC