mattrguerra.comHouston area
Matt Guerra
  1. 01AI & Automation
  2. 02Photography
  3. 03Design
  4. 04About
  5. 05Notes
  6. 06Contact
Back to the systems

mattrguerra/meridian-skillsmainPrivate on GitHub, published here in full

HEARTBEAT.md.tmpl

2.2 KB74 lines

skills/cowork-project-architect/templates/HEARTBEAT.md.tmpl

  1. ---
  2. type: working-state
  3. scope: project-root
  4. tags:
  5. - claude
  6. - heartbeat
  7. - ephemeral
  8. status: idle
  9. created: [YYYY-MM-DD]
  10. updated: [YYYY-MM-DD HH:MM TZ]
  11. ---
  13. <!--
  14. HEARTBEAT.md: Ephemeral working state. High-velocity, overwritten as work progresses.
  16. Save state for in-flight agentic work. Read it first when picking up a task.
  18. Distinct from MEMORY.md (durable) and CHANGELOG.md (historical record).
  20. Status field in frontmatter: idle | active | blocked | needs-review.
  21. Update frontmatter status whenever the project's overall state changes.
  22. -->
  24. # [PROJECT NAME]: Heartbeat
  26. **Last updated:** [YYYY-MM-DD HH:MM TZ]
  27. **Status:** [idle | active | blocked | needs-review]
  29. ## Current objective
  31. [What is Claude actively pursuing right now? One sentence. If nothing is in flight, write "Idle, awaiting next task."]
  33. ## Last action taken
  35. [The most recent meaningful step. Include result. E.g., "Scraped 47 product pages from meridiandisplay.example. 3 returned 404. List in [[02-Working/scrape-errors]]."]
  37. ## Next planned action
  39. [The next concrete step. If unclear, write "Decision point: see Open questions below."]
  41. ## Open questions / blockers
  43. <!-- Things that need resolution before progress continues. -->
  45. - [Question or blocker. Include who needs to answer if it's a user decision.]
  47. ## State variables
  49. <!-- Counters, IDs, in-progress filenames, batch positions, anything a resumed
  50. session needs to know to not duplicate work. -->
  52. - **[Variable]:** [value]
  53. - **[Variable]:** [value]
  55. ## Files in motion
  57. <!-- Files currently being edited or written. Useful for crash recovery. -->
  59. - [[02-Working/file-name]]: [what state it's in]
  61. ## Notes for next session
  63. [Free-form notes. What you'd tell yourself if you were going to leave for the day. Include any context that's hard to reconstruct from files alone.]
  65. ---
  67. <!-- Update protocol:
  68. 1. At the start of any agentic work, read this file.
  69. 2. Update "Current objective" and "Last action" before doing anything else.
  70. 3. Update "Next planned action" before pausing or handing off.
  71. 4. Update timestamp on every meaningful change.
  72. 5. Update frontmatter `status` and `updated` fields too.
  73. 6. Move completed work to [[CHANGELOG]] if it's a real milestone.
  74. -->