maceff-todo-hygiene

Policy-aligned TODO hygiene validates planned additions, modifications, or removals against governance rules before execution. The Skill reads policy constraints via the macf_tools CLI, extracts section-based requirements, and checks your change plan against structure, preservation, context, and hierarchy depth rules to prevent violations.

TODO hygiene in governance ensures TODO trees maintain compliance with organizational policy, traceability, and documentation standards. It prevents drift and lost context by enforcing constraints on structure, citations, and hierarchy before changes are applied, keeping TODOs aligned with established rules.

Yes. This Skill integrates policy enforcement directly into CLI workflows by orchestrating CEP-guided policy reads through macf_tools, enabling line-number citations and extractive questions to drive action-specific decision logic before adding, modifying, completing, or removing TODO items.

Before restructuring, read the applicable policy to extract required constraints, then prepare your change plan. The Skill maintains historical alignment and citations by validating changes against policy rules, ensuring governance requirements are documented and linked to specific lines in your TODO tree.

The Skill enforces constraints on structure, preservation, context, traceability, and hierarchy depth. It addresses policy violations by validating that planned changes maintain required documentation, prevent lost context, preserve referenced items, and comply with depth limits before changes take effect.

No. The Skill reads policy automatically via macf_tools and surfaces relevant constraints for your specific change. You provide the planned TODO modification, and the Skill extracts policy requirements, performs validation, and reports whether your change complies before execution.