Commit Graph
25 Commits
Author SHA1 Message Date
Dmitriy DementievandClaude Opus 5 039cf29b95 docs(proxy): запись в TODO исправлена — тест синхронности уже есть
- Зачем:
  - предыдущая запись предлагала написать тест сверки копий NO_PROXY, хотя
    tests/test_proxy_env_sync.py делает ровно это с момента появления копий.
- Что:
  - запись переписана: дублирование под охраной, но на Windows проверка
    падает с ModuleNotFoundError: fcntl, потому что грузит proxy-client
    через runpy.
  - задача заменена на «дать тесту читать константу без исполнения модуля».
  - сохранён нерешённый вопрос про замещение no_proxy_extra: эта ветка не
    покрыта тестом вообще.
- Проверка:
  - python tests/test_proxy_env_sync.py -v — 1 ok, 1 ERROR (fcntl), то есть
    поведение, описанное в записи.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-12 17:48:24 +03:00
Dmitriy DementievandClaude Opus 5 89cdda99ec docs(proxy): помечено, что no_proxy_extra замещает список по умолчанию
- Зачем:
  - машинный конфиг, собранный копированием примера, молча выкидывает
    из обхода .concept-software.ru и Gitea, а обрыв всплывает как TLS-ошибка.
- Что:
  - в README уточнено, что no_proxy_extra замещает DEFAULT_NO_PROXY_EXTRA
    целиком, а не дополняет его.
  - предупреждение продублировано в обоих примерах конфига, рядом с полем.
  - в TODO.md записано дублирование списка в пяти windows-файлах и
    отсутствие теста синхронности с источником.
- Проверка:
  - bash tests/test_proxy_launchers.sh — 8 проверок пройдено.
  - configparser читает оба примера, значение no_proxy_extra не изменилось.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-12 17:41:23 +03:00
Dmitriy Dementiev 5286859533 feat(claude): добавлен запуск Desktop через прокси
- Зачем:
  - нужен отдельный запуск Claude Desktop через hproxy.local без системного прокси.
- Что:
  - добавлен PowerShell-скрипт с переменными прокси и параметрами Electron.
  - добавлено идемпотентное создание ярлыка Claude Proxy через chezmoi.
  - описано правило полного закрытия уже запущенного Claude.
- Проверка:
  - проверены PowerShell-синтаксис, аргументы запуска и WSLENV через подмену Start-Process.
  - двумя прогонами с подменой COM проверена идемпотентность создания ярлыка.
  - выполнены chezmoi managed и git diff --cached --check.
2026-07-23 16:59:45 +03:00
Dmitry Dementiev 6fbe8f6be1 docs(skills): в плейбук субагентов встроено разбиение /to-tickets и шкала ревью постановки
- Зачем:
  - прогон предразметки показал два сбоя: тикеты созданы мимо критериев /to-tickets, а текст тикета трижды проходил через контекст оркестратора.
- Что:
  - этап 1: разбиение по критериям /to-tickets, мерка «тикет берётся в отдельной сессии без общего контекста».
  - этап 2: правило «одно ревью на версию артефакта» и шкала риска вместо безусловного ревью постановки.
  - согласованы шапка скилла, роли, критерии закрытия этапов и список соседних скиллов; урок записан в references/lessons.md.
- Проверка:
  - вычитка SKILL.md: новые правила не противоречат этапам 3-6.
2026-07-21 11:43:49 +03:00
Dmitriy Dementiev 3b7ebd29c8 chore(sync): слиты изменения origin/master
- Зачем:
  - origin/master обновился во время отправки локальных коммитов.
- Что:
  - добавлена удалённая эмпирика Claude-плейбука.
  - сохранены локальные изменения Codex-плейбука и handoff.
- Проверка:
  - отсутствие конфликтов и последующая проверка состояния ветки.
2026-07-13 14:13:29 +03:00
Dmitriy Dementiev baac159189 docs(codex-playbook): добавлен handoff по оптике ревью
- Зачем:
  - следующей сессии нужен компактный контекст решений и незавершённой синхронизации.
- Что:
  - сохранены ссылки на действующие договоры скилла и триаж ревью.
  - описана гонка удалённой ветки и безопасный порядок последующего merge.
- Проверка:
  - git diff --check и проверка локальных ссылок handoff.
2026-07-13 14:12:43 +03:00
Dmitriy Dementiev 02a98df8c3 fix(codex-playbook): уточнён вердикт ревью планов
- Зачем:
  - ревью высокоуровневых документов могло требовать преждевременных деталей и постоянно блокировать одобрение.
