knowledge-maintenance

Routes stable facts and preferences into AGENTS.md files and workspace memory topics.

2.1k|278|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/proma-ai/Proma --skill knowledge-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: knowledge-maintenance
Source: https://github.com/proma-ai/Proma/tree/main/apps/electron/default-skills/knowledge-maintenance
Command: npx skills add https://github.com/proma-ai/Proma --skill knowledge-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running AI collaboration loses context: agents forget user preferences, repeat mistakes, and re-explore project structure every session. This Skill maintains a durable knowledge layer so stable facts, decisions, and corrections persist across conversations.

Core Features & Use Cases

  • Fact Routing: Directs each piece of knowledge to the right location—project root AGENTS.md for architecture and commands, workspace AGENTS.md for environment facts, memory/ topic files for user preferences and lessons, or Skills for repeatable procedures.
  • Memory Organization: Maintains MEMORY.md as a topic index, splits overloaded topic files, merges duplicate conclusions, and preserves time context on time-sensitive facts.
  • Conservative Write Policy: Writes only stable, verified increments directly; asks for confirmation before deletions, large overwrites, uncertain inferences, or sensitive personal data.
  • Use Case: After a user corrects the agent twice about preferring pnpm over npm, the Skill records the preference in the workspace memory collaboration topic and updates the project AGENTS.md install command, so future sessions apply it automatically.

Quick Start

Ask the agent to remember a stable preference or project fact, for example: remember that this project uses pnpm and always run tests with pnpm test before committing.

Frequently Asked Questions about knowledge-maintenance

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

FAQPage Schema
How do I make an AI agent remember my preferences across sessions?

State the preference explicitly, such as saying remember that I prefer pnpm. The Skill writes stable preferences into workspace memory topic files indexed by MEMORY.md, so future sessions load them automatically without re-explaining.

What is the difference between AGENTS.md and memory files?

Project root AGENTS.md stores project facts like architecture, commands, and verification steps, while workspace memory files store user profiles, collaboration preferences, lessons, and decision rationale. Facts are routed to one location and never duplicated.

When does the skill ask for confirmation before writing memory?

Confirmation is required only for deletions, large overwrites of existing content, conflicting information, uncertain inferences from single events, or potentially sensitive personal data. Clear, stable, non-conflicting increments are written directly.

Can the agent read my past chat history to build memory?

Historical sessions are read only after explicit user authorization. The agent then selects at most three high-signal sessions by metadata, reads only relevant portions, and stops once sufficient evidence is gathered.

What should not be written into long-term memory?

Session logs, one-off task states, unverified inferences, and empty placeholder topics should not be persisted. Only stable facts that will affect future judgment belong in long-term knowledge; temporary state stays in the session workbench.