log-file-use
When a mode needs to read, create, or write (log progress) to a log file.
When & Why to Use This Skill
This Claude skill provides a standardized framework for AI agents to manage progress logs, enabling systematic tracking of actions, timestamps, and task completions. By enforcing a consistent logging format and organized file structure, it ensures transparency, improves debugging, and provides a reliable audit trail for complex agentic workflows.
Use Cases
- Task Progress Tracking: Automatically record step-by-step actions during long-running coding or research tasks to maintain a clear history of what has been accomplished.
- Audit & Compliance: Generate a chronological log of agent decisions and tool executions, providing a transparent audit trail for review by human supervisors.
- Context Resumption: Enable agents to read previous log files to quickly regain context and resume work on interrupted projects without losing track of past progress.
- Error Debugging: Use structured log files to identify exactly when and where a workflow deviated from the plan, facilitating faster troubleshooting and refinement.
| name | log-file-use |
|---|---|
| description | When a mode needs to read, create, or write (log progress) to a log file. |
Log file use instructions
Comstants
Logging format:
date + time; action summary(semicolon separated).- Ex:
"2026-02-14 07:23; Approved to begin". - Ex:
"2026-02-14 07:25; Task completed: Added update_query() to utils_sql.py, refactored utils_sql.py, junk.py". Plans folder:.roo/docs/plans/
- Ex:
Initialization tasks
Do in order:
1 Determine User query:
Determine user_query value from current context or other input.
- If still not known: consult user.
2 Determine Plan name:
Do in order:
a) Determine short plan name value from current context, current task, or other input.
- If still not known: consult user.
b) Create
short_2_word_descriptionof current task based on current context. c)short plan name:yymmdd_{short_2_word_description}.
3 Determine Log file name and path:
log file:{plans folder}_[short plan name]_log.md.
Log file use instructions
Reading a log file
- Use the
read_filetool to readlog file.
Creating a log file
- Use the
write_to_filetool to create fresh (or modify existing)log filein the{plans folder}.
Writing to a log file
- Use the
apply_difftool to modify existinglog filein the{plans folder}.