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

infra-audit — скилл для Claude Code: что делает и как установить

Скилл infra-audit сканирует docker-compose, env-файлы, ORM-конфиги и строки подключения, чтобы собрать карту инфраструктуры проекта и найти, какого слоя не хватает.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает infra-audit

Скилл проходит по docker-compose.yml, .env-файлам, конфигам Prisma, Drizzle, TypeORM, Sequelize, Knex, SQLAlchemy, Django и Rails, а также ищет клиентские библиотеки Redis, RabbitMQ, Kafka, NATS, S3, Elasticsearch и внешних API вроде Stripe или Twilio. Для каждой найденной системы он фиксирует тип, путь к конфигу, способ подключения и модули, которые её используют, а затем строит граф связей приложения с базами, кешем и очередями.

На втором шаге он ищет признаки нехватки инфраструктуры: повторяющиеся одинаковые запросы к базе в разных обработчиках как сигнал для кеша, setTimeout/setInterval для отложенной работы как сигнал для очереди задач, поиск через LIKE '%term%' на больших таблицах как сигнал для поискового движка. Флаг ставится только если в коде есть конкретное подтверждение, а не по догадке.

Результат сохраняется в .planning/infra-manifest.md: список систем, граф связей, обнаруженные паттерны доступа и список возможностей с оценкой усилий. Если репозиторий без docker-compose и env-файлов, скилл переключается на поиск захардкоженных строк подключения в src/, lib/ и config/.

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

  • составить карту всех баз, кешей и очередей в проекте
  • понять, с какими системами связан незнакомый кодбейс перед онбордингом
  • найти места, где не хватает кеша, очереди задач или поискового движка
  • подготовить инфраструктурный манифест перед планированием мультирепозиторной задачи
  • обнаружить расшаренные базы данных между несколькими сервисами в монорепозитории

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

  • Запусти /infra-audit и покажи, с какими системами связан этот проект
  • Проведи /infra-audit перед тем, как добавлять новую базу данных
  • Собери через /infra-audit манифест инфраструктуры и список возможностей

Как установить infra-audit

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill infra-audit -a claude-code

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

~/.claude/skills/infra-audit/SKILL.md

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

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

Вопросы об infra-audit

Как установить infra-audit в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local.

Что делает infra-audit?

Скилл сканирует docker-compose, env-файлы, ORM-конфиги и строки подключения, строит граф связей приложения с базами, кешем и очередями, а затем выводит манифест с найденными системами и недостающими слоями инфраструктуры.

На основе чего infra-audit предлагает добавить кеш или очередь задач?

Он ищет конкретные признаки в коде — например, одинаковые запросы к базе в нескольких обработчиках или setTimeout/setInterval для отложенной работы — и флагует недостающий слой только при наличии такого подтверждения.

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

SKILL.md · MIT
---
name: infra-audit
license: MIT
description: >-
  Reads docker-compose, env files, ORM configs, and connection strings to map
  current infrastructure. Flags missing layers (cache, queue, analytics) based
  on observed access patterns. Outputs a structured infrastructure manifest.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - infra
  - infrastructure
  - what databases
  - what systems
  - docker-compose
  - infra audit
  - map infrastructure
  - what does this connect to
last-updated: 2026-03-29
---

# /infra-audit -- Infrastructure Auditor

## When to Use

- Before adding a new database, cache, or queue to a project
- When onboarding to an unfamiliar codebase and need to understand its infra
- Before planning a workspace campaign that spans multiple services
- When someone asks "what systems does this project talk to?"

**Do not use when:**
- The user already knows the infra and just wants to wire something up (use `/architect`)
- The question is about code architecture, not infrastructure (use `/research`)

## Protocol

### Step 1: DISCOVER

Scan the project for infrastructure configuration files. Check each category:

**Container orchestration:**
- `docker-compose.yml`, `docker-compose.*.yml`
- `Dockerfile`, `*.dockerfile`
- `k8s/`, `kubernetes/`, `helm/`, `charts/`

**Environment and secrets:**
- `.env`, `.env.*`, `.env.example`, `.env.local`
- `*.env` files in config directories

**Database and ORM:**
- Prisma: `prisma/schema.prisma`
- Drizzle: `drizzle.config.ts`, `drizzle/`
- TypeORM: `ormconfig.*`, `data-source.ts`
- Sequelize: `.sequelizerc`, `config/database.*`
- Knex: `knexfile.*`
- SQLAlchemy: `alembic.ini`, `alembic/`
- Django: `settings.py` (DATABASES section)
- Rails: `config/database.yml`
- Go: look for `pgx`, `gorm`, `sqlx` in go.mod

**Message queues and event streaming:**
- Redis: connection strings, `ioredis`, `redis` in package.json/requirements.txt/go.mod
- RabbitMQ: `amqplib`, `pika`, `amqp` imports
- Kafka: `kafkajs`, `confluent-kafka`, `sarama` imports
- NATS: `nats`, `nats.go` imports
- SQS/SNS: `@aws-sdk/client-sqs`, `boto3` sqs references

**Cache:**
- Redis (dual-use -- note if used as cache vs. pub/sub vs. primary store)
- Memcached: `memcached`, `pylibmc` imports

**Search:**
- Elasticsearch: `@elastic/elasticsearch`, `elasticsearch-py`
- Meilisearch, Typesense, Algolia client libraries

**Object storage:**
- S3: `@aws-sdk/client-s3`, `boto3` s3 references
- MinIO, GCS, Azure Blob client libraries

**External APIs:**
- Stripe, Twilio, SendGrid, Auth0, Firebase, Supabase client libraries
- Any `NEXT_PUBLIC_*` or `VITE_*` env vars pointing to external services

**CI/CD:**
- `.github/workflows/`, `.gitlab-ci.yml`, `Jenkinsfile`, `bitbucket-pipelines.yml`

For each discovered item, record:
- **What**: the system (e.g., "PostgreSQL 15")
- **Where**: config file path and line
- **How**: connection method (direct, pooled, ORM, SDK)
- **Role**: primary store, cache, queue, search, auth, etc.

### Step 2: TRACE CONNECTIONS

For each discovered system, trace how the application connects:

1. Find connection strings in env files or config
2. Find the client initialization code (imports, `new Client()`, `createPool()`)
3. Identify which modules/services use this connection
4. Note connection pooling, retry logic, health checks if present

Build a connection graph:
```
App --> [pool: 10] --> PostgreSQL (primary store)
App --> [ioredis]  --> Redis (cache + pub/sub)
App --> [SDK]      --> Stripe (payments)
```

### Step 3: ANALYZE PATTERNS

Based on what's connected and how it's used, identify:

**Access patterns:**
- Read-heavy vs. write-heavy (look at query patterns in ORM usage)
- Real-time vs. batch (WebSocket/SSE presence, cron jobs)
- Request/response vs. event-driven (queue usage, webhook handlers)

**Missing layers** (flag only when evidence supports the need):

| Signal | Likely Missing | Evidence Required |
|---|---|---|
| Repeated identical DB queries in hot paths | Cache layer (Redis/Memcached) | Same query in 3+ request handlers |
| `setTimeout`/`setInterval` for deferred work | Job queue (Bull/BullMQ/Celery) | Processing that doesn't need to block the response |
| Full-text search via `LIKE '%term%'` | Search engine (Elasticsearch/Meilisearch) | Text search on >10K rows |
| Large file uploads stored in DB or local disk | Object storage (S3/MinIO) | Binary columns or `fs.writeFile` for user content |
| Analytics queries on production tables | Analytics DB (Snowflake/BigQuery/ClickHouse) | Aggregation queries mixed with OLTP |
| Multiple services sharing one DB | Event bus or API gateway | 2+ repos writing to same schema |
| No connection pooling | Connection pooler (PgBouncer) | Direct connections in serverless/high-concurrency |

**Do not flag something as missing unless the evidence is in the code.**

### Step 4: WRITE MANIFEST

Output the infrastructure manifest to `.planning/infra-manifest.md`:

```markdown
# Infrastructure Manifest

> Generated: {ISO date}
> Project: {project name from package.json or repo name}

## Current Systems

### {System Name} -- {Role}
- **Type**: {database|cache|queue|search|storage|auth|payments|...}
- **Product**: {PostgreSQL 15|Redis 7|Stripe SDK|...}
- **Config**: `{file path}`
- **Connection**: {method -- pooled, direct, SDK, ORM}
- **Used by**: {modules/services that import the client}

(repeat for each system)

## Connection Graph

{ASCII diagram of connections -- use /ascii-diagram conventions}

## Access Patterns

- {Pattern 1}: {evidence}
- {Pattern 2}: {evidence}

## Opportunities

### {Opportunity Title}
- **Signal**: {what in the code suggests this}
- **System**: {what would address it -- e.g., "Redis as cache layer"}
- **Impact**: {what improves -- latency, scalability, separation of concerns}
- **Effort**: low | medium | high

(repeat for each opportunity)

## Multi-Repo Considerations

{If the project references other repos, APIs, or shared databases, note them here.
This section feeds directly into /workspace if the user wants to act on opportunities
that span repos.}
```

### Step 5: RETURN

Present a summary to the user:
- How many systems found
- The connection graph (inline, not just in the file)
- Top opportunities ranked by signal strength
- Whether any opportunities would require multi-repo coordination (suggest `/workspace`)

## Fringe Cases

- **No docker-compose or env files**: Scan for hardcoded connection strings in source code.
  Many projects connect without formal config files. Check `src/`, `lib/`, `config/` for
  connection patterns. Note the absence of externalized config as a finding.
- **Monorepo with multiple services**: Treat each service directory as a separate scan target.
  Produce one manifest with sections per service. Note shared databases across services.
- **`.planning/` does not exist**: Create it before writing the manifest.
- **No infrastructure found**: Report that the project appears to be client-only or has no
  external dependencies. This is a valid finding, not an error.
- **Secrets in env files**: Never include actual secret values in the manifest. Record the
  variable name and which system it connects to, not the value.

## Contextual Gates

**Disclosure:** "Auditing infrastructure configuration. No files modified."
**Reversibility:** green — read-only audit; only writes `.planning/infra-manifest.md`; undo with `rm .planning/infra-manifest.md`.
**Trust gates:**
- Any: full audit, manifest generation, opportunity analysis.

## Quality Gates

- [ ] Every discovered system has: type, product, config path, connection method
- [ ] Connection graph covers all discovered systems
- [ ] Opportunities cite specific code evidence (file:line), not speculation
- [ ] No secret values appear in the manifest
- [ ] Manifest written to `.planning/infra-manifest.md`
- [ ] Multi-repo considerations section populated if cross-repo signals exist

## Exit Protocol

```
---HANDOFF---
- Scanned {N} config files, found {M} external systems
- Key systems: {list top 3-4}
- Top opportunity: {highest-signal opportunity}
- Multi-repo scope: {yes/no -- if yes, suggest /workspace}
- Reversibility: green — delete .planning/infra-manifest.md to undo
---
```

© SethGammon · MIT · SethGammon/Citadel

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

Все скиллы по теме «DevOps и инфраструктура» →
docker-compose-production TheBushidoCollective Скилл docker-compose-production готовит конфигурации Docker Compose для продакшена: задаёт лимиты ресурсов, проверки healthcheck, ротацию логов, секреты и изоляцию сетей. CX Codex +1 487установок infra-deploy terrylica Скилл infra-deploy разворачивает self-hosted Cal.com в GCP Cloud Run с базой Supabase PostgreSQL или поднимает его локально через Docker Compose. CX Codex +1 119установок spring-boot-project-creator giuseppe-trisciuoglio Скилл spring-boot-project-creator для Claude Code автоматизирует создание проектов Spring Boot 3.x/4.x через Spring Initializr с выбором архитектуры DDD или слоистой, настройкой JPA, OpenAPI и сервисов Docker Compose. CX Codex +1 3 700установок docker-compose-orchestration manutej Скилл docker-compose-orchestration помогает описывать многоконтейнерные приложения в Docker Compose: сервисы, сети, тома, healthcheck и порядок запуска. CX Codex +1 3 000установок service-architecture fcakyon Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса. CX Codex +1 ★ 1 216звёзд репо infisical-self-host Infisical Скилл infisical-self-host помогает развернуть и настроить серверную платформу Infisical в Docker Compose или Kubernetes. Пригодится при настройке базы данных PostgreSQL, очередей Redis и параметров безопасности. CX Codex +1 834установок

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

Весь набор →
fleet Субагент fleet для Claude Code делит работу на кампании и ведёт их волнами по 2–3 агента, передавая находки следующей волне. Разбивает задачи, не пересекающиеся по файлам. CX Codex ★ 937звёзд репо workspace Скилл workspace координирует изменения в нескольких репозиториях в рамках одной задачи. Разбивает работу на волны, запускает кампании по репозиториям, проверяет контракты между ними. CX Codex +1 ★ 937звёзд репо create-skill Скилл create-skill интервьюирует разработчика и упаковывает повторяющийся сценарий в готовый SKILL.md с проверкой на реальном коде проекта. CX Codex +1 ★ 937звёзд репо arbiter arbiter — субагент для Claude Code, который повторно запускает проверки проекта и выносит итоговый вердикт по изменениям. Его подключают после исчерпания повторных попыток рабочего агента или для оценки целостности результата. CX Codex ★ 937звёзд репо refactor Скилл refactor для Claude Code выполняет рефакторинг нескольких файлов с автооткатом через Git, проверкой типов и тестами до и после правок. CX Codex +1 ★ 937звёзд репо review Скилл review проводит код-ревью в пять проходов: проверяет корректность, безопасность, производительность, читаемость и согласованность кода. Подходит для проверки файла, каталога или изменений Git. CX Codex +1 ★ 937звёзд репо schedule Ставит повторяющиеся и разовые задачи по cron: по умолчанию пишет запись в Task Scheduler или Unix cron, а не расходует квоту routine-запусков. CX Codex +1 ★ 937звёзд репо qa Скилл qa запускает браузер через Playwright, проходит пользовательские сценарии веб-приложения и сохраняет отчёт со скриншотами. CX Codex +1 ★ 937звёзд репо

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

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