Cortex

Personal AI lab на Claude Code. Монорепо где платформа (.claude/) отделена от продуктов (tools/).

⚠️ Это личный монорепо, не продукт и не темплейт. Читать для идей, копировать на свой риск. Многие пути hardcoded под Windows / D:\code\2026\2\cortex / ~/.claude/projects/D--code-2026-2-cortex/.

---

Что внутри

.claude/          → платформа (commands, skills, hooks, agents, templates)
tools/            → 8+ самодостаточных продуктов (steam-sniper, max-transcribe, ...)
scripts/          → утилиты (session-search.py, scan-skills.py, ops.sh)
memory/           → subagents-playbook
docs/             → устойчивые правила (git-flow, python-rules, verify)
runtime/          → gitignored, сырые данные
archive/          → старые контексты

Три слоя контекста

Файл	Где	В git?	Срок жизни
CLAUDE.md	репо	✅	месяцы (правила проекта)
MEMORY.md	~/.claude/projects/.../memory/	❌ per-user	недели (индекс на feedback-файлы)
CURRENT_CONTEXT.md	~/.claude/projects/.../	❌ per-user	дни (активные треки)

Diary тоже в per-user folder — общая для всех worktree (5 параллельных копий ветки), без merge-конфликтов.

Что читать первым

• CLAUDE.md — правила проекта, 126 строк
• docs/learned-the-hard-way.md — concentrated lookup ~50 production recipes (симптом → причина → фикс с командой)
• memory/subagents-playbook.md — hub-and-spoke + per-agent model routing с обоснованием
• .claude/commands/handoff.md — multi-chat handoff с агрегацией
• .claude/templates/recon-report.md — шаблон для исследования внешних репо
• scripts/session-search.py — простой grep по diary/memory с ranking
• scripts/scan-skills.py — read-only skill curator
• tools/steam-sniper/verify.sh — пример domain-specific verification (HTTP/SSH/cron checks)

Стек

• Python 3.12+, uv, pyright (strict), ruff, beartype
• Claude Code CLI (primary), Codex CLI MCP (second opinion), Gemini (digests)
• SQLite, GCP VM, VPS Timeweb

Инструменты (tools/)

Tool	Что делает
steam-sniper	Трекер цен на CS-скины с lis-skins.com, Telegram-алерты
max-transcribe	Транскрипция голосовых из Max через Playwright + whisper
tg-monitor	Daily-дайджесты из Telegram через Gemini / NotebookLM
tg-bridge	Bridge между Telegram-чатами
tg-pharma	Аптечный bot (фарм-ассистент)
metrics	Трекинг эффективности AI-агентов (Jules vs Codex)
kwork-monitor	Мониторинг фриланс-площадки
ui-ux	Заготовка под UI

Как это эволюционирует

Сессия → /diary в per-user folder
       ↓
       Накопление 7+ записей
       ↓
       /reflect → ищет паттерны (нарушения / повторы / анти-паттерны)
       ↓
       Обновляет CLAUDE.md и MEMORY.md
       ↓
       Правило в каждом новом чате грузится в system prompt

Честно про «автономию»: это не автономия — это context tax ~210 строк (CLAUDE.md 124 + MEMORY.md ~90) в каждый промпт. Юзер не должен помнить правила, но Claude читает их каждый раз. Цена за единообразие поведения.

Subagent stack

Агент	Модель	Назначение
architect	Opus	архитектура, варианты с трейдоффами
researcher	Sonnet	ресёрч 3+ шагов, confidence-маркеры
code-reviewer	Sonnet	ревью после крупного куска
max-transcriber	Sonnet	голосовые из Max
security-auditor	Sonnet	аудит перед deploy
tg-digest-reader	Haiku	TG-дайджесты с GCP VM (просто читает текст)

Hub-and-spoke: координатор не доверяет выводам субагентов слепо, верифицирует через прямой grep/read.

Quality gates

• pre-commit git hook: 116 тестов (steam-sniper + metrics) за ~2с, secrets scan, ruff lint
• Hooks lifecycle: PreToolUse (secrets, gates) / PostToolUse (filesize, output filter) / PreCompact (auto-diary)
• Domain-specific verification через tools/<x>/verify.sh — реальные HTTP/SSH/cron проверки для каждого продукта. Запуск: bash scripts/ops.sh verify-tools или индивидуально bash tools/steam-sniper/verify.sh --quick. Generic тесты ловят синтаксис, verify.sh — production state.

Setup на новом компе

npm install -g @anthropic-ai/claude-code
git clone https://github.com/NickStr11/dotfiles-claude ~/.dotfiles-claude
bash ~/.dotfiles-claude/setup.sh
git clone https://github.com/NickStr11/cortex && cd cortex
claude

Per-user данные (MEMORY.md, CURRENT_CONTEXT.md, diary) не клонируются — нужно начать новый дневник или восстановить из OneDrive backup.

Inspirations