- Что:
  - находки ограничены дефектами на уровне самого документа.
  - существенные отложенные риски отделены от блокирующих замечаний.
  - уточнено, что APPROVED допускает открытые вопросы будущей реализации.
- Проверка:
  - quick_validate.py, git diff --check и проверка локальных Markdown-путей.
2026-07-13 14:09:25 +03:00
Dmitriy Dementiev 70b18b9e9a fix(codex-playbook): устранены жёсткие допущения в шаблонах
- Зачем:
  - shell-зависимые примеры и конвейерные формулировки сужали применимость оптики.
- Что:
  - сборка подсказок описана платформенно-нейтральным порядком файлов.
  - граница ревью и маршрут актуальных отчётов оставлены гибкими.
  - исправлены входная формулировка и локальная навигация по ролям.
- Проверка:
  - quick_validate.py, git diff --check, Markdown-ссылки и узкая перепроверка агентом.
2026-07-13 13:25:33 +03:00
Dmitriy Dementiev 6cc1b26ce4 refactor(codex-playbook): согласована оптика тонкого мастера
- Зачем:
  - нужно сохранить контекст координатора и устранить расхождения с зеркальным playbook.
- Что:
  - закреплены делегирование, маршрутизация моделей и ограничение кругов ревью.
  - добавлены файловый договор ревью и согласованная эмпирика прогонов.
  - исправлены сборка слепых линий и компактные статусы находок.
- Проверка:
  - quick_validate.py, git diff --check и проверка локальных Markdown-ссылок.
2026-07-13 13:07:52 +03:00
Dmitry DementievandClaude Fable 5 9c047f9d1e docs(skills): эмпирика прогона 2026-07-13 в lessons субагентного плейбука
- Зачем:
  - зафиксировать уроки прогона тикета 06 (t2-presale) до их поглощения
    в SKILL.md.
- Что:
  - главный урок: карта прогресса для пользователя на границах этапов.
  - блок «Модели»: переоценка Sol, боевое подтверждение medium,
    роли Опус/Codex, наводка gpt-5.6-terra с пометкой «не обкатано».
- Проверка:
  - чтение references/lessons.md, запись «Прогон 2026-07-13».

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 11:31:02 +03:00
Dmitry Dementiev 60182ab493 fix(agents): исправлена оркестрация моделей и контекста
- Зачем:
  - следующая сессия должна управлять стоимостью субагентов без повторной загрузки длинных отчётов в контекст мастера.
- Что:
  - разделены TOML-роли и разовые переопределения модели, уточнены fork и service tier.
  - добавлен файловый обмен, жизненный цикл временного каталога и нативные скелеты промптов.
  - синхронизированы полевые заметки и handoff с проверенной механикой Codex.
- Проверка:
  - quick_validate.py agents/.agents/skills/codex-subagent-playbook.
  - git diff --cached --check.
  - независимое ревью: VERDICT: APPROVED.
2026-07-10 17:59:15 +03:00
Dmitry Dementiev 0d2fc9af65 Merge branch 'skill/claude-playbook-context-retro': экономия контекста оркестратора 2026-07-10 16:58:10 +03:00
Dmitry DementievandClaude Fable 5 15d5515925 docs(skill): экономия контекста оркестратора по ретро прогона 2026-07-10
- Зачем:
  - ретро трёх циклов конвейера показало: находки ревью проходили через
    контекст оркестратора до шести раз, review-промпт дублировался, ~7
    пустых ходов на idle-пингах teammate-ревьюера.
- Что:
  - SKILL.md: механика «индекс у оркестратора, нагрузка файлами» — вердикты
    в файлы обменного temp-каталога, fix-промпт конкатенацией, один
    канонический review-промпт на обоих ревьюеров, idle-пинги как шум;
  - новый references/prompt-templates.md — скелеты четырёх промптов;
  - codex-exec.md: сборка промптов cat'ом, боевая модель gpt-5.5 явно
    (фронтир из конфига не наследовать);
  - codex-sandbox-fix-handover: рабочий AppArmor-фикс (ловушка memfd,
    профиль на бинарь codex), проверен на обоих режимах;
  - lessons.md: датированные записи ретро, казуса Sol и memfd.
- Проверка:
  - чтение SKILL.md и references/, следующий прогон конвейера.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 16:55:16 +03:00
