Our review

Updates worklog files by moving tasks between todo/doing/done states.

Strengths

Simple structured task tracking by state
Keyword matching to identify tasks
Keeps a dated history of completed items
No need to read large done files (append-only)

Limitations

Requires explicit arguments, no interactive mode
Keyword matching can be imprecise with similar descriptions
Only works with specific local Markdown files

When to use it

Use when recording task progress, starting new work, or marking tasks complete during a coding session.

When not to use it

Avoid for complex project management requiring dependencies, priorities, or multiple views.

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]`

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

`doing [description]`

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

`todo [description]`

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]

Worklog Management

Recommended for