• Hermes Agent (NousResearch, github.com/NousResearch/hermes-agent) — изучен через recon-report. Взяли идеи: session search (изначально FTS5, после критики переписали на grep — overkill на 61 документе), read-only skill curator, dry-run для миграций, recon-template. Отвергли: runtime, gateway, autonomous skill mutation, plaintext SUDO_PASSWORD pattern.
• agentskills.io — стандарт frontmatter для skills.
• Karpathy LLM-wiki concept (gist) — 80% паттерна уже работает через diary + reflect + MEMORY.

Что отвергнуто явно

• Vendor-neutral абстракции (один разработчик)
• Future-proofing без явного триггера
• Autonomous user modeling в стиле Honcho (aboutme.md глубже после 22 сессий психоанализа)
• Autonomous skill mutation (single-writer + confirm надёжнее)
• Hermes runtime/gateway/dashboard (мы context pack, не agent product)

Метрики

• Репо инициирован 2026-02-22, активный дневник с 2026-03-19
• 23 diary за ~6 недель
• 16 скиллов, 6 субагентов
• ~120 строк CLAUDE.md, ~90 MEMORY.md
• Index 580 KB на 61 документ (через session-search.py stats)

Changelog

Контроль версий для самого себя — чтобы при git pull на другом компе понимать что и зачем менялось.

2026-05-04 (session 028) — Memory consolidation + cold-review дисциплина

Что:

• 16 → 7 feedback файлов. Объединены: terse-action+quiet-startup+auto-checkpoint → feedback_work-style.md; browser-stack+search-tools+data-via-vm+tool-switch-threshold → feedback_tool-selection.md; pdf-russian+powershell-pipeline+restart-friction → feedback_environment.md; external-audit-cadence+reflect-rules+future-agi-monitoring+новый cold-review → feedback_cadence.md. Без изменений: agent-teams, codex-parallel, no-startup-changes. Индекс MEMORY.md обновлён.
• Cold-review subagent поймал 14 находок (2 BLOCKER + 6 ANNOYING + 6 MINOR). Починено 8: broken refs после консолидации в CLAUDE.md / subagents-playbook / personal_observations; стейл хуки grab-screenshot.py + output-secret-filter.py (заменены на no-op stubs до удаления в новой сессии); runtime/cache/ → per-user ~/.claude/projects/D--code-2026-2-cortex/cache/; /reflect путь к MEMORY.md уточнён на per-user.
• Mandatory action в CLAUDE.md: после consolidate / refactor / удаления ≥3 файлов → запустить code-reviewer субагент в режиме cold-review (5 мин, sandbox). Защита от паттерна «я объявляю готово, потом subagent находит косяки».
• 2 новых антипаттерна в subagents-playbook.md: Researcher завис на multi-source comparison (5+ репо) → code-reviewer шустрее; Researcher self-modification (попытка писать в .claude/hooks/) → нужен явный sandbox-блок «КРИТИЧЕСКИЕ ОГРАНИЧЕНИЯ» в начало каждого Agent-промпта.
• 2 новых recipe в docs/learned-the-hard-way.md § 15: диагностика «subagent висит 10+ мин» (TaskStop + руками) и «SECURITY WARNING: Self-Modification» (sandbox-блок).
• External benchmark vs топ публичных репо (addyosmani/agent-skills 27k★, mattpocock/skills 57k★, forrestchang/andrej-karpathy-skills 110k★, thedotmack/claude-mem 71k★, coleam00/Archon 20k★) — runtime/research/external-benchmark-2026-05-04.md. Path A (personal monorepo) подтверждён.
• Recon ComposioHQ/awesome-codex-skills — 0 интегрировано, 4 на полке (changelog-generator, gh-fix-ci, gh-address-comments, sentry-triage).

Зачем:

• 16 feedback файлов с пересечениями → 7 категорий проще обновлять и читать.
• Cold-review дисциплина — лекарство против моего паттерна «всё работает» который потом не работает.
• Cadence 1/2 нед в feedback_cadence.md — лекарство против перфекционизма: регулярная проверка вместо постоянной тревоги.

Не сделано (отложено в backlog):

• Удалить stub-хуки grab-screenshot.py + output-secret-filter.py (после /clear или новой сессии)
• LICENSE файл создать (в README указан MIT, файла нет)
• Hardcoded paths в hooks fallback (D:\code\2026\2\cortex) и max-transcriber.md (C:\Users\User)

Целостность системы: 5/10 → 9/10 (по cold-review).

2026-05-01 (sessions 026 + 027) — Infra v2 + Steam Sniper wear-fix

• 3-слойный setup: generic тесты + domain verify.sh per tool + learned-the-hard-way recipes (Артур-критика)
• session-search переписан с FTS5 → grep (overengineering на 61 doc, Кент-критика)
• Per-agent калибровка моделей субагентов
• Researcher с confidence-маркерами после Hermes-кейса
• Steam Sniper wear-fix в 3 итерации, 116/116 тестов
• Codex CLI subagents перенесены из nickCodex-READY
• Future-AGI observability на TG-digest pipeline
• SubagentStop hook для auto-lessons capture

---

License

MIT — но это личный монорепо, не open-source product. Issues / PR не принимаются.