Dmitry Dementiev 4d074adda6 feat(agents): добавлен плейбук оркестрации субагентов
- Зачем:
  - нужен повторяемый процесс делегирования без засорения контекста мастер-модели.
- Что:
  - добавлен явно вызываемый скилл с этапами, договорами возврата и защитой рабочего дерева.
  - описаны роли, уровни стоимости, полевые заметки и handoff для следующей версии.
- Проверка:
  - quick_validate.py agents/.agents/skills/codex-subagent-playbook.
  - git diff --cached --check.
2026-07-10 16:46:57 +03:00
Dmitry Dementiev 6e767d13ff docs(skill): двойное слепое ревью постановки и связка с /to-tickets
- Зачем:
  - прогон 2026-07-10 (mws-data-test-t2-presale) дал новую эмпирику
    этапов 1–2, не отражённую в скилле.
- Что:
  - этап 2: для крупной постановки — второе слепое ревью Кодексом с
    рамкой «постановку, не реализацию»; классы находок родословных;
  - этап 1: постановка через /to-tickets, когда репозиторий настроен
    под скиллы Мэтта Покока;
  - lessons.md: запись прогона с цифрами и ретро-оговоркой про
    companion-канал (issue #158).
- Проверка:
  - вычитка диффа свежим взглядом; ссылки ведут на существующие
    файлы references/.
2026-07-10 13:07:08 +03:00
Dmitriy DementievandClaude Fable 5 db6271f0f7 docs(skill): агенту предписаны инициатива и sudo-эскалация по sandbox-фиксу
- Зачем:
  - рецепт AppArmor-фикса требует sudo, а инициатива агента (диагностика
    до прогона, передача команд пользователю) держалась на здравом смысле,
    не на тексте скилла.
- Что:
  - в правило про линукс-ловушку codex-exec.md дописано: фикс сам не
    применяй — дай пользователю готовые команды с `!`-префиксом; после
    профиля напомни убрать use_legacy_landlock; перед первым прогоном на
    новой Linux-машине прогони диагностику превентивно.
- Проверка:
  - чтение правила в references/codex-exec.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:47:29 +03:00
Dmitriy DementievandClaude Fable 5 7607ce2b84 docs(skill): влиты линукс-уроки sandbox из ветки codex-sandbox-fix-20260710
- Зачем:
  - другая сессия на Ubuntu 24.04 задиагностировала молчаливую поломку
    песочницы Codex CLI 0.144.1 (bwrap+userns против AppArmor); знание
    нужно основной линии скилла — Linux-прогон конвейера впереди.
- Что:
  - перенесён references/codex-sandbox-fix-handover-2026-07-10.md
    (диагностика, обход use_legacy_landlock, AppArmor-профиль);
    раздел «Связанные записи» перенацелен с удалённого codex-companion.md
    на codex-exec.md.
  - в codex-exec.md добавлено сквозное правило про линукс-ловушку
    (сигнатура «гуглит, но не может ls»), в lessons.md — датированная
    запись, в handoff — кавеат к пункту про Linux-прогон.
- Проверка:
  - git show origin/codex-sandbox-fix-20260710 — содержимое перенесено
    полностью; перекрёстные ссылки codex-exec.md ↔ handover резолвятся.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:43:42 +03:00
Dmitriy DementievandClaude Fable 5 89ebd1d327 docs(skill): claude-subagent-playbook — write-ревьюер Codex и уборка
- Зачем:
  - read-only-конфайн обеднял ревью Codex (без тестов, поиска,
    первоисточников), а плотность SKILL.md и дефолты модели/усилия
    из config.toml накопили риски по итогам трёх прогонов.
- Что:
  - ветка «ревьюер» в codex-exec.md переведена на запись + авто-аппрув,
    защита — мандат промптом; в рецепты добавлены --strict-config и
    явные -m / model_reasoning_effort.
  - SKILL.md: правило «мандат промптом» для обоих ревьюеров, правило
    моделей субагентов (Опус/Sonnet, не Fable), /tdd и /research +
    Context7 в этапе 1, таймер-подстраховка ScheduleWakeup; уборка
    плотности и инлайн-дат.
  - handoffs 07-06/07-07/07-09 поглощены запиской 2026-07-10; в lessons.md
    добавлены правило дистилляции и блок 2026-07-10; правки прошли слепое
    ревью Опусом, все находки закрыты.
- Проверка:
  - оверрайды -m/-c проверены живым codex exec --strict-config;
    перекрёстные ссылки и команды сверены ревьюером с codex --help.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:41:09 +03:00
Dmitriy DementievandClaude Fable 5 4e496a1548 docs(skill): claude-subagent-playbook — прямой codex exec, уроки прогона 2026-07-09
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 20:05:37 +03:00
Dmitriy Dementiev 35d4114ba3 feat(wezterm): добавлен Windows-конфиг через chezmoi
- Зачем:
  - нужен живой WezTerm-конфиг, который тиражируется через dotfiles на Windows.
- Что:
  - добавлен репозиторный `wezterm/.wezterm.lua`.
  - добавлен chezmoi-шаблон для symlink `~/.wezterm.lua`.
  - README описывает Windows-настройку WezTerm.
- Проверка:
  - git diff --check -- README.md chezmoi/.chezmoiignore chezmoi/symlink_dot_wezterm.lua.tmpl wezterm/.wezterm.lua.
  - проверено, что `~/.wezterm.lua` является SymbolicLink на `dotfiles\wezterm\.wezterm.lua`.
2026-07-08 18:59:25 +03:00
Dmitriy Dementiev 9ceeb0ca4e docs(agents): добавлено правило понятности документов и комментариев
- Зачем:
  - код и конфигурации читают люди с разным уровнем экспертизы, текст должен быть доступен без дополнительных пояснений.
- Что:
  - добавлен абзац про простые слова, короткие фразы и пояснение сложных мыслей при первом упоминании.
- Проверка:
  - cat AGENTS.md — новый абзац присутствует в разделе «Язык и рассуждения».
2026-06-17 10:42:37 +03:00
Dmitriy Dementiev 3c0173647c docs(ai-text-lint): уточнён путь к базе паттернов
- Зачем:
  - `{baseDir}` не является стандартным placeholder и может сбить с толку.
- Что:
  - путь заменён на `references/patterns.md` с пояснением «в папке этого скилла».
- Проверка:
  - cat agents/.agents/skills/ai-text-lint/SKILL.md | grep patterns
2026-06-15 15:44:32 +03:00
Dmitriy Dementiev aece3bfcc6 feat(chezmoi): добавлен шаблон env.secrets для Windows
- Зачем:
  - автоматизировано создание ~/.env.secrets при chezmoi apply на Windows.
- Что:
  - добавлен chezmoi/create_dot_env.secrets с заглушками для CONTEXT7_API_KEY и ZAI_API_KEY.
- Проверка:
  - chezmoi apply и проверка наличия ~/.env.secrets
2026-06-15 15:37:37 +03:00
Dmitriy Dementiev ee474c9825 refactor(ai-text-lint): переработана структура patterns.md
- Зачем:
  - устранена дублирующая сводная матрица severity, которая устаревала при изменении паттернов.
  - улучшена навигация по документу за счёт группировки паттернов в категории.
- Что:
  - добавлены разделы категорий: Структура и форматирование, Тон и авторская позиция, Резюме-специфичные паттерны.
  - переупорядочены паттерны S05 и S06 внутри категории Структура.
  - обновлена ссылка на severity в SKILL.md с указанием inline-таблиц.
- Проверка:
  - git diff agents/.agents/skills/ai-text-lint/
2026-06-15 15:30:22 +03:00
Dmitry DementievandClaude Opus 4.8 6f9de57b0c refactor(brainstorm-with-docs): понимание ведёт, артефакт — запись
- Зачем:
  - гравитация скилла тянула к «выдать артефакт»; управляющие документы
    раздувались деталями реализации (диагностировано на живом тесте — ADR
    с инлайном SQL).
- Что:
  - gate/stop: «готово» = общее понимание + рекомендованное направление,
    записанное минимально-достаточно, а не «артефакт произведён»; определение
    в одном месте (stop_condition), gate на него ссылается.
  - core_rules: минимально-достаточный артефакт + барьер высоты (без инлайна
    исполняемых артефактов) + single source of truth; приоритет над
    конвенциями репозитория.
  - шаг 2: артефакт(ы) выбираются ПОСЛЕ понимания, набором по жанрам.
  - adr.md/spec.md: Lifetime test → Scope test (ADR↔spec по охвату, не сроку);
    detailed plan — transient и вне scope скилла.
  - description + README: формулировки-цели ведут пониманием, не артефактом.
- Проверка:
  - grep: старый framing (lifetime/transient) убран; cross-ref Scope test
    сходится; определение «готово» не дублируется; витрина не artifact-first.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 18:56:30 +03:00