kunchenguid/backpass

Обратный пас

Градиентный спуск для памяти вашего агента.

В этом блоге объясняется почему и как.

backpass помогает вам улучшить ваши AGENTS.md, CLAUDE.md и навыки с научной строгостью. Он находит сессии агентов, которые действительно проходили в вашем репозиториу, читает что произошло в них, и предлагает подкрепленные доказательствами правки на поверхности памяти — Навыки работы с файлами памяти и проектами — в рамках токен-бюджета, ограниченного вами.

• Local-first — читает хранилища транскриптов семи агентных жгутов непосредственно с диска, локально или через SSH на ваши собственные компьютеры. Нет API — нет загрузки; транскрипты никогда не покидают ваши устройства. машины, кроме агента, которого вы уже аутентифицировали, а очевидные секреты скрыты прежде чем они это сделают.
• С доказательствами - Каждое предлагаемое редактирование содержит дословные цитаты из реальных сессий, и каждое изменение add, rewrite или remove требует доказательств как минимум двух разных сессии. Маленькие, шумные, ограниченные шаги — не переписывание.
• Человек в петле - Анализ никогда не пишет. См. Применить — человеческий портал для проверки и явных сценарных решений.

Один забег — это шаг с ограниченным уклоном.

Быстрый старт

Требуется Узел >= 22.5 и acpx на вашем ПУТИ.

backpass

<a href=“https://github.com/kunchenguid/backpass/actions/workflows/ci.yml” > <a href=“https://github.com/kunchenguid/backpass/actions/workflows/release-please.yml” > <a href=“https://www.npmjs.com/package/backpass” > <a href=“https://img.shields.io/badge/platform-macOS | Linux-blue?style=flat-square” > <a href=“https://x.com/kunchenguid” > <a href=“https://discord.gg/Wsy2NpnZDu” >

Gradient descent for your agent memory.

This blog post explains the why and how.

backpass helps you improve your AGENTS.md, CLAUDE.md and skills with scientific rigor. It finds the agent sessions that actually ran in your repo, reads what happened in them, and proposes evidence-backed edits to your memory surface - the memory file and project skills - under a token budget, gated by you.

• Local-first - Reads the transcript stores of seven agent harnesses directly from disk, locally or over SSH to your own machines. No API, no upload; transcripts never leave your machines except into an agent you already authenticated, and obvious secrets are redacted before they do.
• Evidence-gated - Every proposed edit carries verbatim quotes from real sessions, and every add, rewrite, or remove edit needs evidence from at least two distinct sessions. Small, noisy, bounded steps - not a rewrite.
• Human in the loop - Analysis never writes. See Apply - the human gate for review and explicit scripted decisions.

AGENTS.md / CLAUDE.md + skills (the weights)
  → agent session               (forward pass)
  → transcript on disk          (loss signal)
  → backpass: collect samples, distill, calculate loss, aggregate gradients
  → backpass: gradient descent  (diffs + skill extractions)
  → you accept or reject        (the human gate)
  → back to the weights

One run is one bounded gradient step.

Quick Start

npm install -g backpass
# or run it without installing
npx backpass

Requires Node >= 22.5 and acpx on your PATH.