[docs] Reduce bloat in code-simplifier.md

[github-actions]

Removes 75 lines (24%) of repetitive content from .github/workflows/code-simplifier.md.

File improved

.github/workflows/code-simplifier.md — 309 → 234 lines (-24.3%)

Types of bloat removed

1. Multi-language command lists — Phase 3 validation steps each had a bash block listing 5–6 irrelevant ecosystem commands (npm, Maven, Gradle, Python, Rust, Cargo). Replaced with concise one-sentence instructions.

2. Repeated Phase 2.3 opportunity list — 6-bullet list of refactoring opportunities (long functions, duplicate code, unclear names...) fully duplicated the Phase 2.2 principles. Replaced with a cross-reference to §2.2.

3. "Important Guidelines" section (21 lines) — verbatim repetition of: Phase 1 scope ("focus on recent changes"), Phase 2.2 principles ("preserve functionality", "follow conventions"), and Phase 4.1 exit conditions. Removed entirely.

4. "Output Requirements" section (9 lines) — restated the three outcomes already described in Phase 4.1. Removed entirely.

5. "Review Focus" PR template item — 4 redundant bullets condensed to one sentence.

What was preserved

• All decision logic (phases 1–4, when to create a PR, exit conditions)
• The PR description template structure
• All simplification principles in §2.2
• The "Maintain Balance" guidance against over-simplification

---

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 29587144149 -n agent -D /tmp/agent-29587144149

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

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

# Push the branch and create the pull request
git push origin docs/unbloat-code-simplifier-c8c5ee24b63ad300
gh pr create --title '[docs] Reduce bloat in code-simplifier.md' --base main --head docs/unbloat-code-simplifier-c8c5ee24b63ad300 --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 Jul 19, 2026, 2:21 PM UTC