groove-utilities-memory-graduate

groove-utilities-memory-graduate

Promote a stable workflow insight from .groove/memory/learned/ into AGENTS.md as a permanent constraint — visible to every agent session without needing to run prime.

Use $ARGUMENTS as the topic or insight text if provided.

Outcome

The lesson is appended to a <!-- groove:learned:start --> / <!-- groove:learned:end --> section in AGENTS.md, making it permanently visible to all future sessions.

Acceptance Criteria

• Insight is appended to the ## Graduated Learnings section in AGENTS.md
• Section is created if it does not exist
• User confirms the exact text before writing
• Source learned/<topic>.md entry is marked as graduated (not deleted)

Steps

1. Memory path is always .groove/memory/
2. If $ARGUMENTS names a topic, read .groove/memory/learned/<topic>.md and show its entries. Otherwise, list all *.md files in .groove/memory/learned/ and ask which topic to graduate from.
3. Show the file contents; ask: "Which entry should be graduated? (paste or describe it)"
4. Show the exact text that will be written to AGENTS.md; ask: "Confirm? (yes / edit / skip)"
5. If confirmed: write to AGENTS.md (see section management below)
6. Mark the entry in the learned file by appending [graduated YYYY-MM-DD] inline after the bullet
7. Report: "Lesson graduated to AGENTS.md → ## Graduated Learnings"

Section management in AGENTS.md

Look for a <!-- groove:learned:start --> / <!-- groove:learned:end --> block:

• If the block exists: append the new insight as a bullet under ## Graduated Learnings inside the block
• If the block does not exist: append the following to the end of AGENTS.md:

<!-- groove:learned:start -->
## Graduated Learnings

Stable workflow insights promoted from `.groove/memory/learned/`. These apply to every session.

- <insight text>
<!-- groove:learned:end -->

Each entry is a single bullet: - <insight text> *(from learned/<topic>.md, graduated YYYY-MM-DD)*

Constraints