Skip to content

mgiovani/ai-arsenal / skills/docs-diagram

docs-diagram

Verified

Generate a Mermaid diagram (ER, architecture, deployment, or security) by reading the actual codebase and writing it to docs/. Use for requests like "draw an ER diagram of these tables", "show me the architecture", "diagram the deployment setup", "visualize the security data flow", or "generate a system diagram". Not for scaffolding a new docs directory structure (use docs-init), syncing existing prose docs with code changes (use docs-update), or recording a design decision's rationale (use docs-adr), this skill only produces diagrams generated from code.

assets/templates/deployment.md

View on GitHub
# {{PROJECT_NAME}} - Deployment

**Last Updated:** {{DATE}}

## Overview

{{OVERVIEW}}

[One paragraph: how this system is deployed and the environments it runs in.]

## Deployment Diagram

```mermaid
{{DIAGRAM_CONTENT}}
```

## Environments

| Environment | Infrastructure | Trigger |
|-------------|----------------|---------|
| {{ENV_1_NAME}} | {{ENV_1_INFRA}} | {{ENV_1_TRIGGER}} |
| {{ENV_2_NAME}} | {{ENV_2_INFRA}} | {{ENV_2_TRIGGER}} |
| {{ENV_3_NAME}} | {{ENV_3_INFRA}} | {{ENV_3_TRIGGER}} |

## Components

- **{{COMPONENT_1_NAME}}**: {{COMPONENT_1_DESCRIPTION}}
- **{{COMPONENT_2_NAME}}**: {{COMPONENT_2_DESCRIPTION}}

## CI/CD Pipeline

1. {{PIPELINE_STEP_1}}
2. {{PIPELINE_STEP_2}}
3. {{PIPELINE_STEP_3}}

---

*Generated from CI/CD config and infra manifests. Regenerate with docs-diagram after deployment changes.*
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall