AI Coding Skill Library with Built‑In Memory and Self‑Learning

Memory Feature: Persistent Project Context

AI sessions lose project background, requiring repeated explanations. The solution stores stable facts and current state in a directory .superpowers-memory/ with files: PROJECT_CONTEXT.md – immutable facts such as project purpose, module boundaries, non‑negotiable constraints, long‑term collaboration agreements, and known restrictions. CURRENT_STATE.md – work‑in‑progress information: ongoing tasks, recent decisions, open questions, and next‑step recommendations. session-journal/ – brief records for each important conversation, noting changes, rationale, validation results, and the plan for the next session. LEARNING_BACKLOG.md – candidate pool for reusable methods.

Keeping this information in the repository makes context visible to all contributors, supports hand‑off, and avoids reliance on a personal chat window.

Self‑Learning Workflow

The workflow superpowers-learning-workflow runs after a delivery‑oriented task finishes and performs a structured reflection:

Review the completed work.

Identify concrete lessons learned.

Classify the experience.

Write the distilled knowledge back into the memory files.

Store reusable methods in LEARNING_BACKLOG.md for later promotion to a workflow, checklist, skill definition, or repository policy.

Combined Rhythm

A three‑step rhythm for ongoing projects:

Execute a delivery‑oriented workflow (requirements, design, implementation, testing, verification).

Run superpowers-learning-workflow to reflect on the work.

Update .superpowers-memory/ files with stable facts, current state, session conclusions, and reusable experience.

This ensures the next AI session knows both the project’s current position and the newly captured lessons.

Explicit Enablement

All added abilities are opt‑in; installing the skill library does not automatically activate memory or learning. The features run only when explicitly configured and invoked, preventing unintended modifications.

Repository: https://github.com/SYZ-Coder/superpowers-openspec-team-skills