К основному содержанию
скилл CX Codex

codependix-configure — скилл для Claude Code: как установить

Скилл codependix-configure помогает создавать и править файлы codependix.config.ts для экспорта графов архитектуры и проверки правил зависимостей в проекте.

MIT 364 установок обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add organizzolini/codebase --skill codependix-configure -a claude-code
Открыть на GitHub

Что делает codependix-configure

Codependix не создаёт отчёты по умолчанию. Утилите обязательно передавать путь через флаг --config <path>, потому что поиск файла вверх по каталогам отключён. Скилл помогает составить конфигурацию на TypeScript или JSON, настроить глобальные параметры и точечные переопределения для отдельных пакетов.

Поле общих настроек пишется только во множественном числе — defaults. Если написать default, загрузчик отбросит ключ без ошибки из-за конфликта с экспортом модуля, и параметры не применятся. Целевой формат вывода задаётся явно: markdown, json или both.

Без явной строки include: ["**"] запуск завершится с нулевым кодом, но вообще ничего не запишет на диск. Скилл помогает задать корректные маски поиска, исключить ненужные директории через exclude и встроить блоки графов в README.md через анкоры.

Какие задачи решает

  • составить рабочий codependix.config.ts с нуля для монорепозитория
  • исправить тихий пропуск экспорта графов из-за отсутствия блока include
  • настроить экспорт схем зависимостей Nx и NestJS в Markdown через анкоры
  • задать правила архитектурных границ для проверки связей между проектами

Примеры запросов агенту

  • Создай codependix.config.ts для экспорта графов Nx и NestJS в README.md
  • Почему codependix завершается без ошибок, но не создаёт файлы с графами?
  • Настрой экспорт архитектурного графа пакета widgets в отдельный JSON-файл

Как установить codependix-configure

1Через Skills CLI (Vercel)

npx skills add organizzolini/codebase --skill codependix-configure -a claude-code

2Вручную: положить файлы

~/.claude/skills/codependix-configure/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/codependix-configure/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о codependix-configure

Как установить codependix-configure в Claude Code?

Выполните команду npx skills add organizzolini/codebase --skill codependix-configure -a claude-code.

Что делает codependix-configure?

Скилл генерирует и проверяет конфигурационные файлы Codependix, настраивая правила изоляции и форматы экспорта графов.

Почему общие настройки нужно писать как defaults, а не default?

Загрузчик конфигурации распаковывает экспорт по умолчанию, поэтому ключ default конфликтует с кодом загрузки и молча игнорируется.

Исходный текст

SKILL.md · MIT
---
name: codependix-configure
description: Write or edit a codependix.config.ts — which graph types run, per-project overrides, include and exclude globs, the whole-workspace graph, where each export lands, and the boundary rules every built graph is judged against. Use when a workspace has no codependix configuration yet, when a run produced no output because everything resolved to target none, when adding a JSON or Markdown destination, when choosing between an anchor block and a standalone file, when a configuration is rejected for a missing destination or an empty selector, when adding a forbid, allow, or acyclic rule, when registering the per-project Nx gate, or when deciding whether one configuration can describe every project in a workspace.
license: MIT
---

# Writing a codependix configuration

Codependix produces nothing until a configuration tells it what to export and
where. Every field of the file is optional, but the file itself never is: every
run names it with `--config <path>` (in this repository,
`--config configuration/codependix.config.ts`), and a run naming none
is refused. A configuration that leaves out `include` resolves every graph type
for every project to `target: "none"` — a successful run that writes nothing.
The configuration is the whole control surface; there is no flag that selects a
graph type.

```ts
import { type CodependixConfiguration } from "@codependix/configuration";

const codependixConfiguration: CodependixConfiguration = {
  defaults: {
    imports: { markdown: { anchor: "codependix-file-imports" }, target: "markdown" },
    nestjs: { markdown: { anchor: "codependix-nestjs-modules" }, target: "markdown" },
    nx: { markdown: { anchor: "codependix-nx-projects" }, target: "markdown" },
  },
  exclude: ["fixtures/**"],
  include: ["**"],
  projects: {
    widgets: {
      nx: {
        json: { path: "output/nx-graph.json" },
        markdown: { anchor: "codependix-nx-projects", path: "docs/architecture.md" },
        target: "both",
      },
    },
  },
  workspace: {
    nx: { markdown: { anchor: "codependix-workspace" }, target: "markdown" },
  },
};

export default codependixConfiguration;
```

## Where the file is found

Nowhere: it is named. `--config <path>` is required, with no default filename,
no search, and no walk upward, so `codependix map --write --config
configuration/codependix.config.ts` reads that file and nothing else.
Any extension in `ts`, `mts`, `cts`, `js`, `mjs`, `cjs`, or `json` loads; a
neighboring file is never read in its place.

- **A path given with `--config` must exist.** A typo fails the run rather than
  quietly resolving every graph to `"none"`. It is resolved against the working
  directory first, then against the workspace root, so a configuration kept in
  a `configuration/` folder can be named relative to either.
- **A missing `--config` fails the run too.** The flag is required: omitting
  it is refused with an error naming `--config`, and nothing falls back to a
  `codependix.config.ts` at the workspace root.

A project's own `codependix.config.ts` is the one file that is found rather
than named: it is read from beside the project root, never from a parent, and a
project without one produces no per-project output.

## `defaults`, never `default`

The field that applies to every project naming no override of its own is
spelled **`defaults`**. A configuration module's default export is unwrapped by
name while loading, so a field called `default` would collide with that
unwrapping. A configuration that writes `default:` is not rejected — unknown
keys are stripped rather than refused, so a newer configuration still loads
under an older codependix — it simply has no effect at all, which reads exactly
like a tool that ignored it.

## `target` is explicit

Each graph type's export target is named, never inferred from which
destinations are present:

| `target` | Writes |
| -------- | ------ |
| `"both"` | The JSON and the Markdown destination together |
| `"json"` | The JSON destination only |
| `"markdown"` | The Markdown destination only |
| `"none"` | Nothing — and the default for every unset target |

That explicitness is what lets a project keep a `json` destination it is not
ready to write yet: leave the destination in place and set `target: "markdown"`.

The configuration is validated, and two mismatches are rejected rather than
ignored:

- A `"both"` or `"json"` target with no `json` destination.
- A `"both"` or `"markdown"` target with no `markdown` destination.

## Markdown has two shapes

```ts
// Anchor mode — spliced into a named block inside an existing file.
{ markdown: { anchor: "codependix-nx-projects" }, target: "markdown" }

// Anchor mode, in a file other than the default README.md.
{ markdown: { anchor: "codependix-nx-projects", path: "docs/graphs.md" }, target: "markdown" }

// Standalone mode — the export is the whole contents of the file.
{ markdown: { path: "output/graph.md" }, target: "markdown" }
```

- **Naming an `anchor`** splices the export between two comment markers inside
  the file at `path`, which **defaults to `README.md`** — the common case is a
  project's own readme, so it is worth not repeating.
- **Leaving `anchor` unset** writes the export as the entire contents of a
  standalone file, and `path` is then **required**: there is no default worth
  guessing for a file codependix owns outright.
- A `markdown` destination naming neither is rejected, since nothing would say
  where the export goes.

A missing anchor block is auto-created on `--write`, so anchors do not have to
be placed by hand first. See the `codependix-triage` skill for exactly where a
new block lands and what still fails.

Paths in both destinations resolve relative to the **project's own root**, so
one `defaults` entry describes every project without naming any of them. The
whole-workspace graph resolves relative to the workspace root instead.

## `include` and `exclude`

Both are lists of globs matched against **a project's Nx name and its
workspace-relative root**, so either spelling works:

```ts
{ exclude: ["examples/**", "*-fixtures"], include: ["**"] }
```

`include` defaults to **nothing** and `exclude` to empty, so leaving both out
means no project participates and the run exports nothing. Participation is
always declared: write `include: ["**"]` to cover the whole workspace. A
project is included when at least one `include` glob claims its name or root
and no `exclude` glob claims either.

