p-backlog 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -1,10 +1,14 @@
 # Changelog
 
+## 0.2.4
+
+- A clearer description on npm and GitHub, and a rewritten README introduction: out-of-scope fixes stay out of pull requests, audit findings don't get lost, tasks keep the context the agent needs. No code changes.
+
 ## 0.2.3
 
 - README: screenshots of the task list, a task card and statistics (English UI in README.md, Russian UI in README.ru.md), generated from fictional demo data with `npm run screenshots`. No code changes.
 
-## 0.2.2 (not published to npm; its changes ship in 0.2.3)
+## 0.2.2
 
 - README: npm, CI, Node and license badges; a section on using p-backlog together with code-review-graph (re-check by symbol). No code changes.
 

package/README.md

@@ -4,14 +4,28 @@
 
 **[Русская версия](README.ru.md)**
 
-A task backlog that lives as markdown files: an AI agent creates them while working on code, and a human
-triages them in a local web app.
-
-- **`backlog` CLI** — creates tasks, takes them into progress, changes their status.
-- **`backlog` skill** for Claude Code — tells the agent when and how to call the CLI.
-- **Web app** — project list, search, filters, epics, links, progress; doesn't create tasks.
-- **Backlog hygiene** — the agent re-checks tasks whose code changed and closes the ones no longer needed;
-  closed tasks are deleted after 7 days.
+**Keep pull requests clean. Never lose an audit finding.**
+
+A personal backlog for Claude Code that lives next to your code as Markdown files. When the agent notices a problem
+outside the task at hand, it doesn't slip a fix into your pull request — it files a task with the file, the line and
+what will break. Findings from audits and code reviews become tasks too, instead of getting lost in chat history.
+
+- **Clean pull requests.** Out-of-scope fixes go to the backlog, not into the diff you review. The Effect tab in
+  statistics shows how many lines stayed out of your pull requests.
+- **Nothing gets lost.** Every finding from an audit or a review is a task with its source (`file:line`), what it
+  risks and a checklist.
+- **Context kept, tokens saved.** A task stores the context the agent needs to pick it up later. On a re-check the
+  agent gets the task's summary, the current code around its line and the diff since the last check — usually
+  enough to decide without re-reading the codebase.
+- **Stays current by itself.** A Stop hook asks the agent to re-check tasks whose code changed. The agent closes
+  fixed ones with the commit as evidence; line numbers follow the code as it moves. Closed tasks are cleaned up
+  after 7 days.
+- **Local and autonomous.** Plain files in `~/backlog`, no account, no cloud. The agent drives it through the skill,
+  so you don't have to touch the CLI — though you can.
+- **Charts when you want them.** Start the local web app to browse and triage tasks and follow the metrics: debt by
+  week, where it hurts in the code, how accurate the checks are, what the hook costs in tokens.
+
+It consists of the `backlog` CLI, the `backlog` skill and a Stop hook for Claude Code, and an optional web app.
 
 ## Screenshots
 

package/README.ru.md

@@ -4,14 +4,27 @@
 
 **[English version](README.md)**
 
-Беклог задач, который живёт markdown-файлами: их создаёт ИИ-агент во время работы над кодом, а человек
-разбирает в локальном веб-приложении.
-
-- **CLI `backlog`** — создаёт задачи, берёт их в работу, меняет статусы.
-- **Скилл `backlog`** для Claude Code — объясняет агенту, когда и как звать CLI.
-- **Веб-приложение** — список проектов, поиск, фильтры, эпики, связи, прогресс; задачи не создаёт.
-- **Порядок в беклоге** — агент перепроверяет задачи, чей код изменился, и закрывает ненужные; закрытые
-  задачи удаляются через 7 дней.
+**Чистые пулреквесты. Находки аудитов не теряются.**
+
+Личный беклог для Claude Code, который живёт рядом с кодом markdown-файлами. Когда агент замечает проблему вне
+текущей задачи, он не протаскивает правку в ваш пулреквест, а заводит задачу: файл, строка и чем это грозит.
+Находки аудитов и ревью тоже становятся задачами, а не теряются в истории чата.
+
+- **Чистые пулреквесты.** Посторонние правки уходят в беклог, а не в дифф, который вы ревьюите. Вкладка «Эффект»
+  в статистике показывает, сколько строк не попало в пулреквесты.
+- **Ничего не теряется.** Каждая находка аудита или ревью — задача с источником (`файл:строка`), описанием риска
+  и чеклистом.
+- **Контекст сохранён, токены сэкономлены.** Задача хранит контекст, который нужен агенту, чтобы потом взять её
+  в работу. При перепроверке агент получает суть задачи, текущий код вокруг её строки и изменения с прошлой
+  проверки — обычно этого хватает, чтобы решить, не перечитывая кодовую базу.
+- **Сам следит за актуальностью.** Stop-хук просит агента перепроверить задачи, чей код изменился. Агент закрывает
+  исправленные со ссылкой на коммит, номера строк следуют за кодом. Закрытые задачи удаляются через 7 дней.
+- **Локальный и автономный.** Обычные файлы в `~/backlog`, без аккаунта и облака. Агент работает с ним через
+  скилл, так что трогать CLI не обязательно — но можно.
+- **Графики — когда нужны.** Поднимите локальное веб-приложение, чтобы просматривать и разбирать задачи и следить
+  за метриками: долг по неделям, где болит в коде, насколько точны проверки, во что обходится хук в токенах.
+
+Состоит из CLI `backlog`, скилла `backlog` и Stop-хука для Claude Code и веб-приложения по желанию.
 
 ## Скриншоты
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "p-backlog",
-  "version": "0.2.3",
-  "description": "Personal developer backlog for Claude Code: tasks as Markdown files, CLI, Stop hook and a local web UI",
+  "version": "0.2.4",
+  "description": "Keep pull requests clean and audit findings safe: a local, autonomous backlog for Claude Code. The agent files out-of-scope issues as Markdown tasks with context and re-checks them as code changes. Optional web UI with metrics.",
   "keywords": [
     "claude-code",
     "claude",