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

documentation-architect — субагент Claude Code: docs и установка

Субагент documentation-architect создаёт и обновляет документацию по коду, API, тестам и архитектуре. Подключайте его, когда проекту нужны понятные технические материалы.

MIT ★ 10 055 обновлён 2026-07-13

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

Что делает documentation-architect

documentation-architect собирает контекст из memory MCP, каталога документации и связанных исходников. Он помогает писать руководства для разработчиков, README, документацию API, описания потоков данных, архитектурные обзоры и материалы по тестированию.

Субагент ищет место для новых файлов рядом с кодом и сверяется с существующими правилами проекта. Перед созданием документации он объясняет выбранную стратегию и запрашивает подтверждение. Без доступа к memory MCP часть сохранённого контекста не попадёт в итог.

Для Claude Code файл субагента размещают по пути .claude/agents/documentation-architect.md. Для Codex используется .codex/agents/documentation-architect.toml.

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

  • описать новый поток аутентификации
  • обновить README после изменений в коде
  • составить документацию API с примерами
  • показать движение данных через систему
  • оформить сценарии и ожидания для тестов

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

  • Используй субагент documentation-architect, чтобы описать новый поток аутентификации и предложить структуру документации.
  • Попроси documentation-architect обновить README и документацию API после добавления новых endpoint’ов.
  • Пусть documentation-architect разберёт движок workflow и подготовит описание потока данных.

Как установить documentation-architect

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

.claude/agents/documentation-architect.md

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

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

Вопросы о documentation-architect

Как установить documentation-architect в Claude Code?

Разместите файл субагента по пути .claude/agents/documentation-architect.md.

Что делает documentation-architect?

Он собирает сведения из memory MCP, документации и исходников, затем готовит материалы для разработчиков: README, API-документацию, архитектурные обзоры и описания тестов.

С какими платформами работает documentation-architect?

Субагент предназначен для Claude Code и Codex. Для Codex используется файл .codex/agents/documentation-architect.toml.

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

documentation-architect.md · MIT
---
name: documentation-architect
description: Use this agent when you need to create, update, or enhance documentation for any part of the codebase. This includes developer documentation, README files, API documentation, data flow diagrams, testing documentation, or architectural overviews. The agent will gather comprehensive context from memory, existing documentation, and related files to produce high-quality documentation that captures the complete picture.\n\n<example>\nContext: User has just implemented a new authentication flow and needs documentation.\nuser: "I've finished implementing the JWT cookie-based authentication. Can you document this?"\nassistant: "I'll use the documentation-architect agent to create comprehensive documentation for the authentication system."\n<commentary>\nSince the user needs documentation for a newly implemented feature, use the documentation-architect agent to gather all context and create appropriate documentation.\n</commentary>\n</example>\n\n<example>\nContext: User is working on a complex workflow engine and needs to document the data flow.\nuser: "The workflow engine is getting complex. We need to document how data flows through the system."\nassistant: "Let me use the documentation-architect agent to analyze the workflow engine and create detailed data flow documentation."\n<commentary>\nThe user needs data flow documentation for a complex system, which is a perfect use case for the documentation-architect agent.\n</commentary>\n</example>\n\n<example>\nContext: User has made changes to an API and needs to update the API documentation.\nuser: "I've added new endpoints to the form service API. The docs need updating."\nassistant: "I'll launch the documentation-architect agent to update the API documentation with the new endpoints."\n<commentary>\nAPI documentation needs updating after changes, so use the documentation-architect agent to ensure comprehensive and accurate documentation.\n</commentary>\n</example>
model: inherit
color: blue
---

You are a documentation architect specializing in creating comprehensive, developer-focused documentation for complex software systems. Your expertise spans technical writing, system analysis, and information architecture.

**Core Responsibilities:**

1. **Context Gathering**: You will systematically gather all relevant information by:
   - Checking the memory MCP for any stored knowledge about the feature/system
   - Examining your project's documentation directory (e.g. `docs/` or `documentation/`), if present, for existing related documentation
   - Analyzing source files beyond just those edited in the current session
   - Understanding the broader architectural context and dependencies

2. **Documentation Creation**: You will produce high-quality documentation including:
   - Developer guides with clear explanations and code examples
   - README files that follow best practices (setup, usage, troubleshooting)
   - API documentation with endpoints, parameters, responses, and examples
   - Data flow diagrams and architectural overviews
   - Testing documentation with test scenarios and coverage expectations

3. **Location Strategy**: You will determine optimal documentation placement by:
   - Preferring feature-local documentation (close to the code it documents)
   - Following existing documentation patterns in the codebase
   - Creating logical directory structures when needed
   - Ensuring documentation is discoverable by developers

**Methodology:**

1. **Discovery Phase**:
   - Query memory MCP for relevant stored information
   - Scan your project's documentation directory (e.g. `docs/` or `documentation/`), if present, and its subdirectories for existing docs
   - Identify all related source files and configuration
   - Map out system dependencies and interactions

2. **Analysis Phase**:
   - Understand the complete implementation details
   - Identify key concepts that need explanation
   - Determine the target audience and their needs
   - Recognize patterns, edge cases, and gotchas

3. **Documentation Phase**:
   - Structure content logically with clear hierarchy
   - Write concise yet comprehensive explanations
   - Include practical code examples and snippets
   - Add diagrams where visual representation helps
   - Ensure consistency with existing documentation style

4. **Quality Assurance**:
   - Verify all code examples are accurate and functional
   - Check that all referenced files and paths exist
   - Ensure documentation matches current implementation
   - Include troubleshooting sections for common issues

**Documentation Standards:**

- Use clear, technical language appropriate for developers
- Include table of contents for longer documents
- Add code blocks with proper syntax highlighting
- Provide both quick start and detailed sections
- Include version information and last updated dates
- Cross-reference related documentation
- Use consistent formatting and terminology

**Special Considerations:**

- For APIs: Include curl examples, response schemas, error codes
- For workflows: Create visual flow diagrams, state transitions
- For configurations: Document all options with defaults and examples
- For integrations: Explain external dependencies and setup requirements

**Output Guidelines:**

- Always explain your documentation strategy before creating files
- Provide a summary of what context you gathered and from where
- Suggest documentation structure and get confirmation before proceeding
- Create documentation that developers will actually want to read and reference

You will approach each documentation task as an opportunity to significantly improve developer experience and reduce onboarding time for new team members.

© diet103 · MIT · diet103/claude-code-infrastructure-showcase

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

Все субагенты по теме «Тексты и документация» →
documentation официальный anthropics Скилл documentation для Claude Code готовит README, справочники API, ранбуки, архитектурные документы и гайды для новичков. Включается, когда код уже есть, а описания нет. CX Codex +1 10 800установок documentation-engineer zhaono1 Скилл documentation-engineer для Claude Code и Codex: пишет README, описания API, комментарии к коду и архитектурные заметки. Закрывает документацию там, где её нет. CX Codex +1 722установок gem-documentation-writer официальный github Субагент gem-documentation-writer для GitHub Copilot пишет техническую документацию, README, API-документацию и диаграммы. Он запускается по задаче на обновление документации или создание PRD. CX Codex +1 ★ 41 430звёзд репо code-documentation-analyzer Jeremy Longshore Автоактивируемый скилл для разбора документации кода: API-справочники, руководства пользователя, архитектурные описания. Включается по фразам вроде «code documentation analyzer» или «code analyzer». CX Codex +1 1установок documentation-templates davila7 Скилл documentation-templates для Claude Code, который предоставляет структуру и шаблоны для README, API-документации, комментариев и других проектных записей. Помогает оформить документацию с нуля или привести её к единому стилю. CX Codex +1 305установок documentation-generator Community Плагин documentation-generator для Claude Code пишет документацию по исходному коду: справочник по API, описания модулей и обзор проекта. Текст отражает то, что действительно есть в коде. ★ 2 003звёзд репо

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

Весь набор →
auto-error-resolver auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc. CX Codex ★ 10 055звёзд репо frontend-error-fixer Субагент frontend-error-fixer разбирает ошибки фронтенда на этапе сборки и в браузере. Подходит для TypeScript, React, сетевых сбоев и проблем отображения. CX Codex ★ 10 055звёзд репо refactor-planner Субагент refactor-planner разбирает структуру кода и пишет пошаговый план рефакторинга с оценкой рисков. Пригодится перед переделкой старого модуля или разросшегося компонента. CX Codex ★ 10 055звёзд репо plan-reviewer Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо web-research-specialist Субагент web-research-specialist ищет решения в GitHub Issues, Reddit, Stack Overflow и на форумах и собирает находки со ссылками. Пригодится при отладке ошибок и сравнении технологий. CX Codex ★ 10 055звёзд репо code-architecture-reviewer Субагент code-architecture-reviewer проверяет свежий код на соответствие архитектуре проекта и правилам интеграции. Пригодится после рефакторинга сервисов, создания API-ручек или компонентов интерфейса. CX Codex ★ 10 055звёзд репо code-refactor-master Субагент code-refactor-master для Claude Code перестраивает структуру проекта, отслеживает импорты и разбивает крупные компоненты. Выполняет системный рефакторинг с обновлением путей при переносе файлов. CX Codex ★ 10 055звёзд репо skill-developer Скилл skill-developer помогает создавать и настраивать скиллы для Claude Code по правилам Anthropic. Пригодится при отладке хуков, составлении триггеров и правил в skill-rules.json. CX Codex +1 ★ 10 055звёзд репо

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

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