retro
Skill1 starsChanged 3 months agoMITView on GitHub
Пострефлексия сессии: разбирает ВЕСЬ прошедший диалог по реальному транскрипту и оценивает работу агента-сисадмина целостно — по пяти фронтам (процедуры, конституция, скиллы, UX, нижний слой персоны/knowledge/архитектуры). Находит проблемы и доводит агента до идеала: классифицирует находки и раскладывает по механизмам (lessons-learned, backlog для /dev, черновик ADR). Свежий субагент-аудитор судит как внешний ревизор. Мета-скилл конструктора мозга (семья /dev), не управляет инфраструктурой. Триггеры: «разбери сессию», «ретроспектива диалога», «проанализируй мою работу и найди проблемы», «постмортем сессии», «оцени сисадмина целостно», «/retro», «retrospective», «debrief session», «как улучшить агента по этому чату». НЕ для аудита сервера (audit-security); НЕ для снимка инфры (inventory-scan); НЕ для прямой правки мозга без разбора сессии (/dev).
193 other projects use a version of this.
Adopted by
Most recently taken up by
- rodeyseijkens/skillstheir own version, first seen Nov 8, 2026
- Yesterday-AI/ytstacktheir own version, first seen Nov 8, 2026
- gaoyu06/harnesstheir own version, first seen Nov 8, 2026
- Schepetkov/claude-skills-game-UEtheir own version, first seen Nov 8, 2026
- tornikegomareli/Skillstheir own version, first seen Nov 8, 2026
- devjiwonchoi/skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use plan-tune, ios-clean and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ShreyRaviSkillplan-tune
Self-tuning question sensitivity + developer psychographic for gstack (v1: observational). Review which AskUserQuestion prompts fire across gstack skills, set per-question preferences (never-ask / always-ask / ask-only-for-one-way), inspect the dual-track profile (what you declared vs what your behavior suggests), and enable/disable question tuning. Conversational interface — no CLI syntax required.
Also in 9 projects that use this
Saqlain-811Skillios-clean
Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)
Also in 5 projects that use this
Saqlain-811Skillios-fix
Autonomous iOS bug fixer. (gstack)
Also in 5 projects that use this
seek888Skillpair-agent
Pair a remote AI agent with your browser. One command generates a setup key and prints instructions the other agent can follow to connect. Works with OpenClaw, Hermes, Codex, Cursor, or any agent that can make HTTP requests. The remote agent gets its own tab with scoped access (read+write by default, admin on request). Use when asked to "pair agent", "connect agent", "share browser", "remote browser", "let another agent use my browser", or "give browser access". (gstack) Voice triggers (speech-to-text aliases): "pair agent", "connect agent", "share my browser", "remote browser access".
Also in 11 projects that use this
ShreyRaviSkilllanding-report
Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)
Also in 8 projects that use this
timurgaleevSkilldocument-generate
Generate missing docs for a feature, module or project as tutorials, how-tos, reference and explanation.
Also in 7 projects that use this
- +1 more from Saqlain-811
- +2 more from ShreyRavi
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- mattpocock/skills★ 309ksame name
- garrytan/gstack★ 141ksame name
- formbricks/formbricks★ 13ksame name
- ArcReel/ArcReel★ 6.3ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- withcoral/coral★ 4.9ksame name
- bergside/awesome-design-skills★ 2.9ksame name
- MiniMax-AI/minimax-code★ 2.2ksame name
- DenchHQ/DenchClaw★ 1.7ksame name
- DenchHQ/ironclaw★ 1.7ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository25 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- audit-securitySkill
- bootstrap-new-serverSkill
- cleanup-existing-serverSkill
- configure-vpn-routingSkill
- deploy-serviceSkill
- devSkill
- extract-subscription-serversSkill
- finalize-vpn-routingSkill
- generate-client-configSkill
- health-checkSkill
- install-monitoring-stackSkill
- inventory-scanSkill
- migrate-server-to-serverSkill
- refresh-vpn-knowledgeSkill
- restore-from-backupSkill
- rotate-secretsSkill
- second-opinionSkill
- setup-backupsSkill
- setup-happ-subscriptionSkill
- setup-secrets-vaultSkill
- setup-server-proxySkill
- setup-vpn-panelSkill
- sysadmin-initSkill
- sysadmin-meetSkill
The file
Files
<role>
Я — скилл-ретроспектива `/retro`, инструмент конструктора мозга (семья `/dev`). Беру
**весь прошедший диалог** оператора с агентом-сисадмином, читаю его **настоящий
транскрипт** (не память агента — она оправдывает свои же решения) и оцениваю работу
**целостно**: понял ли агент задачу → выбрал ли процедуру → исполнил → объяснил → закрыл,
и поддержал ли его в этом нижний слой (персона, скиллы, knowledge, архитектура). Нахожу
проблемы по всему фронту и раскладываю их по механизмам, чтобы каждая сессия доводила
агента до идеала.Я не играю сисадмина: на серверы не выхожу, инфру не трогаю. Я анализирую и
маршрутизирую находки. Правки мозга применяет оператор через /dev под контролем —
я ничего не меняю в поведении агента молча.
</role>
<context>
Что предполагается:
- Скилл запущен из каталога проекта `sysadmin/` (cwd), в конце содержательной сессии.
- Транскрипт сессии существует в `~/.claude/projects/<slug>/<id>.jsonl` (Claude Code
пишет его сам). `<slug>` = cwd с заменой не-буквенно-цифровых символов на «-».
- `python3` доступен (нужен для `extract-transcript.py`).Что НЕ предполагается:
- НЕ автозапуск — зовётся вручную (оператор решает, что сессия достойна разбора).
- НЕ автофикс мозга — выбор оператора «диагноз + маршрутизация», правки идут через
/dev. - НЕ запись в приватный
infra/— lessons-learned только предлагаются оператору.</context>
<goals>
После выполнения TRUE:
- Дайджест сессии извлечён из реального транскрипта в `retro/reviews/` (gitignore-зона).
- Свежий субагент-аудитор вынес вердикт и находки по 5 фронтам, каждая — с привязкой к
моменту транскрипта (нет привязки → выброшено, C.2).
- Сырой отчёт сохранён в `retro/reviews/SESSION-REVIEW-<date>.md` (gitignore).
- Обезличенные находки занесены в трекаемый `retro/BACKLOG.md`; архитектурные оформлены
черновиком ADR; уроки про оператора/инфру — предложены (не записаны молча).
- Оператору показан короткий отчёт + предложение перейти к правкам в `/dev`.
</goals>Параметры
| Параметр | Default | Описание |
SESSION | свежайший .jsonl проекта (= текущая сессия) | id сессии или путь к транскрипту для разбора прошлой сессии |
SYSADMIN_ROOT | cwd | Корень репо мозга sysadmin/ |
Процедура
Шаг 0. Pre-check и гейт значимости 🟢
SYSADMIN_ROOT="$(pwd)"
command -v python3 >/dev/null || { echo "СТОП: нужен python3 для разбора транскрипта."; exit 1; }
mkdir -p "$SYSADMIN_ROOT/retro/reviews"Извлекаю дайджест (он же проверяет наличие транскрипта и печатает гейт значимости):
python3 .claude/skills/retro/scripts/extract-transcript.py "${SESSION:-}" \
> "retro/reviews/_digest.md" 2>&1 || { cat retro/reviews/_digest.md; exit 1; }
head -8 retro/reviews/_digest.mdГейт: если реплик оператора < 2 и вызовов инструментов нет — сессия пустая. Честно говорю «разбирать нечего» и останавливаюсь (не выдумываю находки ради процесса).
Шаг 1. Свежий субагент-аудитор 🟢
Запускаю отдельный субагент (Agent, тип general-purpose) — чистый контекст, рамка
внешнего ревизора, без привязки к решениям, которые принимал агент в сессии. Передаю ему
пути, не содержимое (пусть читает сам):
Ты — внешний аудитор работы агента-сисадмина. Твоя задача — найти, где агент и его мозг можно довести до идеала, а не оправдать сделанное.
- Прочитай дайджест сессии:
retro/reviews/_digest.md.- Прочитай рубрикатор и следуй ему строго:
.claude/skills/retro/references/audit-rubric.md.- Для оценки нижнего слоя читай реальные файлы мозга:
CLAUDE.md, затронутые.claude/agents/references/*.mdиSKILL.mdтех скиллов, что работали в сессии.- Верни структуру по формату из рубрикатора: вердикт, «что сработало», находки (severity MUST/NEVER/MAY, фронт, эпизод-цитата, корень, маршрут, предложение). Железно: каждая находка привязана к моменту транскрипта; фильтр значимости; без выдумок. Гипотезу агента («скорее всего X») НЕ повышай до находки-факта («оказалось X»); последствие, следа которого в транскрипте нет, — выброс (правило 6 рубрикатора).
Дожидаюсь структурированного ответа аудитора.
Шаг 2. Сырой отчёт в gitignore-зону 🟢
Из ответа аудитора и шаблона templates/session-review.md собираю
retro/reviews/SESSION-REVIEW-<YYYY-MM-DD>.md. Подставляю объём (из шапки дайджеста),
тему, вердикт, сильные стороны, находки. Этот файл не коммитится — содержит
инфра-специфику оператора (IP, домены из транскрипта). Это страховка от утечки PII в
публичный репозиторий (ADR-0017).
Шаг 3. Маршрутизация находок 🟡
Каждую находку отправляю по её маршруту (таблица в рубрикаторе). Обезличиваю при переносе в трекаемые файлы — без IP/доменов/имён БД оператора (ADR-0017):
- Баг/слабость скилла, нехватка персоны/knowledge → дописываю строку в
retro/BACKLOG.md(трекается):дата | severity | фронт | основание | находка | предложение | open. Основание обязательно —факт(подтверждено транскриптом) либогипотеза(не подтверждено; так и записываю, не повышаю до факта). Правило подпёрто гейтом.claude/hooks/retro-finding-gate.sh: строка без основания не запишется (ADR-0021). Блок гейта — сигнал вернуться к транскрипту и проверить, а не повод переформулировать находку так, чтобы она проскочила. - Архитектурное решение → черновик ADR в
decisions/NNNN-<slug>.mdсо статусом «Предложено» (следующий свободный номер; шаблонdecisions/0000-template.md). - Урок про оператора/инфру/паттерн работы → предлагаю оператору заметку в
infra/knowledge/lessons/илиpatterns/(граф памяти, ADR-0018; я вinfra/не пишу — это его приватная зона и ритуал памяти сисадмина). Напоминаю: заметка + строка в00-index.md— одним коммитом.
Применение правок мозга (фикс скилла, доработка персоны) — не здесь, а отдельно в
/dev под контролем оператора. Ретро только ставит задачу и не теряет её.
Шаг 4. Финальный отчёт оператору 🟢
Финальный отчёт
Короткий, в чат:
- Вердикт (2-3 фразы): справился ли агент целостно, главный рычаг улучшения.
- Что сработало — 1-3 сильные стороны (их не ломаем при правках).
- Находки по severity — MUST/NEVER/MAY, каждая одной строкой с маршрутом.
- Путь в
retro/reviews/SESSION-REVIEW-<date>.md(полный разбор, локально). - Что занесено: N в BACKLOG, N черновиков ADR, N предложений в lessons-learned.
- Предложение: перейти в
/devи закрыть находки по убыванию severity.
Не раздуваю. Если критичного нет — говорю честно «MUST/NEVER нет, есть N улучшений MAY».
Подводные камни
- Аудит своей же работы льстит. Поэтому судит ОТДЕЛЬНЫЙ субагент по транскрипту, а не я по памяти. Не сворачивай этот шаг ради скорости — иначе ретро превращается в самооправдание.
- PII в публичный репозиторий. Сырой отчёт цитирует сессию с IP/доменами. Он живёт
только в gitignored
retro/reviews/. ВBACKLOG.md/ADR — обезличенно. Перепутать = утечка (грабля аудита 12.06.2026). - Конфабуляция саморазбора — опаснее разового сбоя (ADR-0021). Находка идёт в BACKLOG и ADR, то есть в память, которой доверяют будущие сессии: выдуманное последствие живёт дальше уже как факт. Поэтому модальность сохраняется дословно (гипотеза остаётся гипотезой), а находка без следа в транскрипте снимается — оператор вправе оспорить любую сверкой, и она уходит без спора. Грабля 2026-07-24: записанное «сломал рабочий VPN» транскриптом не подтвердилось.
- Раздувание находок. 30 пунктов за сессию → ретро игнорируют. Фильтр MUST/NEVER/MAY обязателен; MAY-косметику агрегируй.
- Запись в
infra/из режима /dev запрещена. Уроки только предлагаю; пишет их оператор в роли сисадмина (ритуал памяти §5). - Гейт значимости. Пустую сессию не разбираю — честный «нечего» лучше выдуманного.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

