К основному содержанию
правило CX Codex

lesson_learned — правило для Claude Code: что делает и как установить

Правило lesson_learned напоминает сверять длину строковых констант с размером полей сетевого протокола. Пригодится при изменении Go-кода, где заголовки сообщений используют фиксированные буферы.

MIT ★ 336 обновлён 2026-04-09

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/LESSON_LEARNED.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Каталог правил IDE →
lesson-learned softaworks Скилл lesson-learned разбирает последние изменения в git-истории и формулирует инженерные уроки на основе реального кода. Пригодится, чтобы извлечь полезный опыт из недавних коммитов или рабочей ветки. CX Codex +1 3 000установок learned gasserane Скилл learned опрашивает пользователя по четырём пунктам после сдачи задачи и дописывает выводы в журнал Obsidian. Помогает сохранить свежий опыт без долгой рефлексии. CX Codex +1 555установок lesson rohitg00 Скилл lesson для Claude Code сохраняет исправления и рабочие правила как уроки с уровнем уверенности и напоминает о них перед похожей задачей. Фиксирует повторяющиеся ошибки. CX Codex +1 4 800установок k2f-lesson-plan suzheng Скилл k2f-lesson-plan для Claude Code собирает план урока с привязкой к стандарту, раздаточными материалами и сеткой наблюдения. Превращает заметки учителя или тему в пакет документов для занятия. CX Codex +1 2 800установок lesson-screen rohitg00 Скилл lesson-screen для Claude Code открывает экран урока в браузере рядом с терминалом. Показывает схемы, трассировки кода и вопросы с вариантами ответа. CX Codex +1 699установок lesson-quiz Luong NGUYEN Скилл lesson-quiz проверяет знание одного урока туториала по Claude: 10 вопросов, разбор каждого ответа и список тем на повторение. CX Codex +1 ★ 47 494звёзд репо

Из того же набора22

Весь набор →
rule_mapping Правило rule_mapping для Claude Code анализирует YARA и Sigma сигнатуры AdaptixC2. Помогает оценить, какие из них устарели, при разборе правил обнаружения. CX Codex +1 ★ 336звёзд репо tools_evasion Команда tools_evasion разбирает инструмент для тестирования на проникновение, ищет правила обнаружения и меняет исходный код, чтобы обойти их. Предназначена для авторизованных проверок безопасности. CX Codex +1 ★ 336звёзд репо rule_inventory Правило rule_inventory для Claude с инвентарём детектов SharpHound: три YARA-правила, одно Sigma, разбор паттернов и таблица сложности обхода. CX Codex +1 ★ 336звёзд репо hex_analysis Правило hex_analysis разбирает hex-сигнатуры YARA-правил AdaptixC2: что за инструкции в паттерне, откуда он взялся в коде и какой флаг компилятора сдвигает байты. CX Codex +1 ★ 336звёзд репо behavior_analysis Правило behavior_analysis описывает артефакты запуска SharpHound и уровни риска. В нём собраны данные для анализа детектирования по исходникам, событиям и файлам. CX Codex +1 ★ 336звёзд репо modifications_summary Правило modifications_summary для Claude Code хранит в контексте отчёт о правках AdaptixC2 под YARA: флаги сборки beacon, переименования функций Go-агента и команды проверки. Напоминает, что изменено в репозитории. CX Codex +1 ★ 336звёзд репо behavior_analysis Правило behavior_analysis для Claude Code с полным профилем поведения инструмента Stowaway: сетевые паттерны, артефакты сборки, строковые константы и индикаторы обнаружения. CX Codex +1 ★ 336звёзд репо modifications_summary Правило modifications_summary для Claude задаёт структуру отчёта о доработках инструмента: что изменено в сборке, логах и именах файлов и какие детекты остались. CX Codex +1 ★ 336звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой