ingest: your-agent-has-12-blind-spots-you

2026-05-18 14:33:09 +03:00
parent af273dcbb7
commit 5e5bcac820
2 changed files with 271 additions and 0 deletions
@@ -0,0 +1,102 @@
+---
+title: "Агент — это 80% сантехники: 12 инфраструктурных примитивов"
+slug: your-agent-has-12-blind-spots-you
+source: https://natesnewsletter.substack.com/p/your-agent-has-12-blind-spots-you
+author: Nate Jones
+published: 2026-04-03
+processed: 2026-05-18
+type: video
+themes:
+  - "[[Agentic Workflow]]"
+  - "[[Implementation Layer]]"
+  - "[[Harness]]"
+  - "[[Audit Trails]]"
+  - "[[Workflow Completion]]"
+frameworks:
+  - "[[Implementation Fabric]]"
+  - "[[Evals]]"
+  - "[[Moat]]"
+terminology:
+  - "[[Harness]]"
+  - "[[Agentic Workflow]]"
+  - "[[Implementation Layer]]"
+  - "[[Audit Trails]]"
+  - "[[Evals]]"
+  - "[[Workflow Completion]]"
+---
+
+# Агент — это 80% сантехники: 12 инфраструктурных примитивов
+
+## Контекст
+
+Anthropic случайно опубликовал полный исходный код Claude Code: 1 902 файла, 512 000+ строк, 29 подсистем. Утечка произошла из-за не исключённого source map файла в npm-пакете. Nate Jones проанализировал не фичи (Тамагочи, голосовой режим, 44 флага), а инфраструктуру под ними.
+
+## Главный тезис
+
+> "The LLM call is maybe 20% of Claude Code. The other 80% is plumbing."
+> *LLM-вызов — это примерно 20% Claude Code. Остальные 80% — это сантехника.*
+
+Туториалы по агентам останавливаются на стадии демо: настроить промпт, подключить инструменты, задеплоить. В продакшене это ломается — сессии не переживают краши, инструменты работают без разрешений, контекстные окна переполняются, затраты растут, диагностировать нечем.
+
+## 12 инфраструктурных примитивов
+
+Полный список за пейволлом. Из доступного:
+
+| # | Примитив (EN) | Описание |
+|---|---|---|
+| 1 | Session Persistence | Сохранение состояния сессии между перезапусками |
+| 2 | Permission Pipelines | Конвейер разрешений до выполнения инструмента |
+| 3 | Context Budget Management | Управление бюджетом контекстного окна |
+| 4 | Tool Registries | Реестр инструментов с метаданными |
+| 5 | Security Stacks | 18-модульный стек безопасности на один shell-вызов |
+| 6 | Error Recovery | Восстановление после сбоев |
+| 7–12 | — | TBD (за пейволлом) |
+
+> Открытый вопрос: какие из 7–12 примитивов относятся к observability и cost control — именно эти зоны наиболее болезненны для наших клиентов?
+
+## Ключевые наблюдения
+
+**Мета-урок об утечке.** Скорость разработки с AI-помощью опережает операционную дисциплину, которая должна её контролировать. Это структурная проблема отрасли, не разовый инцидент.
+
+**Переносимость паттернов.** В течение нескольких часов после утечки разработчики портировали весь [[Harness]] на Python и Rust. Вывод: эти паттерны не специфичны для Anthropic — они являются структурными требованиями для любого агента, работающего в продакшене.
+
+**Приоритизация по времени.** Примитивы организованы не по порядку появления в коде, а по очерёдности внедрения: day one → week one → month one.
+
+## Терминология
+
+| Термин (RU) | EN | Пояснение |
+|---|---|---|
+| Сантехника агента | Agent Plumbing | Вся инфраструктура вокруг LLM-вызова |
+| Конвейер разрешений | Permission Pipeline | Проверка прав до выполнения инструмента |
+| Бюджет контекста | Context Budget | Лимит токенов и стратегия его управления |
+| Реестр инструментов | [[Harness]] / Tool Registry | Каталог доступных инструментов агента |
+| Стек безопасности | Security Stack | Многоуровневая проверка shell-команд |
+| Аудит архитектуры | Architecture Audit | Gap-анализ агента против 12 примитивов |
+
+## Инструменты из статьи
+
+- **Промпт для аудита архитектуры** — интервьюирует вас о системе и возвращает gap-анализ против 12 примитивов
+- **Skill-пакет** — для Claude Code и OpenAI Codex: читает кодовую базу и указывает на отсутствующие примитивы
+
+Оба инструмента за пейволлом.
+
+## Что использовать для нашего портфеля
+
+**Позиционирование.** Тезис "80% — сантехника" прямо подтверждает нашу роль как [[Implementation Layer]]: клиент покупает LLM-доступ (20%), а мы строим остальное (80%). Это конкретный аргумент для продаж вместо абстрактного "мы строим агентов".
+
+**Gap-анализ как точка входа.** 12 примитивов дают готовый чеклист для первого разговора с клиентом. Вопрос "сколько из 12 у вас есть?" диагностирует зрелость и открывает [[Implementation Fabric]] как решение.
+
+**[[Forward Deployed Engineer]] как канал (PE).** PE-портфельные компании строят агентов без инфраструктуры — они на стадии "demo works, prod breaks". Утечка Claude Code создала образовательный момент: можно показать, что именно отсутствует, без лекции с нуля.
+
+**[[Evals]] как продолжение.** После внедрения примитивов естественный следующий шаг — оценка качества агента. Это наша [[Moat]]-зона: клиент не может уйти, не взяв с собой накопленные эталоны.
+
+**[[Audit Trails]] как compliance-аргумент.** 18-модульный стек безопасности на один shell-вызов — это язык, понятный юридическим и compliance-командам в [[Systems of Record]]-контекстах (ERP, CRM). Конкретные числа снимают абстрактность разговора о безопасности агентов.
+
+## Связанные заметки
+
+- [[Agentic Workflow]]
+- [[Implementation Layer]]
+- [[Harness]]
+- [[Workflow Completion]]
+- [[Audit Trails]]
+- [[Evals]]