Skip to content

Retire embedded filesystem METHOD tooling after GitHub Issues migration #528

Description

@flyingrobots

Problem

Echo has migrated live Method backlog tracking to GitHub Issues, but the embedded METHOD tooling still assumes the old filesystem backlog exists.

Concrete evidence from the migration:

  • crates/method/src/workspace.rs still discovers a workspace by requiring docs/method/backlog.
  • PR Migrate Echo Method backlog to GitHub Issues #527 had to add docs/method/backlog/.gitkeep purely as a compatibility marker so fresh clones can still run legacy cargo xtask method ... commands.
  • Legacy commands such as cargo xtask method inbox, matrix, dag, frontier, critical-path, and check-dag still describe or operate on the old filesystem backlog model.
  • cargo xtask method status now reports zero legacy backlog files after migration, which is expected but misleading if treated as the live tracker.

This is bad code because the implementation encodes a retired workflow as a structural workspace invariant. The marker file is acceptable as a short-term bridge, not as architecture.

Desired outcome

Echo either removes the embedded filesystem-backlog METHOD command surface or replaces it with GitHub-Issues-aware behavior.

Acceptance criteria

  • Fresh clones do not require a fake/empty backlog directory solely to satisfy Method workspace discovery.
  • cargo xtask method status does not present the empty legacy filesystem backlog as the live tracker.
  • Legacy filesystem commands are removed, explicitly deprecated, or redirected to GitHub Issues guidance.
  • Docs and command help agree that GitHub Issues are the live tracker.
  • Existing design/retro/legend docs remain discoverable without resurrecting live docs/method/backlog/** cards.

References

Activity

  1. coderabbitai commented on Jun 1, 2026

    @coderabbitai
    Contributor
    🔗 Related PRs

    #184 - Docs: align roadmap with milestone tracks (closes #183) [merged]
    #309 - feat: add Doghouse PR flight recorder [merged]
    #373 - chore: remove legacy ttd-browser surface [merged]
    #385 - docs(backlog): two follow-ups from the 2026-05-30 merge session [merged]
    #388 - docs(method): add backlog cards and hook failure note [merged]


    📝 Issue Planner

    Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.

    • Create Plan

    🧪 Issue enrichment is currently in open beta.

    You can configure auto-planning by selecting labels in the issue_enrichment configuration.

    To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

    issue_enrichment:
      auto_enrich:
        enabled: false

    💬 Have feedback or questions? Drop into our discord!

  2. modified the milestones: , Echo 1.0 on Jun 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions