From 96dfa6394a76994d713ee56c07009d3296de4fda Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 28 Jun 2026 12:40:27 -0400 Subject: feat(workflows): add code-quality sweep workflow A thin orchestrator that runs the behavior-preserving quality passes over a scope of existing code in order: /refactor, then readability-audit, then it surfaces the :refactor: tasks readability filed and any deferred /refactor findings. It leaves /simplify out, since that works the current diff rather than existing code. --- .ai/workflows/INDEX.org | 2 ++ 1 file changed, 2 insertions(+) (limited to '.ai/workflows/INDEX.org') diff --git a/.ai/workflows/INDEX.org b/.ai/workflows/INDEX.org index 807410d..a474b29 100644 --- a/.ai/workflows/INDEX.org +++ b/.ai/workflows/INDEX.org @@ -91,6 +91,8 @@ This index must list every =.org= file in =.ai/workflows/= except this one and e ** Code quality +- =code-quality.org= — one trigger that sequences every behavior-preserving quality pass over a scope of existing code: =/refactor= (complexity, duplication, dead-code, simplification) then =readability-audit= (comments, headers, names, organization), then surfaces the =:refactor:= tasks readability filed and any deferred =/refactor= findings. A thin orchestrator — each pass keeps its own gate. Excludes =/simplify= (that's for the current diff, not existing code). + - Triggers: "code quality sweep", "quality sweep", "run every quality pass on ", "give me every pass on " - =readability-audit.org= — make code readable to a future maintainer: audit file-top commentary, inline comments (why-not-what), names (intention-revealing), and organization (co-location / stepdown / cohesion). The cheap comment- and name-only fixes (dimensions A/B/C) land inline, verified by a green suite; the structural findings (dimension D — split a module, rename a public symbol) are *filed* as =:refactor:= tasks, not done here. Language-agnostic. Feeds =/refactor= (which executes the filed structural work); distinct from =/refactor='s metric scans and =/simplify='s diff cleanup. - Triggers: "let's run the readability-audit workflow", "audit the comments and commentary in ", "clean up the structure/organization of ", "readability audit" -- cgit v1.2.3