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.

evals/trigger-eval.json

View on GitHub
[
  { "query": "draw an ER diagram of the users and orders tables", "should_trigger": true },
  { "query": "show me the architecture of this system", "should_trigger": true },
  { "query": "diagram the deployment setup with Docker and Kubernetes", "should_trigger": true },
  { "query": "visualize the security data flow for our auth service", "should_trigger": true },
  { "query": "generate a system diagram for this codebase", "should_trigger": true },
  { "query": "can you create a mermaid architecture diagram from the code", "should_trigger": true },
  { "query": "I need an ER diagram generated from our Prisma schema", "should_trigger": true },
  { "query": "docs-diagram arch", "should_trigger": true },
  { "query": "make a diagram showing how our services talk to each other", "should_trigger": true },
  { "query": "produce a security architecture diagram showing our trust boundaries", "should_trigger": true },
  { "query": "set up the initial docs/ folder structure for this project", "should_trigger": false },
  { "query": "sync our architecture doc with the latest code changes", "should_trigger": false },
  { "query": "write an ADR for choosing Postgres over MongoDB", "should_trigger": false },
  { "query": "update the README to reflect the new API endpoints", "should_trigger": false },
  { "query": "initialize documentation for this new repo", "should_trigger": false },
  { "query": "record the decision to switch to microservices in an ADR", "should_trigger": false },
  { "query": "check if our docs are still accurate compared to the code", "should_trigger": false },
  { "query": "review the UX design of our onboarding flow", "should_trigger": false },
  { "query": "break this project into a task plan with dependencies", "should_trigger": false },
  { "query": "create an RFC proposing the new caching strategy", "should_trigger": false }
]
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: 471kUpdated 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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated 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