codebase-documentor-for-aws

v1.0.0

Analyze codebases to generate structured technical documentation with source-of-truth citations. Optimized for AWS workloads using CDK, CloudFormation, and Terraform.

CodexClaude Code1 skill2 MCP serversstdiostreamable-http

by Amazon Web ServicesApache-2.0856updated 3 days ago

Source

$ git clone https://github.com/awslabs/agent-plugins

Clone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is plugins/codebase-documentor-for-aws/ inside the repository.

Layout

plugins/codebase-documentor-for-aws/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/document-service/SKILL.md
└── .mcp.json

Skills1

document-serviceskills/document-service/SKILL.md

This skill should be used when the user asks to "analyze this codebase", "document this service", "generate technical docs", "I inherited this code", "help me understand this system", "create docs for this project", "what does this system look like", "onboard me to this codebase", "this codebase has no docs", "visualize the architecture from code", or any explicit request to produce structured documentation or architecture diagrams from an existing codebase. Specifically optimized for AWS workloads (CDK, CloudFormation, Terraform) with source-of-truth citations. Do NOT activate for code reviews, single-function explanations, generating new code, or general coding tasks.

MCP servers2

awsiacstdio

command: uvx
args: awslabs.aws-iac-mcp-server@latest

awsknowledgestreamable-http

url: https://knowledge-mcp.global.api.aws

Manifests2

plugins/codebase-documentor-for-aws/.codex-plugin/plugin.json

{
  "name": "codebase-documentor-for-aws",
  "version": "1.0.0",
  "description": "Analyze codebases to generate structured technical documentation with source-of-truth citations. Optimized for AWS workloads using CDK, CloudFormation, and Terraform.",
  "author": {
    "name": "Amazon Web Services",
    "email": "aws-agent-plugins@amazon.com",
    "url": "https://github.com/awslabs/agent-plugins"
  },
  "homepage": "https://github.com/awslabs/agent-plugins",
  "repository": "https://github.com/awslabs/agent-plugins",
  "license": "Apache-2.0",
  "keywords": [
    "aws",
    "aws agent skills",
    "documentation",
    "architecture",
    "diagram",
    "draw.io",
    "codebase-analysis",
    "cdk",
    "cloudformation",
    "terraform",
    "onboarding"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Codebase Documentor for AWS",
    "shortDescription": "Analyze codebases and generate structured technical documentation with citations.",
    "longDescription": "Analyze AWS-deployed services and codebases to generate structured technical documentation with source-of-truth citations linking every finding back to code.",
    "defaultPrompt": [
      "Analyze this codebase and generate documentation.",
      "I inherited this code — help me understand and document it.",
      "Document the architecture and components of this service."
    ],
    "developerName": "Amazon Web Services",
    "category": "Development",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/awslabs/agent-plugins",
    "privacyPolicyURL": "https://aws.amazon.com/privacy/",
    "termsOfServiceURL": "https://aws.amazon.com/service-terms/",
    "brandColor": "#FF9900"
  }
}

plugins/codebase-documentor-for-aws/.claude-plugin/plugin.json

{
  "author": {
    "name": "Amazon Web Services"
  },
  "description": "Analyze codebases to generate structured technical documentation with source-of-truth citations. Optimized for AWS workloads using CDK, CloudFormation, and Terraform.",
  "homepage": "https://github.com/awslabs/agent-plugins",
  "keywords": [
    "aws",
    "aws agent skills",
    "documentation",
    "architecture",
    "diagram",
    "draw.io",
    "codebase-analysis",
    "cdk",
    "cloudformation",
    "terraform",
    "onboarding"
  ],
  "license": "Apache-2.0",
  "name": "codebase-documentor-for-aws",
  "repository": "https://github.com/awslabs/agent-plugins",
  "version": "1.0.0"
}