worklog

name	worklog
description	Update worklog files by moving tasks between todo/doing/done states. Use when recording task progress, starting new work, or marking tasks complete. Requires explicit arguments: worklog [done|doing|todo] [description].

Worklog

Update task state in worklog files. Requires explicit arguments.

Worklog Files

• localdocs/worklog.todo.md — backlog
• localdocs/worklog.doing.md — in progress
• localdocs/worklog.done.md — completed (grouped by date, append-only)

worklog is for current phase/session execution tracking. For future items not yet included in an approved plan, use localdocs/backlog.<topic>.md.

Arguments

$ARGUMENTS must be: [state] [description]

• done [description] — mark task complete
• doing [description] — start working on a task
• todo [description] — add to backlog

If no arguments, stop and output:

Error: worklog requires explicit arguments.
Usage: worklog [done|doing|todo] [description]

Examples:
  worklog done config/settings.py setup complete
  worklog doing collectors/data_go_kr.py implementation
  worklog todo parsers/xml_parser.py implementation

What to Read (by command)

done: Read worklog.doing.md only — to find and remove the matching item. doing: Read worklog.todo.md only — to find and remove the matching item. todo: No need to read any file — just append.

Never read worklog.done.md — it is append-only and grows over time.

Update Rules

done [description]

1. Read worklog.doing.md; find matching item (keyword match, not exact)
2. Remove the item from doing
3. Append to worklog.done.md under today's date section (## YYYY-MM-DD), creating the section if absent
4. If no match in doing, append directly to done without removing anything

doing [description]

1. Read worklog.todo.md; find matching item
2. Remove the item from todo
3. Append to worklog.doing.md
4. If no match in todo, append directly to doing

todo [description]

1. Append item to end of worklog.todo.md

Writing Style

• Concise bullet points — focus on what was done, not how
• Use filenames and concrete task names over vague descriptions
• No tables or heavy formatting
• Done items must be under a date section (## YYYY-MM-DD)

Output

Worklog updated:
- [action taken]: [description]