Организация, проект, задача

У каждой записи одна область: вся организация, один проект разработки (или пространство — оно область такая же, как проект) или одна задача внутри проекта.

Что во что класть

Организация — то, что верно везде, в любом проекте:

• правила работы («обязательно YAGNI», «комментарии по-русски»);
• решения уровня компании, записанные как правила («в апстрим публикуем только через PR»);
• ссылки на общие ресурсы.

Проект — то, что верно только здесь и переживёт любую задачу:

• факты о конкретной кодовой базе и её окружении;
• ловушки сборки и тестов этого проекта;
• решения, принятые в этом проекте.

Пространство — то же самое для отдела без кода: правило «Отвечаем клиенту в течение рабочего дня» — в пространство поддержки, факт «Актуальный прайс — в папке Продажи/Прайсы» — в пространство продаж, ловушка «Регламент закупок 2024 устарел — смотреть редакцию 2026» — в пространство юристов. В организацию такие записи класть не стоит: правило поддержки будет мешать в каждом проекте разработки.

Задача — то, что верно, пока открыта одна задача:

• решения автора по этой задаче, данные в уточнениях и на гейтах;
• состав и контракты её атомов, её ветка и спецификация;
• проверенные для её артефактов якоря, счётчики и профили.

Записи задачи пишет только модель — по ходу работы над ней. Человек в редакторе такую область не выбирает: его знание либо про проект, либо про организацию.

Сомневаетесь между организацией и проектом — кладите в проект. Записать знание в организацию значит показать его каждому прогону каждого проекта: правило, верное для одного проекта, будет мешать в остальных. Модель, сомневаясь между проектом и задачей, пишет в задачу: ценное оттуда поднимет проход, а лишнее из проекта само не уйдёт.

Как это видит модель

Прогон задачи T проекта P в организации O получает:

• все активные записи организации O;
• все активные записи проекта P;
• все активные записи задачи T — и ни одной записи другой задачи.

Чужие проекты не видны никогда — ни в индексе, ни по требованию. Чужие задачи — тоже. Прогон вне задачи (аудит, «Спросить») записей задач не получает вовсе.

Что происходит с записями задачи

Когда задача заканчивается — смержена, отклонена или остановлена, — проход по итогам работы читает её записи вместе с остальным материалом и переносит в проект то, что переживёт задачу. После прохода вся область задачи уходит в архив одним действием с причиной «задача завершена»: в списке такие записи видны на вкладке «Архив», в журнале аудита — одним событием со списком имён.

Запись задачи, которую вы пометили перманентной, остаётся активной: этот признак — ваше решение сохранить её. Если знание нужно насовсем, лучше перевести его в проект: откройте запись, выберите проект в поле «Область» и сохраните.

Как это видят люди

Участник видит записи тех областей, куда достаёт его право чтения: грант на проект даёт записи этого проекта (вместе с записями его задач) и записи организации; грант на организацию — всё.

В списке область показана значком у каждой записи; у записи задачи рядом стоит пометка «задача #N», которая ведёт к самой задаче. Фильтр «Знания задач» показывает только такие записи — и на вкладке «Активные», и в архиве.

Кто может писать куда

Общеорганизационные записи — целиком человеческая территория: это правила, по которым работает вся компания, и модель их не устанавливает. Область задачи — территория модели: там живёт то, что она выяснила по ходу одной работы. Перенос записи между областями делает человек, а из задачи в проект — ещё и проход по итогам работы; сама модель по ходу задачи область записи не меняет.