Skip to content
Back to skills

Docs Arch Gen

ASecurity

Genera un borrador del documento de arquitectura leyendo el árbol de Python: módulo, docstring de responsabilidad y funciones de entrada, más el comando para regenerarlo.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentspythonbash

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill docs-arch-gen --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Docs Arch Gen?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Docs Arch Gen
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-docs-arch-gen/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-docs-arch-gen)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: docs-arch-gen
description: Genera un borrador del documento de arquitectura leyendo el árbol de Python: módulo, docstring de responsabilidad y funciones de entrada, más el comando para regenerarlo.
license: MIT
metadata:
  package: docs-sync-engine
  version: "1.1.0"
---

# Docs Arch Gen

## Objetivo

Tener un documento de arquitectura que se pueda regenerar en vez de releer: la estructura sale del árbol, no de la memoria de nadie.

## Instrucciones de ejecución

1. Genera el borrador:

```bash
py docs-sync-engine/scripts/arch_gen.py --root <paquete> --out docs/arquitectura.md --title "Arquitectura"
```

2. Revisa el diff contra el documento vigente y commitea solo los cambios reales.
3. Si un módulo aparece como `(sin docstring de módulo)`, ese es el primer arreglo: falta la responsabilidad escrita.

## Qué produce

| Sección | Contenido |
|---|---|
| Tabla de módulos | Ruta, primera línea del docstring y entradas principales |
| Cómo regenerar | Comando exacto usado |

## Límites

- Solo Python y solo docstrings de módulo: comentarios sueltos y documentación inline no se leen.
- Ignora `tests/` y las carpetas de entorno por defecto.
- No dibuja diagramas ni describe el flujo entre módulos: eso lo escribe la persona.

## Gate de salida

- Borrador regenerado y diff revisado.
- Cada módulo sin docstring está listado como deuda.
- El comando de regeneración queda dentro del documento.

## Handoff

Entrega a `docs-drift-check` las rutas nuevas y a `docs-changelog` la entrada del documento actualizado.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.