first commit

1 files changed, 51 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..67c2095
--- /dev/null
+++ b/README.md
@@ -0,0 +1,51 @@
+![Logo ShFlow](./shflow-logo.png)
+
+# ⚙️ ShFlow — Automatización declarativa en Shell
+
+**ShFlow** es una herramienta modular, trazable y extensible para ejecutar tareas en sistemas Linux mediante playbooks YAML. 
+
+Diseñada para administradores, auditores y entusiastas del shell, ShFlow combina simplicidad declarativa con control quirúrgico.
+
+- 🔍 Inventario YAML con grupos, etiquetas y metadatos
+- 🧩 Módulos reutilizables con argumentos dinámicos
+- 📦 Ejecución distribuida por host o grupo
+- 🧠 Depuración avanzada con trazas limpias (`--debug`)
+- 📚 Documentación bilingüe y estructura escalable
+
+
+## 📚 Documentación
+
+La documentación completa está disponible en la web [shflow.tech](https://shflow.tech).  
+Incluye índice técnico, changelogs, ejemplos, y guía de módulos.
+
+
+## 📜 Licencia
+
+Este proyecto está licenciado bajo [GPLv3](LICENSE).  
+Autor: **Luis GuLo** — 2025
+
+---
+
+# ⚙️ ShFlow — Declarative Shell Automation
+
+**ShFlow** is a modular, traceable and extensible tool for executing tasks on Linux systems using YAML playbooks. 
+
+Built for sysadmins, auditors and shell enthusiasts, ShFlow blends declarative simplicity with surgical control.
+
+- 🔍 YAML inventory with groups, tags and metadata
+- 🧩 Reusable modules with dynamic arguments
+- 📦 Distributed execution by host or group
+- 🧠 Advanced debugging with clean traces (`--debug`)
+- 📚 Bilingual documentation and scalable structure
+
+## 📚 Documentation
+
+Full documentation is available in [shflow.tech](https://shflow.tech).  
+Includes technical index, changelogs, examples, and module guide.
+
+## 📜 License
+
+This project is licensed under [GPLv3](LICENSE).  
+Author: **Luis GuLo** — 2025
+
+