`--projects` and `--tags` widen this from the command line — a project either
list names participates even when no `include` glob claims it, and `exclude`
still wins over both. See `codependix-export`.

A configuration naming `defaults` but no `include` is the one to watch for.
It exports nothing while still exiting zero, and `--check boundaries` judges
every project regardless of `include` — or the projects `--projects` and
`--tags` name — so the gate stays green. An export run
warns when it happens — `🕸️ Selected no project to export`.

An excluded project resolves to `target: "none"` for every graph type
regardless of what `defaults` or its own `projects` entry says — so excluding a
project takes one line rather than rewriting each of its overrides to `"none"`.

## A project override replaces, it does not merge

When a `projects` entry names a graph type, that entry **replaces** the
`defaults` entry for that graph type outright — it is not merged field by
field. A project turning its Markdown export off by omitting `markdown` should
not have the default's `markdown` destination resurface underneath it.

The practical consequence: an override has to restate every destination it
still wants, including the `target`.

```ts
{
  defaults: { nx: { markdown: { anchor: "codependix-nx-projects" }, target: "markdown" } },
  projects: {
    // Loses the Markdown export entirely — this is the whole nx entry now.
    widgets: { nx: { json: { path: "graph.json" }, target: "json" } },
    // Keeps both, because both are restated.
    gadgets: {
      nx: {
        json: { path: "graph.json" },
        markdown: { anchor: "codependix-nx-projects" },
        target: "both",
      },
    },
  },
}
```

Graph types the override does not mention still fall back to `defaults`; the
replacement is per graph type, not per project.

## The whole-workspace graph

`workspace` is separate from `defaults` and `projects`, and accepts only `nx`:

```ts
{ workspace: { nx: { markdown: { anchor: "codependix-workspace" }, target: "markdown" } } }
```

There is no workspace-wide NestJS or import graph to configure. The workspace
graph is exported once for the repository, carries no per-project override, and
is **unaffected by `include` and `exclude`** — excluding a project from
per-project exports does not remove it from the workspace graph.

`--projects` and `--tags` are the exception, and they reach it through its
**node set** rather than through its destination: a run naming a selection
draws the graph over the projects it named, and writes it wherever
`workspace.nx` says. See `codependix-export` for both flags.

## `projectGraph` — reading a graph rather than resolving one

```ts
{ projectGraph: "artifacts/graph.json" }
```

A path, relative to the workspace root, to the JSON
`nx graph --file=graph.json` emits. Named, it is read instead of resolving the
process working directory's own graph — the only way to graph a workspace the
process is not standing in. Left out, nothing changes.

The file is **trusted**: only a file that is not a project graph at all is
refused. See `codependix-export` for what that does and does not cover.

## Configuring a graph type a project does not have costs nothing

A project that is not a NestJS project never appears in the NestJS pass; a
project with no `tsconfig.json` never appears in the TypeScript import pass.
Neither is a failure and neither needs an override, so a single `defaults`
block naming all four graph types is the normal shape of a
whole-workspace configuration rather than an over-broad one.

## `boundaries` — the rules the graphs are judged against

`defaults` and `projects` say where an export is **written**. `boundaries` says
what the graphs must **look like**, keyed by the same four graph levels, and is
gated by `--check boundaries` rather than by `--check reports`.

```ts
const codependixConfiguration: CodependixConfiguration = {
  boundaries: {
    imports: [
      {
        from: { path: ["**/*.types.ts"] },
        kind: "forbid",
        message: "Types are the leaf of a module.",
        name: "types-files-do-not-reach-services",
        to: { path: ["**/*.service.ts"] },
      },
    ],
    nx: [
      {
        from: { tags: ["type:application"] },
        kind: "forbid",
        name: "applications-are-leaves",
        to: { tags: ["type:application"] },
      },
      { kind: "acyclic", name: "no-project-cycles" },
    ],
  },
};
```

Three kinds:

