Agent Self-Improvement Log

Problem

Coding agents often make mistakes, get corrected, or hit tool and API failures, but those signals usually vanish with the session. scsst writes those events into project-local Markdown files so they can be reviewed, linked, and reused instead of living only in chat history.

How It Works

It initialises a .learnings/ directory in the workspace and maintains three files:

• ERRORS.md for command failures, exceptions, and external tool issues
• LEARNINGS.md for corrections, knowledge gaps, and best practices
• FEATURE_REQUESTS.md for requested capabilities

Each entry gets a stable ID such as ERR-20250115-A3F and can be connected to related entries with See Also. When a learning recurs across tasks, the skill distils it into a short rule and promotes it to CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md. It also supports ingesting Pattern-Key candidates from simplify-and-harden, using Recurrence-Count and a 30-day window to decide whether a pattern should enter long-lived context.

Boundaries

It is useful for engineering memory, local or team-shared, but not for storing sensitive data. Do not record tokens, private keys, environment variables, or full configuration files unless the user explicitly asks. Cross-session sharing and hook reminders should be used only in trusted environments.