project-memory

Create structured project memory files and update CLAUDE.md and AGENTS.md.

9|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/klh/speedy-claude --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/speedy-claude/tree/main/skills/project-memory
Command: npx skills add https://github.com/klh/speedy-claude --skill project-memory-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams and AI coding assistants lose project-specific context across sessions, leading to repeated debugging, conflicting architectural changes, and time wasted rediscovering past decisions and fixes. This skill centralizes institutional knowledge so both humans and agents can consult a consistent source of truth before making changes.

Core Features & Use Cases

  • Creates a docs/project_notes directory with bugs.md, decisions.md, key_facts.md, and issues.md using opinionated templates.
  • Updates or adds guidance to CLAUDE.md and AGENTS.md so AI tools check memory files before proposing changes.
  • Provides search-and-update workflows for logging bug fixes, recording ADRs, and maintaining non-sensitive project facts.
  • Use case: initialize project memory in a repo, then have Claude consult bugs.md when a recurring error appears to apply a known fix.

Quick Start

Type /project-memory in Claude Code while in your project root to create docs/project_notes, populate the templates, and update 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 maintain project knowledge and architectural decisions across AI coding sessions?

Maintain project knowledge across AI sessions by creating a structured docs/project_notes directory to track bugs, decisions, and facts, then configuring CLAUDE.md and AGENTS.md to instruct AI agents to check these memory files before proposing changes.

How do I set up project memory templates for Claude Code?

Set up project memory templates by running the initialization command in your project root to automatically generate a docs/project_notes directory populated with bugs.md, decisions.md, key_facts.md, and issues.md, alongside updated CLAUDE.md and AGENTS.md guidance.

Why does my AI coding assistant keep suggesting conflicting architectural changes?

AI coding assistants suggest conflicting changes when they lack project-specific context across sessions. Centralizing institutional knowledge in structured memory files provides a consistent source of truth for agents to consult before making modifications.

Can I use project memory files to track recurring bug fixes for my code repository?

Yes, you can track recurring bug fixes for code repositories by logging them in the bugs.md memory file. AI tools can then search this file to apply known fixes when a recurring error appears instead of repeating the debugging process.

What is the best way to record architectural decisions for AI-assisted development workflows?

The best way to record architectural decisions for AI-assisted development workflows is using ADR templates within a centralized decisions.md file, ensuring both human teams and AI agents consult a consistent source of truth before making code changes.

Does storing project facts in memory files risk exposing sensitive secrets?

Storing project facts in memory files does not expose secrets when following provided guidance to avoid storing sensitive data. The templates include specific protocols to ensure only non-sensitive project facts and architectural decisions are recorded.