cs-keep

Persists evidence-backed project lessons and facts into canonical memory locations.

1.1k|83|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/liuzhengdongfortest/easysdd --skill cs-keep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cs-keep
Source: https://github.com/liuzhengdongfortest/easysdd/tree/main/plugins/codestable/skills/cs-keep
Command: npx skills add https://github.com/liuzhengdongfortest/easysdd --skill cs-keep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Valuable lessons learned during AI-assisted coding sessions are usually lost when the session ends, forcing teams to rediscover the same pitfalls repeatedly. This Skill captures evidence-backed findings and routes each one to its single canonical owner so knowledge survives across sessions.

Core Features & Use Cases

  • Canonical routing: Directs each finding to the right destination—mechanical guards (tests, linters), attention.md for high-frequency facts, ADRs for structural decisions, existing project docs, or dated lesson files under .codestable/lessons/.
  • Lesson lifecycle management: Tracks lessons through observed, validated, and retired statuses with strict promotion rules requiring independent verification, preventing self-certified or stale knowledge.
  • Write discipline and deduplication: Enforces a roughly 50-lesson budget, merges duplicates, treats legacy compound/ knowledge as read-only, and requires explicit user authorization before writing.
  • Use Case: After debugging a tricky test-flakiness issue, tell the agent to remember the root cause; it verifies the evidence, checks for duplicates, and writes a scoped lesson file that future sessions can grep and apply.

Quick Start

Ask the agent to remember the lesson or pitfall you just discovered in this session, and it will verify the evidence and store it in the appropriate project memory location.

Frequently Asked Questions about cs-keep

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

FAQPage Schema
How do I save lessons learned during an AI coding session?

Tell the agent to remember the finding, and cs-keep verifies the evidence, checks for duplicates, and writes a dated lesson file under .codestable/lessons/ with scope, applicability boundaries, and up to three evidence pointers.

How does cs-keep decide where to store project knowledge?

It routes by single canonical owner: mechanical guards like tests or linters first, then attention.md for high-frequency facts, ADRs for hard-to-reverse structural decisions, existing project docs for stable methods, and lesson files as staging for everything else.

Can cs-keep write lessons without user approval?

No. Writing requires explicit authorization such as a user asking to remember something or approving a crystallization candidate. New rules, scope changes, promotions, deletions, and cross-project sharing all need separate explicit consent.

How do I retrieve saved lessons in later sessions?

Search with grep -ri over .codestable/lessons/ and .codestable/compound/ using relevant keywords. Before applying a lesson, verify it against current code, tests, or canonical docs, and never apply retired entries.

What are the limitations of the lesson lifecycle statuses?

Lessons start as observed and can only become validated when an independent later task applies them successfully; a lesson cannot validate itself. Retired lessons are never revived—new conclusions require a fresh observed lesson.