record-project-memory

Record durable engineering lessons into a project-specific memory file.

Updated Jan 6, 2023
One-click install
npx skills add https://github.com/pekral/phpstan-rules --skill record-project-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: record-project-memory
Source: https://github.com/pekral/phpstan-rules/tree/main/.claude/skills/record-project-memory
Command: npx skills add https://github.com/pekral/phpstan-rules --skill record-project-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of losing valuable engineering insights and architectural decisions by providing a structured, curated way to record lessons learned during development tasks.

Core Features & Use Cases

  • Promotion Bar: Ensures only high-value, non-obvious, and reusable lessons are recorded, preventing the accumulation of trivial information.
  • Curation Pass: Automatically deduplicates, supersedes, and prunes entries to keep the project memory file clean and relevant.
  • Use Case: After resolving a complex bug or completing a code review, use this skill to distill the core architectural lesson into the project memory file for future reference by the team.

Quick Start

Use the record-project-memory skill to document the architectural decision made during the recent refactoring task.

Frequently Asked Questions about record-project-memory

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

FAQPage Schema
How do I document architectural decisions and engineering lessons learned during a refactoring task?

To document architectural decisions, the Skill extracts high-value insights from converged task contexts and appends them into a structured project memory file. It enforces a promotion bar to ensure only reusable, non-obvious engineering lessons are recorded for future team reference.

What is the best way to maintain a project memory file without accumulating trivial development notes?

Maintaining a project memory file requires a curation pass that automatically deduplicates, supersedes, and prunes entries. This approach enforces strict promotion criteria to filter out trivial information, keeping your engineering knowledge base clean and focused on durable architectural insights.

When should I record engineering insights into my project knowledge management workflow?

You should record engineering insights after task convergence, specifically when a development task yields high-value, non-obvious lessons. Capturing durable architectural decisions at this stage ensures the knowledge is mature, validated, and genuinely reusable before entering the project memory file.

Does this project memory recording approach handle sensitive data or PII from development contexts?

No, the project memory recording process strictly prohibits the inclusion of sensitive data or PII. It focuses exclusively on extracting durable engineering lessons and architectural best practices, ensuring your knowledge management workflow remains compliant and secure.

Can I use this automated curation process with my existing project-specific documentation conventions?

Yes, the curation process requires adherence to your existing project-specific memory file conventions. It operates within your established documentation structure to append, deduplicate, and supersede engineering lessons without disrupting your current knowledge management format.

Why does my project knowledge base keep retaining obsolete engineering best practices after refactoring?

Retaining obsolete practices happens without a curation pass to supersede and prune outdated entries. The Skill automatically evaluates converged task contexts to replace or remove superseded architectural lessons, ensuring your project memory file retains only currently relevant engineering best practices.