project-memory

Creates and maintains structured project memory files tracking bugs, decisions, facts, and work history.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/klh/skills --skill project-memory-klh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-memory
Source: https://github.com/klh/skills/tree/main/.well-known/agent-skills/project-memory
Command: npx skills add https://github.com/klh/skills --skill project-memory-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Projects lose institutional knowledge between sessions and across AI coding tools, causing repeated bugs, contradictory architectural choices, and forgotten configuration details. ## Core Features & Use Cases - Memory Infrastructure Setup: Creates a docs/project_notes/ directory with four structured files: bugs.md, decisions.md, key_facts.md, and issues.md, seeded from ready-made templates. - Tool-Agnostic Configuration: Adds memory-aware protocols to both CLAUDE.md and AGENTS.md so Claude Code, Cursor, and other AI tools consistently check and update project memory. - Search and Update Workflows: Provides grep-based search patterns and entry formats for logging bugs with solutions, ADRs, key facts, and ticket-linked work history. - Use Case: When a database connection error reappears, the assistant searches bugs.md, finds the previously documented fix, and applies it instead of debugging from scratch. ## Quick Start Ask the assistant to set up project memory for this repository so it creates the docs/project_notes files and configures CLAUDE.md and AGENTS.md.

Frequently Asked Questions about project-memory

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

FAQPage Schema
How do I set up project memory for an AI coding assistant?▼

Invoke the skill to create a docs/project_notes/ directory containing bugs.md, decisions.md, key_facts.md, and issues.md, each seeded from templates. It also adds memory protocols to CLAUDE.md and AGENTS.md so assistants check these files automatically.

How do I track architectural decisions in a project?▼

Record each decision as an ADR entry in decisions.md with context, the chosen approach, rejected alternatives, and consequences. The skill provides a dated ADR template and instructs assistants to check existing decisions before proposing changes.

Does project memory work with Cursor and other AI tools besides Claude Code?▼

Yes. The skill writes the same memory protocols into AGENTS.md, which is read by Cursor, GitHub Copilot, and other agentic tools, ensuring consistent memory behavior across platforms.

What should not be stored in project memory files?▼

The key_facts template includes security guidelines on what to exclude, such as raw secrets and sensitive credentials. Memory files are meant for configuration references, ports, URLs, and service details, not private keys.

How are old memory entries cleaned up?▼

Cleanup is manual by design. Users remove stale bug entries older than about six months and archive completed work from issues.md, while decisions are kept indefinitely for historical context.