Skip to content

feat(framework): rename the backlog file to TODO_AGENTS.md (#674)#692

Merged
suleimansh merged 1 commit into
mainfrom
feat/rename-todo-agents-underscore
Jul 18, 2026
Merged

feat(framework): rename the backlog file to TODO_AGENTS.md (#674)#692
suleimansh merged 1 commit into
mainfrom
feat/rename-todo-agents-underscore

Conversation

@suleimansh

Copy link
Copy Markdown
Member

Applies Rom's #674 decision: the flat backlog is TODO_AGENTS.md (underscore), not the TODO-AGENTS.md (hyphen) that #682 shipped. Underscore is the more standard spelling ("convention over proprietary files, _ over -").

What

  • FLAT_TODO_FILETODO_AGENTS.md; the loop, resume-note appender, dashboard sidebar, and Update Context prompt fragment #683 context fragment all use it.
  • Back-compat: findFlatTodo still reads the brief hyphen spelling (new LEGACY_HYPHEN_TODO_FILE) then tickets/TODO.md then root TODO.md, so no repo loses a backlog. Move tickets/TODO.md to TODO-AGENTS.md #682 is unreleased, but anyone on main who already created TODO-AGENTS.md is covered.
  • Migrates this repo's own backlog file.
  • Expands the GOAL.md context gloss ("long-term direction, scope, non-scope, …") to match the revised Update Context prompt fragment #683.

Deferred to the #326 bundle (flagged, not in this PR)

Rom's revised #683 also renames KNOWLEDGE-BASE.mdKNOWLEDGE.md. That one is entangled with #326: the on-before-mergeable prompt (drift-checked, block 2) also names KNOWLEDGE-BASE.md, and a test pins the two together, so it needs the #326 issue + snapshot updated. Holding it for the same pass as the feat/624-session-todo-agents prompt change.

Tests

tickets / todo-loop / docs / run / system-prompt suites updated for the new name + the hyphen fallback; 90 pass. Framework typecheck clean.

Per Rom's #674 call, use the underscore spelling TODO_AGENTS.md (more standard,
'convention over proprietary') instead of the hyphenated TODO-AGENTS.md that #682
shipped. New backlogs are created at TODO_AGENTS.md; the brief hyphen spelling is
kept as a read fallback (LEGACY_HYPHEN_TODO_FILE) so no repo loses a backlog,
alongside the tickets/TODO.md and root TODO.md fallbacks. Migrates this repo's own
backlog file, and expands the GOAL.md context gloss to match the revised #683.

Refs #674, #683
@suleimansh suleimansh self-assigned this Jul 18, 2026
@suleimansh
suleimansh merged commit 7f9c514 into main Jul 18, 2026
2 checks passed
@suleimansh
suleimansh deleted the feat/rename-todo-agents-underscore branch July 18, 2026 17:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant