architect/templates/arh/CLAUDE_TEMPLATE.md

Шаблон: CLAUDE.md

Версия: 1.0.0
Назначение: Единый формат AI-контекста для всех проектов


Принципы

  1. Краткость — AI должен понять контекст за 30 секунд
  2. Структура — Всегда одинаковые секции
  3. Актуальность — Ссылки на STATUS.md, не дублирование

Шаблон для ПРОЕКТА

# {Название проекта}

**Тип:** {business | platform | personal}
**Статус:** {draft | in_progress | on_hold | completed}
**Обновлено:** {YYYY-MM-DD}

---

## Что это

{1-2 предложения. Что делает проект, для кого, зачем.}

---

## Структура

| Папка | Назначение |
|-------|------------|
| `design/` | Проектные документы |
| `management/` | Статус, задачи, решения |
| `solution/` | Код и артефакты |

---

## Модули

| Модуль | Тип | Описание |
|--------|-----|----------|
| `@name.type/` | {api/service/site} | {Описание} |

---

## Текущий фокус

{Что сейчас делаем — 1 строка}

**Статус:** [management/STATUS.md](management/STATUS.md)
**Задачи:** [management/TODO.md](management/TODO.md)

---

## Ключевые файлы

| Файл | Назначение |
|------|------------|
| `path/to/file` | Описание |

---

## Команды

| Команда | Действие |
|---------|----------|
| `npm run dev` | Запуск dev-сервера |
| `npm test` | Тесты |

---

**Версия:** {X.Y.Z}

Шаблон для МОДУЛЯ (@name.type)

# @{name}.{type}

**Тип:** {api | service | site | server | storage}
**Статус:** {active | development | deprecated}
**Проект:** [{parent}](../CLAUDE.md)

---

## Что это

{1 предложение}

---

## Технологии

- {Framework/Language}
- {Database}
- {Other}

---

## Структура

| Папка | Назначение |
|-------|------------|
| `src/` | Исходный код |
| `config/` | Конфигурация |

---

## Запуск

```bash
{команда запуска}

API / Endpoints (если применимо)

Method Path Описание
GET /api/v1/... ...

Связи

Зависит от Зависят от него
@other.module @consumer.module

Версия: {X.Y.Z}

---

## Шаблон для ИНФРАСТРУКТУРЫ (@name.server)

```markdown
# @{name}.server

**IP:** {IP-адрес}
**Доступ:** {SSH user@host}
**Статус:** {active | maintenance}

---

## Назначение

{Для чего этот сервер}

---

## Сервисы

| Сервис | Порт | Статус |
|--------|------|--------|
| nginx | 80, 443 | active |
| docker | - | active |

---

## Пути

| Путь | Назначение |
|------|------------|
| `/opt/...` | Приложения |
| `/var/log/...` | Логи |

---

## Бэкапы

| Что | Куда | Расписание |
|-----|------|------------|
| `/opt/data` | S3 | daily |

---

## Мониторинг

- UptimeRobot: {URL}
- Логи: `journalctl -u service`

---

**Обновлено:** {YYYY-MM-DD}

Правила заполнения

  1. Не дублировать — статус в STATUS.md, не в CLAUDE.md
  2. Ссылки вместо копий[STATUS](management/STATUS.md)
  3. Обновлять дату — при каждом изменении
  4. Версионировать — X.Y.Z при значимых изменениях

Версия: 1.0.0