groove-utilities-memory-graduate

<memory>/learned/

AGENTS.md

Outcome

<!-- groove:learned:start -->

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

AGENTS.md

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. Read

   memory:

   from

   .groove/index.md

2. If $ARGUMENTS names a topic, read

   <memory>/learned/<topic>.md

   and show its entries. Otherwise, list all

   *.md

   files in

   <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

<!-- groove:learned:start -->

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

• 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 -->

- <insight text> *(from learned/<topic>.md, graduated YYYY-MM-DD)*

Constraints

• Never graduate without explicit user confirmation of the exact text
• Never delete the source entry from

  learned/<topic>.md

  — mark it as graduated with

  [graduated YYYY-MM-DD]

  inline; the full context stays in the file
• The

  <!-- groove:learned:* -->

  section is user-owned — groove update will not overwrite it
• Keep graduated lessons concise — one actionable sentence per bullet; ask user to trim if longer
• If AGENTS.md does not exist: create it with just the graduated learnings section
• If the same insight is already present in the block (exact match): skip and report "Already graduated."