log-file-use

When a mode needs to read, create, or write (log progress) to a log file.

⭐12stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads

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.
namelog-file-use
descriptionWhen 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/

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_description of 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_file tool to read log file.

Creating a log file

  • Use the write_to_file tool to create fresh (or modify existing) log file in the {plans folder}.

Writing to a log file

  • Use the apply_diff tool to modify existing log file in the {plans folder}.