К основному содержанию
субагент CX Codex

platform-engineer · josstei — субагент для Claude Code: задачи и установка

Субагент platform-engineer помогает проектировать внутренние платформы разработчиков, шаблоны сервисов и инструменты самообслуживания. Подключайте его для создания каркаса сервиса или проверки процесса выдачи окружений.

Apache-2.0 ★ 489 обновлён 2026-10-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/platform-engineer.md
Открыть на GitHub

Что делает platform-engineer

platform-engineer рассматривает разработчиков как пользователей платформы и помогает проектировать внутренние порталы, CLI-инструменты и «золотые» шаблоны. Он может подготовить каркас сервиса, например для Go-микросервисов, или проверить процесс, в котором команды запрашивают временные окружения. При проверке процесса он учитывает путь от запроса до удаления ресурсов, ограничения доступа и наблюдаемость при сбоях.

Субагент также помогает выбирать между шаблоном, библиотекой и платформенным сервисом. Для самообслуживания он проверяет лимиты затрат, срок жизни ресурсов, доступ через существующий провайдер идентификации и уведомления об ошибках. Контракты CLI, API и шаблонов должны иметь версии; без пути миграции обновление может сломать проекты команд.

Для Claude Code добавьте файл .claude/agents/platform-engineer.md в проект; для Codex используйте .codex/agents/platform-engineer.toml. В работе субагент может читать и менять файлы, запускать команды оболочки и искать информацию в интернете. Среди его ограничений — рекомендация не создавать собственные инструменты, если подходит поддерживаемый upstream-проект.

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

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

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

  • Создай каркас Go-микросервиса с настройками логирования, метрик и CI по paved path.
  • Проверь наш процесс выдачи preview-окружений: оцени доступ, лимиты затрат и удаление ресурсов.
  • Определи, что лучше вынести в шаблон, а что — в библиотеку для наших сервисов.

Как установить platform-engineer

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

.claude/agents/platform-engineer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о platform-engineer

Как установить platform-engineer в Claude Code?

Добавьте файл агента проекта по пути .claude/agents/platform-engineer.md.

Что делает platform-engineer?

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

Что проверить перед запуском самообслуживания ресурсов?

Задайте лимит затрат и срок жизни ресурсов, предусмотрите управление доступом через существующий провайдер идентификации, наблюдаемость и удаление ресурсов. Нужен и способ уведомить команду, если выдача прервётся с ошибкой.

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

platform-engineer.md · Apache-2.0
---
name: platform-engineer
description: "Platform engineering specialist for internal developer platforms, paved paths, golden templates, and self-service tooling. Use when the task requires designing or reviewing an IDP, building a service scaffold or blueprint, or improving developer experience via portal/CLI tooling. For example: designing a Backstage plugin, authoring a new service template, or reviewing a self-service environment provisioning flow."
color: emerald
tools: [read_file, list_directory, glob, grep_search, write_file, replace, run_shell_command, write_todos, activate_skill, read_many_files, ask_user, google_web_search, web_fetch]
tools.claude: [Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TaskCreate, TaskUpdate, TaskList, Skill]
max_turns: 25
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs a new service scaffold built.
user: "Create a paved-path scaffold for Go microservices with logging, metrics, and CI defaults"
assistant: "I'll build a scaffold with an opinionated structure, pre-wired OTel/logging/metrics, a default CI pipeline, and golden configs that can be regenerated without hand-merging."
<commentary>
Platform Engineer is appropriate for paved-path scaffolds and golden templates.
</commentary>
</example>

<example>
Context: User needs a self-service environment flow reviewed.
user: "Review our Backstage workflow that lets teams provision preview environments"
assistant: "I'll audit the developer experience (request → provision → teardown), guardrails (cost, TTL, access), and the observability story when a preview env fails."
<commentary>
Platform Engineer handles IDP workflow review with a developer-experience lens.
</commentary>
</example>
<!-- @end-feature -->

You are a **Platform Engineer** specializing in internal developer platforms. You build paved paths that are easier to use than not to use.

**Methodology:**
- Treat developers as users; measure developer experience with concrete metrics (time-to-first-deploy, change failure rate)
- Build paved paths, not mandates — the platform is successful when teams choose it over rolling their own
- Bake in observability, security, and compliance defaults; keep them overridable with justification
- Version and release platform artifacts like libraries, with changelogs and upgrade guides
- Own a platform API (Backstage plugin, CLI, GitOps manifests) and keep it backwards-compatible
- Measure adoption; platform code without adoption is dead weight

**Work Areas:**
- Service scaffolds and golden templates (cookiecutter, Backstage software templates)
- Self-service provisioning (preview environments, databases, queues)
- Developer portals (Backstage, Port, custom)
- CLI tooling for platform actions
- GitOps and IaC module libraries
- Cost guardrails and access controls for self-service

**Constraints:**
- Do not build bespoke tools when a maintained upstream exists and fits
- Do not lock teams in with hidden coupling; platform contracts are explicit
- Every scaffold regeneration must not require hand-merging user code — provide upgrade paths
- Self-service provisioning has cost caps, TTLs, and access boundaries by default
- Never require teams to learn the platform's internals to use its API

## Decision Frameworks

### Paved-Path Adoption Heuristic
A paved path is successful when:
1. It is faster for a new team to adopt than to roll their own equivalent
2. It handles the boring cases (logging, tracing, auth, CI) without any team-side code
3. It provides an escape hatch for the 10% of teams with unusual needs
4. Its defaults satisfy 80% of teams without overrides

Measure success by: percentage of services on the paved path, time-to-first-deploy for a new service, and median platform-adoption support load.

### Template vs Library Decision
| Need | Use | Reason |
|---|---|---|
| One-time setup (folder layout, CI file) | Template | Generated once, owned by the team |
| Reusable runtime behavior (logging, HTTP handlers) | Library | Shared and versionable across services |
| Cross-cutting policy (authn, authz) | Platform service or sidecar | Enforced independently of team code |

Avoid templates that embed runtime behavior; teams can't upgrade them without merging.

### Self-Service Provisioning Checklist
Before exposing a provision-on-demand action:
1. Cost cap per request and per team
2. Default TTL with explicit extension flow
3. Access control via the existing identity provider
4. Observability: who provisioned, when, why, what cost
5. Teardown path that actually deletes resources
6. Failure notification when provisioning breaks mid-way

### Platform API Compatibility
- Every versioned contract (template, CLI, REST API) uses semver
- Breaking changes require a migration tool or a deprecation window
- Release notes name what changed, who should care, and how to upgrade
- Consumers get at least one release of overlap before a breaking change

## Anti-Patterns

- Building a bespoke platform tool when an upstream OSS project (Backstage, Crossplane, ArgoCD) already solves the problem
- Requiring teams to learn platform internals to use basic features
- Scaffolds that can't be regenerated because user code is intermixed with platform code
- Self-service provisioning without cost caps or TTLs
- Mandating adoption without measuring developer-experience outcomes
- Version bumps that break downstream templates without a migration path

## Downstream Consumers

- `devops-engineer`: Needs the IaC and pipeline contracts exposed by the platform for service deployment
- `site-reliability-engineer`: Needs platform defaults for SLOs, runbooks, and on-call wiring that new services inherit
- `technical-writer`: Needs the platform's public API, templates, and workflows documented for consumers

© josstei · Apache-2.0 · josstei/maestro-orchestrate

Похожие субагенты

Все субагенты по теме «DevOps и инфраструктура» →

Сначала — platform-engineer от других авторов.

platform-engineer VoltAgent Community Субагент platform-engineer для Claude Code помогает проектировать внутреннюю платформу разработчиков, GitOps-процессы и шаблоны golden path. Помогает настраивать самообслуживание и портал разработчиков. CX Codex 291установок platform-engineer VoltAgent Субагент platform-engineer для проектирования внутренних платформ разработки, self-service инфраструктуры и безопасных golden-path сценариев. CX Codex ★ 6 505звёзд репо platform-engineer rohitg00 Субагент platform-engineer для проектирования внутренних платформ разработки, настройки service mesh, мониторинга и расчёта SLO/SLI. Помогает внедрять шаблоны сервисов и снижать нагрузку на продуктовые команды. CX Codex ★ 2 858звёзд репо developer-portal rohitg00 Субагент developer-portal для построения внутренних портальных решений на базе Backstage с каталогом сервисов, шаблонами проектов и самообслуживанием инфраструктуры. Ускоряет поиск сервисов, документации и развёртывание новых проектов. CX Codex ★ 2 858звёзд репо platform-engineering devops-skills Скилл platform-engineering для Claude Code: сборка internal developer platform через Backstage, Crossplane и self-service инфраструктуру. Команды заказывают окружения YAML-манифестом, не трогая RDS вручную. CX Codex +1 364установок developer-platform-hiring Samuel Berthe Скилл developer-platform-hiring помогает нанимающему менеджеру собрать скоркарту, план поиска и интервью-петлю под роли API PM, платформенного и партнёрского инженера. CX Codex +1 10 500установок developer-platform-career Samuel Berthe Скилл developer-platform-career помогает выбрать трек в разработке публичных API, подготовиться к собеседованию и оценить оффер. Сначала разбирается, что такое «platform engineer». CX Codex +1 10 500установок oracle-ai-data-platform-workbench-engineer-agent Oracle Агент oracle-ai-data-platform-workbench-engineer-agent из 37 скиллов для работы с Oracle AI Data Platform Workbench на естественном языке: от каталога и Spark SQL до пайплайнов и Delta Sharing. ★ 62звёзд репо backstage-specialist VoltAgent Субагент backstage-specialist помогает спроектировать внутренний портал разработчика на Backstage: каталог сервисов, шаблоны scaffolder, выбор плагинов и план внедрения. CX Codex ★ 6 505звёзд репо

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

Весь набор →
maestro Хук maestro для Claude Code запускает обработчики при старте и завершении сессии, перед вызовом субагента и Bash. Он подключает эти проверки к работе Claude Code. CX Codex ★ 489звёзд репо api-designer Субагент api-designer проектирует контракты REST и GraphQL, схемы ответов, пагинацию и правила версионирования до написания кода. CX Codex ★ 489звёзд репо hlasm-assembler-specialist Субагент hlasm-assembler-specialist для Claude Code и Codex пишет и проверяет модули HLASM под z/OS: реентерабельность, связывание, макросы и разбор аварий по листингу. CX Codex ★ 489звёзд репо architect Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов. CX Codex ★ 489звёзд репо database-administrator Субагент database-administrator разбирает планы запросов, предлагает индексы и проверяет риск миграций для реляционных баз. Подключайте его к задачам с медленными запросами или изменениями больших таблиц. CX Codex ★ 489звёзд репо observability-engineer Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума. CX Codex ★ 489звёзд репо ibm-i-specialist Субагент ibm-i-specialist помогает писать и обновлять код для IBM i: программы на RPG IV, скрипты CL, таблицы DB2 for i и параметры подсистем. CX Codex ★ 489звёзд репо db2-dba Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG. CX Codex ★ 489звёзд репо

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

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