Начало работы

Нужен установленный Claude Code.

# Установить Claude Code (если ещё не установлен)
curl -fsSL https://claude.ai/install.sh | bash
claude --version

macOS / Linux / WSL. Для Windows: irm https://claude.ai/install.ps1 | iex (PowerShell). Документация →

git clone https://github.com/Arcanada-one/datarim.git
cd datarim
./install.sh --with-claude              # Claude Code (symlink, default)
./install.sh --with-codex               # Codex CLI (multi-runtime, v2.0+)
./install.sh --with-claude --with-codex # оба runtime сразу

Инсталлер создаёт симлинки ~/.claude/{skills,agents,commands,templates} → code/datarim/<scope>/. Runtime ИС repo: правка любого файла в ~/.claude/ сразу видна как git diff — никакого drift, никакой ручной синхронизации.

Существующая copy-mode установка? Инсталлер обнаружит и предложит конвертацию (3 опции: convert / keep / abort) с авто-бэкапом.

Personal additions / overrides — gitignored overlay ~/.claude/local/{skills,agents,commands,templates}/. При name-conflict local перебивает framework.

Уже установлен Datarim? Обновите до последней версии:

cd /path/to/datarim
./update.sh                      # topology-aware: symlink → git pull, copy → install --copy --force --yes

Перейдите в любой проект и запустите Claude Code:

cd /path/to/your/project
claude

# Внутри Claude Code:
/dr-init Добавить переключатель темы на страницу настроек

Datarim анализирует запрос, определяет сложность (L1-L4) и созд��ёт трекинг задачи в datarim/.

С v2.7.0: Step 2.5b — мягкое предупреждение о пересечении темы с уже ожидающими элементами бэклога, чтобы вы не создали дубль ID для одной и той же работы. Совет ничего не блокирует — вы решаете дубль / уточнить scope / ортогонально перед стартом.

Не каждая задача проходит все 8 стадий. Datarim ма��шрутизирует по сложности:

После /dr-init в проекте появляется:

your-project/
├── datarim/                 # состояние workflow (в .gitignore)
│   ├── tasks.md             # активные задачи
│   ├── backlog.md           # очередь задач
│   ├── activeContext.md     # текущий фокус
│   ├── progress.md          # обзор прогресса
│   ├── insights/            # результаты исследований
│   └── ...                  # prd/, creative/, reflection/
└── documentation/
    └── archive/             # завершённые задачи (коммитить)
        ├── web/
        ├── infrastructure/
        └── ...

datarim/ — локальное состояние workflow, добавьте в .gitignore. documentation/archive/ — история проекта, коммитьте в git.

Файл исходного задания и журнал вопросов (v2.9.0): /dr-init сохраняет ваш исходный промт в datarim/tasks/{ID}-init-task.md дословно. Каждое последующее уточнение — вопрос агента и ваш ответ — автоматически попадает в раздел «Дополнения» этого файла как структурированный блок «Q&A by /dr-<стадия>». Если вы не ответили, агент примет решение сам по лучшим практикам и запишет обоснование длиной не менее 50 символов; стадия проверки качества сверит каждое такое решение с реализацией.

Расширяйте Datarim opt-in плагинами через /dr-plugin. Каждый plugin — каталог с plugin.yaml + поддиректории {skills,agents,commands,templates}/. Подключение создаёт симлинки в namespace ~/.claude/<cat>/<plugin-id>/.

/dr-plugin list                              # активные
/dr-plugin enable /path/to/my-plugin     # включить локальный плагин
/dr-plugin disable my-plugin              # отключить
/dr-plugin sync                              # реконсиляция runtime ↔ manifest
/dr-plugin doctor [--fix]                    # 9 health checks

Manifest активного набора: datarim/enabled-plugins.md. Pre-mutation snapshot/rollback на каждый enable. Подробности — страница команды →

Secure-by-default контракт для сетевых биндингов: docker-compose ports, redis.conf bind, postgresql.conf listen_addresses, systemd .socket. Public-by-default = breach-by-default; новый skill network-exposure-baseline.md формализует tier model с TTL-bounded waivers.

Локальная проверка перед commit:

dev-tools/network-exposure-check.sh \
  --compose docker-compose.yml \
  --redis-conf redis.conf \
  --postgres-conf postgresql.conf
# exit 0 — clean; exit 1 — violation

Reusable CI workflow в .github/workflows/ci.yml:

jobs:
  network-exposure:
    uses: Arcanada-one/datarim/.github/workflows/network-exposure-lint.yml@main
    with:
      compose-paths: 'docker-compose.yml,docker-compose.prod.yml'

Pipeline-команды (/dr-prd, /dr-plan, /dr-do, /dr-archive) автоматически загружают skill при network-сурфейс изменениях. Tiered gate: P0 / security / infrastructure / framework-hardening tasks → hard_block; иначе → advisory_warn с операторским override.

Когда требования оператора неполные, сложные или неоднозначные, агент не должен останавливаться и эскалировать без необходимости. Восемь канонических правил (FB-1..FB-8) задают автономное поведение под Supreme Directive Laws 1-5. Mandate существует в экосистемном CLAUDE.md потребителя (canonical text + audit tagging), а Datarim ships только машиночитаемый контракт-блок.

Машиночитаемый policy-блок:

plugins/dr-orchestrate/rules/fb-rules.yaml
# rules: 8 × {rule_id, enforcement_layer, tier, default_action,
#               reversibility_required, audit_required, conflicts_with_law}
# hard_gated_actions: [prod_deploy, secret_rotation, irreversible_db_op,
#                      public_communication, finance_action, legal_action,
#                      force_push_main, git_history_delete, multi_user_visible_action]

Hierarchy: Supreme Directive (Laws 1-5) > Autonomous Agent Operating Rules > AAL Mandate > project-specific mandates. hard_gated_actions NEVER auto-execute независимо от FB-5. Loader: scripts/rules_loader.sh § load_fb_policy() / load_fb_hard_gates().