Forge
markdownafcd9bec
1# Первые принципы среды
2
3## 1) Среда — это когнитивный экзоскелет
4
5Мы не полагаемся на «держать всё в голове». Среда должна:
6
7- держать рабочее состояние между сессиями;
8- быстро восстанавливать контекст после отвлечений;
9- делать следующий шаг очевидным.
10
11## 2) Источник истины — явно определён
12
13- Для решений/правил/контекста: `agent-notes` (KB + протоколы).
14- Для кода: соответствующие репозитории.
15- Для текущей итерации: явные рабочие задачи/шаги.
16
17Если источник не определён — система начинает врать и расползаться.
18
19## 3) Минимизация переключений важнее «идеала»
20
21Главный риск — не «плохой код», а потеря фокуса на многозадачности.
22Поэтому мы предпочитаем:
23
24- короткие проверяемые циклы;
25- явные критерии готовности;
26- фиксацию решений сразу после принятия.
27
28## 4) Документация = исполняемый интерфейс команды
29
30Wiki и KB не «про запас». Они нужны, чтобы:
31
32- новый человек вошёл без устного брифинга;
33- старый человек вернулся после паузы без деградации качества;
34- решения не зависели от памяти одного участника.
35
36## 5) Принцип «почему» перед «как»
37
38Если человек понимает first principles, он восстановит детали сам.
39Если знает только кнопки — ломается при первом исключении.
40
41## 6) Принцип минимально достаточного инструмента
42
43Для коммуникации и синхронизации используем самый простой инструмент, который уже передаёт смысл без потерь.
44
45- Усложняем стек только при явной необходимости (масштаб, трассируемость, автоматизация).
46- Если инструмент приходится отдельно долго объяснять, он уже слишком дорог для текущей задачи.
47- При равной пользе выбираем более лёгкий носитель (условно: доска и маркер раньше, чем тяжёлый моделлер).
48
49## 7) Environment-first (следствие закона Конвея)
50
51Структура ПО отражает структуру коммуникации в организации (Conway's Law).
52Значит, если работа системно идёт плохо, первым проверяем среду и интерфейсы взаимодействия, а не «качество людей».
53
54- Плохая среда ломает даже сильных исполнителей.
55- Хорошая среда поднимает качество и скорость всей команды.
56- Диагностика начинается с процесса, контуров ответственности и обратной связи.
57
58## 8) Friction-first loop
59
60Операционная петля улучшений: сначала ищем трение, затем убираем его минимальным фиксом, фиксируем микроуспех и сразу идём в следующий шаг.
61
62- Вопрос на входе: «Что мешает прямо сейчас?»
63- Действие: самый маленький фикс с проверяемым эффектом.
64- Усилитель: радость от микроуспеха повышает энергию и темп следующего шага.
65- Повтор: короткие циклы дают быстрее и устойчивее, чем редкие «большие рывки».
66
67## Проверка понимания
68
69Если ты можешь за 2–3 минуты ответить:
70
711. Зачем здесь KB?
722. Где находится источник истины по решениям?
733. Что делать после потери контекста?
74
75— значит вход в среду пройден.
View only · write via MCP/CIDE