worklog
- Repo stars 14
- Author repo python-project-template
- Domain
- Productivity
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tae0y · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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]
```
Sections and files
Listed in source order.
sections -> Worklog Files → Arguments → What to Read (by command) → Update Rules → done [description] → doing [description]
terms -> done · doing · todo · Update task state in worklog files. · worklog is for current phase/session execution tracking. · done: Read worklog.doing.md only — to find and remove the matching item. · Never read worklog.done.md — it is append-only and grows over time.
files/cmd -> localdocs/worklog.todo.md · localdocs/worklog.doing.md · localdocs/worklog.done.md · worklog · localdocs/backlog.<topic>.md · $ARGUMENTS · [state] [description] · done [description]
body sha256 -> 403477593912
Worklog Files
localdocs/worklog.todo.md— backloglocaldocs/worklog.doing.md— in progresslocaldocs/worklog.done.md— completed (grouped by date, append-only)worklogis for current phase/session execution tracking. For future items not yet included in an approved plan, uselocaldocs/backlog.<topic>.md.Arguments
$ARGUMENTSmust be:[state] [description]done [description]— mark task completedoing [description]— start working on a tasktodo [description]— add to backlog If no arguments, stop and output:What to Read (by command)
done: Readworklog.doing.mdonly — to find and remove the matching item.doing: Readworklog.todo.mdonly — to find and remove the matching item.todo: No need to read any file — just append. Never readworklog.done.md— it is append-only and grows over time.done [description]
Read
worklog.doing.md; find matching item (keyword match, not exact) Remove the item from doing Append toworklog.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 anythingdoing [description]
Read
worklog.todo.md; find matching item Remove the item from todo Append toworklog.doing.mdIf no match in todo, append directly to doing