project-memory

Store and retrieve project learnings and decisions using GitHub Issues.

10|1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/maystudios/maxsimcli --skill project-memory-maystudios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-memory
Source: https://github.com/maystudios/maxsimcli/tree/main/templates/skills/project-memory
Command: npx skills add https://github.com/maystudios/maxsimcli --skill project-memory-maystudios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code sessions are stateless. This skill uses GitHub Issues as a persistent, searchable memory store so that learnings and decisions survive across sessions.

Core Features & Use Cases

  • Memory capture of successful patterns, failed approaches, and architectural decisions to inform future sessions.
  • Structured issue-based records with labels (type:lesson, type:decision) and a searchable history across projects.
  • Tooling to query and consolidate memories to avoid context rot.

Quick Start

Record a memory lesson or decision to the GitHub Issues project memory.

Frequently Asked Questions about project-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist project learnings across Claude Code sessions?

To persist project learnings across Claude Code sessions, you can store decisions and patterns using GitHub Issues as a searchable memory store. This records lessons after plan and review, binding decisions to specific issues to survive stateless session resets.

What is the best way to track architectural decisions using GitHub Issues?

Tracking architectural decisions using GitHub Issues involves creating structured records with specific labels like type:decision and type:lesson. This ensures a consistent, searchable history of project patterns and failed approaches across your repository.

How does storing project memory in GitHub Issues prevent context rot?

Storing project memory in GitHub Issues prevents context rot by applying tooling to query and consolidate memories. It uses a structured memory format defined in MEMORY.md with labeled comments to maintain consistent, searchable records for future sessions.

Do I need a MEMORY.md file to record lessons learned in GitHub Issues?

Yes, a MEMORY.md file is needed to define the structured memory format for recording lessons learned in GitHub Issues. It ensures consistent capture of successful patterns and failed approaches alongside labeled comments for searchable project history.

Can I query and consolidate past project decisions bound to specific issues?

Yes, you can query and consolidate past project decisions bound to specific issues using the memory consolidation tooling. This retrieves architectural decisions and patterns through GitHub Issues labels to inform future development sessions.