project-memory

Stores and retrieves project rules and constraints via an MCP memory server.

6|Updated May 18, 2026
One-click install
npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill project-memory-mokhtarabadi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-memory
Source: https://github.com/mokhtarabadi/cognitive-lead-hq/tree/main/skill-templates/project-memory
Command: npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill project-memory-mokhtarabadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents forget project-specific rules, architectural decisions, and test commands between sessions, forcing managers to repeat constraints and causing hallucinated violations of established conventions. ## Core Features & Use Cases - Persistent Memory Storage: Saves Manager-stated rules and constraints into logical namespaces (testing, database, deployment) using the store_memory MCP tool. - Proactive Context Retrieval: Searches and injects relevant memories at the start of every implementation task during the Context Phase. - Supersession & Safe Deletion: Detects outdated rules via search_memory, auto-supersedes same-topic entries, and requires explicit Manager approval before other deletions. - Auto-Generated Memory Index: Maintains a Markdown index at .opencode/memory/index.md for compact two-step retrieval without loading all memories. - Use Case: When a Manager says "never use Prisma push in this project", the skill stores it under the database namespace and retrieves it automatically before any future migration task. ## Quick Start Tell the agent to remember that this project always uses Jest with the --runInBand flag, and it will store the rule and recall it in future testing tasks.

Frequently Asked Questions about project-memory

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

FAQPage Schema
How do I give an AI coding agent persistent memory across sessions?▼

Use an MCP memory server with store_memory to save rules under logical namespaces and keys. The agent then calls search_memory or read_memory at the start of each task to retrieve relevant constraints before acting.

How to prevent AI agents from forgetting project rules?▼

Store each Manager-stated rule with a namespace and snake_case key via store_memory, then retrieve domain-relevant memories during the Context Phase of every task. A generated index file lets the agent scan topics without loading all memories.

What is the memory index file in .opencode/memory?▼

It is an auto-generated Markdown table of all memory shards with namespace, key, summary, and tags. It is rebuilt atomically after every store or delete operation and should never be edited manually.

Can the agent delete stored memories automatically?▼

Only during store-time supersession within the same namespace and key topic, where the old entry is deleted before storing its replacement. All other deletions require explicit Manager confirmation before calling delete_memory.

When should project memories be retrieved during a task?▼

Retrieval happens at the start of every implementation task during the Context Phase. The agent identifies the task domain, searches memory with related keywords, and injects matching constraints into its reasoning.