Skip to content

Comments

Add Jules maintenance workflows for dead code cleanup and doc drift detection#132

Merged
Miyamura80 merged 1 commit intomainfrom
feat/jules-maintenance-workflows
Feb 24, 2026
Merged

Add Jules maintenance workflows for dead code cleanup and doc drift detection#132
Miyamura80 merged 1 commit intomainfrom
feat/jules-maintenance-workflows

Conversation

@Miyamura80
Copy link
Owner

Summary

  • Add two new automated Jules workflows for weekly repository maintenance on Wednesdays:
    • Dead code cleanup (jules-prune-unnecessary-code.yml) - runs at 2pm UTC, scans for unused code following conservative rules in UNNECESSARY_CODE_GUIDELINE.md
    • Documentation drift detection (jules-find-outdated-docs.yml) - runs at 4pm UTC, finds outdated docs following rules in OUTDATED_DOCUMENTATION_GUIDELINE.md
  • Add policy guideline files (UNNECESSARY_CODE_GUIDELINE.md, OUTDATED_DOCUMENTATION_GUIDELINE.md) that each workflow reads before making changes
  • Add "Jules Workflows" step (step 6) to make onboard CLI, allowing users to enable/disable the workflows by toggling them on/off

Both workflows follow the established Jules API pattern from the existing translation sync workflow with proper error handling, exponential backoff retry logic, timeout protection, and AUTO_CREATE_PR automation mode. Schedule timing is staggered to avoid conflicts.

Test plan

  • Run make onboard and verify the new step 6 "Jules Workflows" appears
  • Run uv run python onboard.py jules to test the standalone subcommand
  • Verify enabling/disabling toggles workflow files correctly (.yml vs .yml.disabled)
  • Verify both workflow YAML files are valid (trigger workflow_dispatch manually)
  • Review guideline files for completeness and project-specific accuracy

🤖 Generated with Claude Code

… detection

Add two automated Jules workflows (Wednesdays 2pm/4pm UTC) with policy
guideline files and an onboarding step to enable/disable them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 24, 2026

Greptile Summary

Added two new Jules-powered weekly maintenance workflows with comprehensive guideline documents and CLI integration. The workflows follow the established pattern from jules-sync-translations.yml with proper error handling, exponential backoff retry logic, and timeout protection.

Key additions:

  • Dead code cleanup workflow - runs Wednesdays at 2pm UTC, scans for unused code using conservative rules
  • Documentation drift detection workflow - runs Wednesdays at 4pm UTC, finds outdated docs with strict validation
  • Guideline documents (UNNECESSARY_CODE_GUIDELINE.md, OUTDATED_DOCUMENTATION_GUIDELINE.md) that each workflow reads before making changes
  • Onboarding CLI step 6 - allows users to enable/disable workflows via make onboard or uv run python onboard.py jules

The implementation is clean, follows project conventions, and provides proper safeguards against overly aggressive automated changes.

Confidence Score: 5/5

  • This PR is safe to merge with minimal risk
  • The implementation follows established patterns from the existing Jules translation workflow, includes comprehensive safety guidelines for both workflows, has proper error handling with exponential backoff, and integrates cleanly with the existing onboarding CLI. The guideline documents provide conservative rules that prevent aggressive automated changes.
  • No files require special attention

Important Files Changed

Filename Overview
.github/workflows/jules-find-outdated-docs.yml Added weekly automated documentation drift detection workflow with proper error handling, retry logic, and timeout protection
.github/workflows/jules-prune-unnecessary-code.yml Added weekly automated dead code cleanup workflow with conservative rules, proper error handling, and exponential backoff
OUTDATED_DOCUMENTATION_GUIDELINE.md Comprehensive guideline document defining rules for documentation drift detection with clear validation criteria
UNNECESSARY_CODE_GUIDELINE.md Conservative guideline document with protected patterns and validation rules for safe dead code removal
onboard.py Added Jules Workflows step (step 6) with enable/disable toggle functionality for new automated maintenance workflows

Last reviewed commit: 4528e1f

@Miyamura80 Miyamura80 merged commit ce43732 into main Feb 24, 2026
11 checks passed
@github-actions github-actions bot deleted the feat/jules-maintenance-workflows branch February 24, 2026 19:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants