pismenny

Флотилия

Как организовать работу ИИ-агента
в нескольких репозиториях

Данил Письменный

pismenny

Один workspace. Шесть отдельных репозиториев.

Общий каталог объединяет рабочее пространство, но не превращает его в монорепозиторий.

~/project/   ← обычный каталог
├── workspace/  ← Git
│   ├── FLEET.md
│   └── AGENTS.md
├── android/    ← Git
├── ios/        ← Git
├── backend/    ← Git
├── web/        ← Git
└── sales/      ← Git · продажи
workspace/ — общая координация
Карта системы, межрепозиторные задачи, общие инструкции и команды подготовки окружения.
Не только код
sales/ — материалы продаж: клиенты, предложения, воронка. Отдельный Git и свои права доступа.
Разработчик: workspace + нужный код.
Команда продаж: workspace + sales.
Права задаются на Git-хостинге. Клонируются только доступные репозитории.
pismenny

FLEET.md: куда идти и где оставить результат

~/project/workspace/FLEET.md
# Флотилия проекта

## Репозитории — пути от домашней директории (~)
- ~/project/workspace/ — координация и межрепозиторные задачи.
- ~/project/android/   — Android: код, локальные задачи, сборка и тесты.
- ~/project/ios/       — iOS: код, локальные задачи, сборка и тесты.
- ~/project/backend/   — Backend: серверный код, API и тесты.
- ~/project/web/       — Web: клиентский код, сборка и тесты.
- ~/project/sales/     — продажи: клиенты, предложения, воронка.

## Порядок работы
1. По карте выбери репозиторий для задачи.
2. Перед работой в нём прочитай его AGENTS.md.
Карта показывает, где что лежит, но не даёт доступ. Закрытые материалы остаются в sales/, не в workspace.
pismenny

AGENTS.md: сначала прочитай общую карту

Добавить блок в AGENTS.md всех шести репозиториев, включая workspace/ и sales/.

Пример: ~/project/android/AGENTS.md
⋯
## Участник флотилии проекта

В начале каждой рабочей сессии прочитай
~/project/workspace/FLEET.md.

Перед работой в другом репозитории
прочитай его AGENTS.md.
⋯
Общий слой
FLEET.md → репозиторий-владелец → его AGENTS.md.
Локальный слой
AGENTS.md → правила конкретного репозитория.
QR-код: https://pismenny.ru/

pismenny.ru

Флот и флотилии из личной практики

pismenny.ru/fleet/

Как хранить .env и секреты

pismenny.ru/articles/secrets-and-configuration.html