Skip to content

Cleanup pass: docs, dead code, dead files, and stale config #23

@cbusillo

Description

@cbusillo

Goal

Do a repo hygiene pass focused on reducing future agent and maintainer friction.

Scope

  • Clean up stale or duplicated docs.
  • Remove dead code, dead files, obsolete scripts, and unused fixtures.
  • Remove or simplify stale configs, CI remnants, generated artifacts, and local-only leftovers that should not be committed.
  • Reconcile docs with .github/github-repo-workflow.json and AGENTS.md where those files exist.
  • Keep behavior changes out of this pass unless they are required to delete dead paths safely.

Suggested approach

  1. Inventory docs, configs, scripts, CI workflows, and obvious generated files.
  2. Search for references before deleting anything.
  3. Prefer small focused PRs if the cleanup spans unrelated areas.
  4. Run the repo's documented validation gates after each cleanup PR.
  5. Update workflow metadata only when the cleanup changes docs routing, commands, workflows, repo relationships, or cleanup policy.

Notes

This issue was opened after the workflow metadata rollout so each repo has a durable follow-up for general cleanup that should not be mixed into metadata-only PRs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions