Worklog
Update task state in worklog files. Requires explicit arguments.
Worklog Files
- •
gitignore/worklog.todo.md— backlog - •
gitignore/worklog.doing.md— in progress - •
gitignore/worklog.done.md— completed (grouped by date, append-only)
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:
code
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.mdunder 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
code
Worklog updated: - [action taken]: [description]