← [Раздел](README.md) · [Главная](../README.md)

# ECC в workspace nazeebod

## Цель

Понять, как **ECC интегрирован** в `/Users/nazeebod/Projects/`: workspace-level rules/skills/hooks, проекты `nazeebo.site`, `ECC`, и как не дублировать конфигурацию.

## Предварительно

- [ustanovka-i-agent-sort.md](ustanovka-i-agent-sort.md)
- Доступ к локальным путям (учебная машина автора курса)

## Время

~45 минут.

---

## Три слоя конфигурации

```text
1. ECC (канон)     /Users/nazeebod/Projects/ECC/.cursor/
2. Workspace       /Users/nazeebod/Projects/.cursor/
3. Проект          например nazeebo.site/docs/AI/.cursor/
```

**Правило:** канон — ECC; workspace — общая политика; проект — узкие правила (например, `ai-docs.mdc`).

---

## Workspace `/Users/nazeebod/Projects/.cursor/`

Типичное содержимое (проверяйте актуальное дерево):

| Каталог | Назначение |
|---------|------------|
| `skills/` | Копии/синхронизация ECC skills (configure-ecc, agent-sort, tdd-workflow, …) |
| `rules/` | `common-*` правила на все подпроекты |
| `hooks.json` | Session, shell guard, afterFileEdit — как в ECC |
| `hooks/*.js` | Обработчики |

**Эффект:** открывая любой подпроект в Cursor как часть workspace `Projects`, вы наследуете общие hooks и skills.

---

## Репозиторий ECC

Путь: `/Users/nazeebod/Projects/ECC`

- **Источник правды** для апстрима;
- разработка новых skills/agents;
- `configure-ecc` клонирует или читает отсюда при локальной разработке.

Не правьте ECC через агента в случайном подпроекте — делайте PR в ECC repo.

---

## nazeebo.site и документация AI

```text
/Users/nazeebod/Projects/nazeebo.site/docs/AI/
├── README.md
├── .cursor/rules/ai-docs.mdc    # конвенции md для курса
├── Makefile                     # upload-docs
└── 07-commands/ … 13-pro-uroven/
```

**ai-docs.mdc** задаёт:

- дерево `00-`…`13-`;
- шаблон страницы (Цель, Предварительно, …);
- относительные ссылки;
- русский язык, без секретов.

Публикация: S3 prefix `ai/`, viewer `https://ai.nazeebo.site`.

---

## Пример: s3-md-browser

Проект `nazeebo.site/s3-md-browser` — Go-сервис для просмотра md из S3.

Для AI-документации агенту полезно:

- rule `ai-docs.mdc` при правке `docs/AI/**/*.md`;
- skill `doc-updater` / команда `/update-docs` из ECC при синхронизации codemaps;
- **не** подключать тяжёлые stack-specific skills без agent-sort.

---

## helm-infra и личная инфраструктура

Skill `nazeebo-infra` (в user/project skills) — Kubernetes, Helm, nazeebo.site.

Разделение:

| ECC generic | nazeebo-infra |
|-------------|---------------|
| `common-security` | Политики кластера |
| `e2e-testing` | Деплой viewer в k8s |
| `production-audit` | Чеклист релиза nazeebo.site |

Используйте **agent-sort**, чтобы `nazeebo-infra` был DAILY только в infra-репо, не в каждом frontend-лабе.

---

## Рекомендуемый workflow для автора курса

1. Новый skill upstream → PR в **ECC**.
2. `configure-ecc` или sync → **Projects/.cursor/skills/**.
3. Проектные rules → только в `проект/.cursor/rules/`.
4. Перед большой сессией — `/ecc-guide` + проверка hooks не тормозят.
5. Документация курса — соблюдать `ai-docs.mdc`.

---

## Чего избегать в monorepo

| Антипаттерн | Почему |
|-------------|--------|
| Две копии одного skill с разным текстом | Drift |
| Prod kubeconfig в MCP workspace-wide | Blast radius |
| Все ECC commands в маленьком docs-репо | Шум в `/` |
| Секреты в `hooks.json` env | Git leak |

---

## Практика

1. Сравните `Projects/.cursor/hooks.json` и `ECC/.cursor/hooks.json` — что общее?
2. Откройте `nazeebo.site/docs/AI/.cursor/rules/ai-docs.mdc`.
3. Составьте **личный** DAILY список из 5 skills для работы над `docs/AI`.

---

## Самопроверка

1. Где канонический источник ECC skills?
2. Зачем `ai-docs.mdc` в docs/AI?
3. Чем workspace hooks отличаются от project hooks?
4. Когда использовать nazeebo-infra skill?

---

## Дальше

→ [12 — Практикум](../12-praktikum/README.md)  
← [Установка и agent-sort](ustanovka-i-agent-sort.md)