lesson_learned — правило для Claude Code: что делает и как установить
Правило lesson_learned напоминает сверять длину строковых констант с размером полей сетевого протокола. Пригодится при изменении Go-кода, где заголовки сообщений используют фиксированные буферы.
MIT ★ 336 обновлён 2026-04-09
.claude/rules/LESSON_LEARNED.mdЧто делает lesson_learned
Правило разбирает сбой в Stowaway: после изменения длины идентификаторов соединение устанавливалось, но обмен сообщениями ломался. Причина — поля заголовка читались как буферы фиксированного размера, поэтому строки другой длины нарушали разбор протокола.
Перед изменением констант правило предлагает искать фиксированные размеры буферов и срезов, проверять места использования значений и тестировать обмен данными на клиенте и сервере. Оно также различает обычные строки и значения, встроенные в протокол: для последних важны требования к длине, а для magic bytes — ещё и к самому значению. Несовпадение длины может обрывать соединение после успешной аутентификации.
Для установки в Claude Code поместите файл правила в .claude/rules/LESSON_LEARNED.md. Правило описывает проверку протокольных констант на примере Go; оно не заменяет тестирование конкретной реализации.
Какие задачи решает
- проверить, не нарушает ли новая константа размер поля протокола
- найти фиксированные размеры буферов и срезов в Go-коде
- сопоставить использование идентификатора с чтением заголовка
- проверить обмен сообщениями после изменения протокольных значений
Примеры запросов агенту
- Проверь, совпадает ли длина новых строковых констант с фиксированными полями протокола.
- Найди в Go-коде места, где размер буфера ограничивает чтение идентификаторов.
- Составь проверки обмена данными для клиента и сервера после изменения констант протокола.
Как установить lesson_learned
Вручную: положить файлы
.claude/rules/LESSON_LEARNED.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/LESSON_LEARNED.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/LESSON_LEARNED.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/LESSON_LEARNED.mdВручную: положить файлы
.clinerules/LESSON_LEARNED.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о lesson_learned
Как установить lesson_learned в Claude Code?
Добавьте файл правила в .claude/rules/LESSON_LEARNED.md.
Что делает lesson_learned?
Правило объясняет, почему изменение длины протокольной константы может нарушить разбор заголовка и оборвать соединение. Оно предлагает сверять фиксированные размеры и проверять обмен сообщениями.
Почему длина строковой константы важна для сетевого протокола?
Если код читает поле в буфер фиксированного размера, строка другой длины может сместить или нарушить разбор данных. Для magic bytes правило требует сохранять и длину, и значение.
Исходный текст
LESSON_LEARNED.md · MIT
# Evasion Lesson Learned: Fixed-Length Protocol Fields ## Incident Date 2026-04-09 ## Tool Stowaway (Go-based multi-hop proxy) ## Problem Description During source code modification to evade detection, we changed protocol identifier constants: **Original values:** ```go const ADMIN_UUID = "IAMADMINXD" // 10 characters const TEMP_UUID = "IAMNEWHERE" // 10 characters const TEMP_ROUTE = "THEREISNOROUTE" // 14 characters ``` **Modified values (WRONG):** ```go const ADMIN_UUID = "NODE-CTRL-01" // 12 characters ❌ const TEMP_UUID = "NODE-JOIN-00" // 12 characters ❌ const TEMP_ROUTE = "EMPTY-ROUTE-00" // 15 characters ❌ ``` ## Root Cause The protocol uses **fixed-length fields** in message headers. The code reads exactly 10 bytes for UUID fields: ```go // protocol/raw.go senderBuf := make([]byte, 10) // Fixed 10 bytes for UUID accepterBuf := make([]byte, 10) // Fixed 10 bytes for UUID ``` Changing the UUID length from 10 to 12 characters caused: 1. Message header parsing to read wrong bytes 2. Protocol deserialization failure 3. Connection established but immediately dropped with "connection reset by peer" ## Symptom - Connection was established successfully - Authentication passed - But control panel showed no response - Error message: `read tcp: connection reset by peer` ## Correct Fix ```go const ADMIN_UUID = "CTRL-00001" // 10 characters ✅ const TEMP_UUID = "JOIN-00001" // 10 characters ✅ const TEMP_ROUTE = "NOROUTE00000" // 14 characters ✅ ``` ## Key Lessons ### 1. Always Check Fixed-Length Protocol Fields Before modifying any string constants in networked applications: 1. Search for `make([]byte, N)` where N is a fixed number 2. Search for hardcoded slice lengths like `[:10]`, `[:14]` 3. Check if string constants are used in binary protocols ```bash # Find potential fixed-length reads grep -rn "make(\[\]byte" --include="*.go" grep -rn "\[:10\]" --include="*.go" ``` ### 2. Common Fixed-Length Patterns | Pattern | Description | |---------|-------------| | UUID fields | Often fixed 10-36 bytes | | Message types | Often fixed 1-4 bytes | | Length prefixes | Often 2-4 bytes | | Magic bytes | Often 4-8 bytes | | Route/Path fields | May have fixed max length | ### 3. Verification Checklist After modifying protocol-related constants: - [ ] Count character length of new value - [ ] Compare with original value length - [ ] Search for hardcoded byte lengths in code - [ ] Test connection establishment - [ ] Test message exchange - [ ] Check both client and server side ### 4. Code Review Pattern ```go // DANGEROUS - Length changed const ADMIN_UUID = "NODE-CTRL-01" // Was 10, now 12 // Safe modification approach: // 1. Find all usages grep -rn "ADMIN_UUID" --include="*.go" // 2. Check for fixed-length reads grep -rn "make(\[\]byte.*10)" --include="*.go" // Matches old length // 3. Verify protocol structure // Look for: senderBuf, accepterBuf, UUIDLen fields ``` ## Prevention Rules ### Rule 1: Length Preservation When modifying string constants in network protocols: - **ALWAYS** maintain the exact same character length - **NEVER** assume variable-length handling ### Rule 2: Binary Protocol Analysis For Go/C/C++ network tools: 1. Look for `binary.Read()` / `binary.Write()` 2. Look for `io.ReadFull()` with fixed buffer sizes 3. Look for struct tags like `` `len:"10"` `` ### Rule 3: Test Connection First After modification: 1. Test basic connection establishment 2. Test authentication handshake 3. Test data exchange 4. Only then proceed with full testing ### Rule 4: Protocol Constants Are Special String constants used in protocols are **NOT** like regular strings: - Log messages → Can change freely - Protocol identifiers → MUST maintain length - Magic bytes → MUST maintain exact value AND length ## Files to Update Update the following skill documents: - `tools_evasion/source_modify.md` - Add fixed-length field warning - `tools_evasion/rule_analysis.md` - Add protocol field analysis section ## Related Detection Rules This issue does NOT affect YARA detection since the strings are embedded in binary anyway. The length change was purely a functional bug, not a detection issue. ## Conclusion **When modifying network tools, always check for fixed-length protocol fields before changing string constants.**
© JDArmy · MIT · JDArmy/Evasion-SubAgents