| Kind | Reports |
| ---- | ------- |
| `forbid` | An edge whose source matches `from` and whose target matches `to` |
| `allow` | An edge leaving `from` for anywhere `to` does not claim |
| `acyclic` | A cycle among the nodes `nodes` selects, defaulting to every node |

A selector's four fields are all lists of globs, and they **narrow** each
other — every field a selector states must match, while within one field one
glob matching is enough:

| Field | Matches | Carried at |
| ----- | ------- | ---------- |
| `id` | The node's identifier — a project name, a file path, or a module class name | every level |
| `path` | A workspace-relative project root, or a project-relative file path | `nx`, `imports`, `pythonImports` |
| `project` | The Nx project a node belongs to | `nx`, `imports`, `pythonImports` |
| `tags` | The node's Nx tags; one tag matching is enough | `nx` |

An access rule may also narrow **which edges** it judges, with `edges`:
`{ implicit: false }` sees only edges backed by an import statement — exactly
what an `@nx/enforce-module-boundaries` `depConstraint` sees — and
`{ implicit: true }` sees only the ones an `implicitDependencies` entry
declares. Unset judges both, which is the stricter reading. Only the Nx level
draws an implicit edge.

Four things to know before writing one:

- **A selector naming a field its level does not carry matches nothing**, not
  everything. A `path` rule at the `nestjs` level selects no module, because
  the NestJS module graph is class names with no file paths at all.
- **A selector stating no field is refused** by the schema. It reads exactly
  like a typo, and reading it as "every node" would silently widen a rule to
  the whole workspace.
- **`message` is appended to the generated sentence, not substituted for it.**
  Write it as the _why_; the _what_ — the rule name and both endpoints — is
  always generated.
- **A level with no rules is never built.** Declaring `nestjs` rules means
  every container is booted in preview mode, and declaring `imports` rules
  means a `ts.Program` per project. Declare only the levels you actually gate.

**Write rules that already hold.** A rule that arrives red is a backlog rather
than a gate, and a red pipeline nobody can act on teaches people to ignore it.
Verify a candidate rule against the whole workspace before committing it.

### Which project a finding fails

A finding is charged to projects, and a run fails only when one is charged to a
project it judges. The rule kind decides who that is:

| Finding | Charged to |
| ------- | ---------- |
| `forbid` match, or an edge no `allow` rule covers | The project owning the edge's **source**, and no other |
| `acyclic` cycle | Every project owning a node on the cycle, so a cycle across A and B fails both |
| Container that cannot boot | The project whose container failed, named with the owner of the failing class when that is another project |

A project that merely depends on a project with a cycle or a forbidden edge is
not failed: it sees the finding as a note, "in dependency". So a rule is
written with the source project in mind — it is the one that has to change. A
container that cannot boot is the exception: a dependent whose own container
fails because a dependency's class could not evaluate fails too, since its
container really cannot boot, and its failure names that dependency as the
owner.

## The per-project gate

In an Nx workspace the `@codependix/nx` plugin infers a `codependix-bound` target
for every project described by a `project.json`, except the workspace root. It
runs `--check boundaries --projects <project>` over that project and its
dependencies. A project Nx infers from a `package.json` alone gets no gate until
it is given a `project.json`. Register the plugin once in `nx.json`:

```json
{
  "plugins": [
    {
      "plugin": "@codependix/nx",
      "options": {
        "configurationPath": "configuration/codependix.config.ts",
        "gateTargetName": "codependix-bound"
      }
    }
  ]
}
```

`configurationPath` names the one configuration every gate reads, and it is
required: a registration without it fails with an error naming the option, and
no `codependix.config.ts` at the workspace root is assumed. A gate target can
override it with the executor option `configuration` (not Nx's own
`--configuration` flag, which selects `check` or `write`); a blank value is
refused, naming that option. Nothing else is configured per project: the rules in `boundaries`
judge every project the same way. See `codependix-export` for running a gate.

The gate runs the command line under the `@swc-node/register` hooks the plugin
registers itself, so the workspace installs nothing for them. The workspace root
does need a `tsconfig.json` that emits decorator metadata, because the hooks
read it from the working directory and NestJS constructor injection depends on
it.

