Add symmetric cross-system handoffs to memory agent and document integration #506
Description
Summary
The memory agent serves both RPI and GitHub Backlog systems via the shared /checkpoint prompt but has asymmetric outbound handoffs (routes back to rpi-agent only) and zero user documentation about session persistence or cross-system integration.
Handoff Architecture
| Aspect | RPI System | Backlog System |
|---|---|---|
| Inbound trigger | 💾 Save button in rpi-agent.agent.md |
Save button in github-backlog-manager.agent.md |
| Prompt used | /checkpoint |
/checkpoint |
| State files | Memory tracking directory | Memory + GitHub issues tracking |
| Return path | 🚀 Continue with RPI handoff button |
Manual agent switch only (no button) |
| User docs | None | None |
Asymmetric Return Path
The memory agent's frontmatter defines two outbound handoffs, both targeting rpi-agent:
- label: "🗑️ Clear"
agent: rpi-agent
prompt: /clear
- label: "🚀 Continue with RPI"
agent: rpi-agent
prompt: /rpi suggestNo outbound handoff to github-backlog-manager exists. Backlog users who restore memory via /checkpoint continue must manually switch back to the backlog manager, while RPI users get a one-click handoff button.
Documentation Gaps
docs/rpi/using-together.mdcontains zero mentions of the memory agent,/checkpoint, session persistence, or the💾 Savebuttondocs/agents/github-backlog/does not document memory integrationdocs/agents/README.mdlists memory as "Planned" documentationdocs/contributing/ROADMAP.mdlists "Implement agent memory and context management" as a will-do item
Plugin Distribution
The memory agent and /checkpoint command are symlinked across all 10 plugin collections, confirming its role as universal infrastructure.
Recommended Approach
Two separable work items:
1. Add backlog return handoff
Add a 🚀 Continue with Backlog outbound handoff to the memory agent's frontmatter targeting github-backlog-manager.
2. Document memory integration
- Add session persistence section to
docs/rpi/using-together.mdcovering the checkpoint prompt, save/restore flow, and resume instructions - Document memory integration in
docs/agents/github-backlog/ - Update
docs/agents/README.mdstatus for memory agent documentation
Acceptance Criteria
- Memory agent frontmatter includes outbound handoff to
github-backlog-manager -
docs/rpi/using-together.mddocuments the memory agent save/restore flow -
docs/agents/github-backlog/describes memory integration and checkpoint usage - Both inbound (Save button) and outbound (Continue) paths documented for each system