Mike/pygienium
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2caeb2f790c56c092116339b59adf7f8d95d59ee
pygienium/tasks/README.md

2.3 KiB
Raw Blame History

Pygienium — Code Hygiene Extension

Objective: A pi extension (piolium-style sub-agent loops) that runs highly-structured code-hygiene passes over a repo to clean up common LLM-code quality issues.

Status legend: [ ] todo, [~] in-progress, [x] done

Tasks

  • 01 — scaffolding → 01-scaffolding.md
  • 02 — recon → 02-recon.md
  • 03 — agent-runner → 03-agent-runner.md
  • 04 — hygiene-state → 04-hygiene-state.md
  • 05 — infrastructure-utils → 05-infrastructure-utils.md
  • 06 — check-registry → 06-check-registry.md
  • 07 — check-comments → 07-check-comments.md
  • 08 — check-deep-modules → 08-check-deep-modules.md
  • 09 — check-dead-code → 09-check-dead-code.md
  • 10 - check-complexity → 10-check-complexity.md (incl. cyclomatic complexity: 50+ must-refactor, 35–49 heavy-skepticism)
  • 11 — check-defensive-guards → 11-check-defensive-guards.md
  • 12 — orchestrator-all → 12-orchestrator-all.md
  • 13 — resume-status-export → 13-resume-status-export.md
  • 14 — readme-help-integration → 14-readme-help-integration.md

Dependencies

  • 02, 03, 04, 05 depend on 01
  • 06 depends on 02, 03, 04, 05
  • 07, 08, 09, 10, 11 depend on 06 (07 serves as the reference E2E check)
  • 12 depends on 07, 08, 09, 10, 11
  • 13 depends on 04, 06
  • 14 depends on 12, 13

Exit criteria

  • The feature is complete when /pygienium-help lists all commands/flags, each /pygienium-<check> command runs an isolated sub-agent that scans a target, applies fixes, and emits a findings+changes report; /pygienium-all runs every registered check in sequence with a unified status strip and resumable state; /pygienium-resume, /pygienium-status, and /pygienium-export work; and adding a new check requires only a new file in checks/ plus one registry entry (no index.ts command-wiring changes).

Architecture reference

  • Style: piolium (@vigolium/piolium) sub-agent loops via createAgentSession
  • Distribution: local extension under ~/.pi/agent/extensions/pygienium/, structured to be npm-publishable later
  • Each check = a "mode": deterministic recon → sub-agent analysis → sub-agent fixes → verify → cleanup
  • Check registry makes the system extensible: new check = new file + registry entry
Reference in New Issue View Git Blame Copy Permalink