The gate is cached. A project's own `codependix.config.*` is one of its cache
inputs, so editing it re-runs that gate. So is the codependix command line
itself: its `package.json` and sources when it is a package of the workspace, or
its installed version when it comes from a registry. So is the workspace root's
`tsconfig.json`, which the loader reads. Test files are not inputs, so a
test-only edit to the tool invalidates no gate beyond that package's own and
its dependents', while any other edit re-runs them all. A package the plugin
cannot resolve loses only its own inputs, and Nx's logger warns naming it.

A gate whose `projects` or `tags` select anything other than its own project —
on the command line, in the target's options, or in a named Nx configuration —
is never replayed from the cache, because it judges projects its inputs do not
cover. A gate judging only its own project is cached as usual.

© organizzolini · MIT · organizzolini/codebase

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
devkit.typescript.code-review Giuseppe Trisciuoglio Команда devkit.typescript.code-review проводит аудит TypeScript-монорепозиториев на Nx с бэкендом NestJS, веб-клиентом React и мобильными приложениями React Native. CX Codex +1 ★ 372звёзд репо nx-monorepo giuseppe-trisciuoglio Скилл nx-monorepo для Claude Code, Codex, Cursor и других AI-агентов, который берёт на себя управление Nx монорепо в TypeScript/JavaScript проектах. CX Codex +1 4 000установок nx-import nrwl Скилл nx-import помогает переносить сторонние репозитории и папки в существующий монорепозиторий Nx с сохранением истории Git. CX Codex +1 2 800установок tanstack-config tanstack-skills Скилл tanstack-config помогает настроить сборку, версионирование и публикацию пакетов JavaScript и TypeScript по стандартам TanStack. Пригодится при настройке монорепозитория на pnpm и Nx. CX Codex +1 1 500установок add-package davila7 Команда add-package разворачивает новый пакет в монорепозитории с готовой структурой папок, tsconfig.json и регистрацией в nx.json или lerna.json. CX Codex +1 198установок technology-stack ag-grid Скилл technology-stack для Claude Code описывает выбор технологий и архитектурные ограничения AG Grid. Агент подключает его при выборе стека и добавлении зависимостей. CX Codex +1 1установок

Из того же набора13

Весь набор →
conformetry-generate Скилл conformetry-generate заставляет агента генерировать модули, компоненты и сервисы через conformetry, а не писать файлы руками. Полезен, когда в воркспейсе уже есть конфигурация conformetry. CX Codex +1 672установок conformetry-configure Скилл conformetry-configure для Claude Code настраивает генераторы conformetry и создаёт шаблоны файлов. Описывает правила генерации и исправляет ошибки путей в сгенерированном коде. CX Codex +1 671установок conformetry-validate Скилл conformetry-validate запускает проверку сгенерированного кода на соответствие шаблонам conformetry и подсказывает, как устранить расхождения. Помогает найти пропущенные файлы и декораторы. CX Codex +1 670установок codependix-export Скилл codependix-export для Claude Code запускает экспорт графов зависимостей codependix и проверку архитектурных границ. Выполняет режимы проверки отчётов, целостности связей и записи артефактов. CX Codex +1 364установок codependix-navigate Скилл codependix-navigate учит агента отвечать на вопросы о зависимостях: как проект A доходит до C, что сломается при правке файла. Через codependix path или графы, уже лежащие в репозитории. CX Codex +1 364установок codometer-measure Скилл codometer-measure для запуска codometer и разбора его отчётов: подсказывает агенту, как задать конфиг, куда писать JSON и badge-блок и как поставить гейт в CI. CX Codex +1 363установок codependix-triage Скилл codependix-triage для Claude Code разбирает сбои и расхождения архитектурных графов codependix. Включается при падении таргетов codependix-bound, нарушении границ модулей или устаревших диаграммах. CX Codex +1 363установок codometer-configure Скилл codometer-configure помогает писать и менять codometer.config.ts: задавать лимиты, входы, исключения и форматы отчёта для Codometer. CX Codex +1 363установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой