What problem does it solve? Teams tracking work in local markdown files (BACKLOG.md, TODO.md, DONE.md, plans/, tasks/) lack the visibility and collaboration features of a real project board, and manually recreating that state in GitHub Projects is error-prone and tedious. ## Core Features & Use Cases - One-shot migration: Parses backlog, todo, done, plan, and task markdown files and pushes them to a GitHub Project board as issues, plan comments, and sub-issues with correct statuses and labels. - Idempotent and auditable: Detects already-migrated items via markers, creates a timestamped backup with SHA-256 manifest, and writes a full MAPPING.md report linking every source line to its destination issue. - Interactive ambiguity resolution: Prompts the user to match unmatched plans and tasks, choose done-item import policy, and confirm archiving of source markdown. - Use Case: A project using a markdown-based agent workflow wants to switch to the github_project backend; running /agent-migrate provisions the board, migrates all items, updates agent.yaml, and stages the archive for review. ## Quick Start Run /agent-migrate from the project root to migrate the existing .workflow markdown files into a GitHub Project board.
