task-progress

name	task-progress
description	Use when executing a task (progress logging, plan updates), when resuming a task after session reset, or when managing task history. Covers progress log format, task-history.json, and resume flow.

Task Progress

Gotchas

• Push progress log after every meaningful action — don't batch updates; session resets can lose unpushed work
• task-history.json is LRU top 10 — overflow goes to ~/.hermes/history-tasks/{task-id}.json
• Resume flow reads progress/ latest-first — keep filenames as YYYY-MM-DD.md for correct sort order

Progress Log

After every meaningful action (completing a sub-step, hitting a problem, making a decision), append to:

~/shared/tasks/{task-id}/progress/YYYY-MM-DD.md

Format (append, don't overwrite):

## HH:MM — {brief action title}

- What was done: ...
- Current state: ...
- Issues encountered: ...
- Next step: ...

Push the task directory after each update:

mc mirror ~/shared/tasks/{task-id}/ ${AGENTTEAMS_STORAGE_PREFIX}/shared/tasks/{task-id}/ --overwrite --exclude "spec.md" --exclude "base/"

Task History (LRU Top 10)

File: ~/.hermes/task-history.json

{
  "updated_at": "2026-02-21T15:00:00Z"