Skip to content

v0.6.0 — Conventions + Lessons memory

Choose a tag to compare

@Karthick-Ramachandran Karthick-Ramachandran released this 23 Jun 16:22
a08ff5e

Two new architecture-neutral memory docs the agent maintains itself — so memory stays useful even on pure vibe-coded projects. Learned from a high-quality Figma-MCP setup: named vocabulary + durable lessons are what drive output quality.

npx persist-os@latest init

New

  • docs/60-engineering/CONVENTIONS.md — your canonical, reusable vocabulary (named primitives, naming, falsifiable rules, anti-patterns). The agent reuses what it names instead of reinventing, and records new primitives there. persist doctor nudges it to be filled once the repo has real work; the new conventions-adherence skill reviews a change for reuse-over-reinvent.
  • docs/60-engineering/LESSONS.md — durable, hard-won pitfalls so the same mistake isn't rediscovered next session. No doctor check by design (empty is valid).
  • Both load into every agent session, and AGENTS.md + the Cursor rule instruct the agent to keep them current itself — the human just reviews edits in the PR.

Improved

  • AGENTS.md restructured into a lean, front-loaded imperative Rules block (≈30% smaller); the Cursor rule mirrors it instead of duplicating. Fewer, sharper, more-followed instructions.
  • Review skills (security / drift / conventions) now review with fresh, independent context.

Verified

typecheck · lint · format · build · 290/290 tests · persist doctor PASSED. Live-tested end-to-end: the loaded memory demonstrably changes agent behavior (reuse over reinvent).

Local-first: no network, no telemetry, no AI calls.