Completetodo

Complete TODO

Review the current conversation, identify work that has been completed, and mark the corresponding TODO items as done in ContextDB/todos/.

Workflow

1. Scan for active TODO files:

   • List all files in ContextDB/todos/.
   • Skip files prefixed with completed- (these are fully done).
   • Read each remaining file and collect all open items (- [ ]).

2. Match completed work against open TODOs:

   • Review the current conversation to understand what was accomplished.
   • For each open TODO item, determine if the work described has been done in this session.
   • Be thorough but conservative — only mark items as done if you're confident the work is complete, not just started.

3. If the user provides specific items to complete:

   • The user may say things like "mark the auth task as done" or list specific items.
   • Match their description to the closest open TODO item(s).
   • If ambiguous, show the matching candidates and ask which one(s) to mark.

4. Update the file(s):

   • Replace - [ ] with - [x] for each completed item.
   • Add a completion timestamp as an inline comment:

     - [x] Implement login endpoint in `app/api/auth/route.ts` <!-- completed 2026-02-07 14:30 -->
     

   • Do not modify any other content in the file.
   • Do not remove items — completed items stay in the file as a record.

5. Check if the entire file is now complete:

   • After updating, count remaining - [ ] items in the file.
   • If zero open items remain, rename the file:
     • From: 2026-02-07-auth-refactor-todo.md
     • To: completed-2026-02-07-auth-refactor-todo.md
   • This signals to /opentodos that the file can be skipped entirely.

6. Report to the user:

   • List which items were marked as done.
   • List any items that are still open.
   • If a file was renamed to completed-, mention that.

Example

Before:

- [ ] Add login endpoint
- [ ] Create JWT utility
- [x] Set up auth middleware <!-- completed 2026-02-06 10:15 -->

After running /completetodo (login endpoint was built this session):

- [x] Add login endpoint <!-- completed 2026-02-07 14:30 -->
- [ ] Create JWT utility
- [x] Set up auth middleware <!-- completed 2026-02-06 10:15 -->

Guidelines

• Read the actual conversation — don't guess. Only mark items you have evidence were completed.
• If a task was partially done, do NOT mark it as complete. Instead, leave it open and optionally add a sub-note:

  - [ ] Implement user authentication
    - [x] Login endpoint done <!-- completed 2026-02-07 -->
    - [ ] Token refresh still pending
  

• Preserve the original wording of TODO items — don't rewrite them.
• If no TODOs match the current session's work, say so honestly.
• Always confirm what you're about to mark before writing, especially if the match is fuzzy.