From 880f7193365a7150c8420820b15a08aab7fc7c0b Mon Sep 17 00:00:00 2001
From: SwEdryG <swedryg@mail.ru>
Date: Mon, 3 Aug 2026 22:12:08 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d395a39..d70cba8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,50 @@
-# TracePad
\ No newline at end of file
+# TracePad
+
+Пошаговый регистровый отладчик для чтения ассемблера.
+
+---
+
+## Описание
+
+TracePad — это инструмент для ручной трассировки выполнения кода на ассемблере. Позволяет пошагово записывать состояние регистров, добавлять комментарии и отслеживать изменения состояния системы. Применяется при изучении кода, дизассемблировании бинарных файлов и написании эксплойтов. Не автоматизирует анализ, а помогает структурировать наблюдения.
+
+---
+
+## Возможности
+
+- Запись значений регистров: RAX, RBX, RCX, RDX, RSI, RDI, RBP, RSP, RIP, R8–R15.
+- Добавление комментариев к каждому шагу.
+- Сохранение сессии в JSON.
+- Загрузка ранее сохранённых сессий.
+- Редактирование и удаление шагов.
+
+---
+
+## Технологии
+
+- .NET 10
+- WPF
+- JSON
+
+---
+
+## Использование
+
+1. Откройте бинарный файл в дизассемблере (Ghidra, IDA, x64dbg).
+2. Начните анализ кода по шагам.
+3. В TracePad фиксируйте состояние регистров на каждом шаге.
+4. Добавляйте комментарии для сохранения логики.
+5. Сохраните сессию для дальнейшего использования.
+
+---
+
+## Планы
+
+- Подсветка изменённых регистров
+- Экспорт в Markdown / PDF
+
+---
+
+## Почему не автоматизация?
+
+TracePad не выполняет анализ за пользователя. Это цифровой блокнот для осмысленного обучения через запись, а не через автоматическое выполнение.