@damenor/agent-docs 0.1.0

package/templates/modules/tutorials/docs/tutorials/quick-start.md

@@ -0,0 +1,146 @@
+---
+created: "2025-01-01"
+status: active
+type: tutorial
+tags: [tutorial, quick-start, inicio, setup]
+---
+
+# Quick Start — Arrancar en 15 minutos
+
+Este tutorial te lleva desde cero hasta tener el proyecto corriendo localmente. Al terminar, tendrás el servidor de desarrollo funcionando y podrás hacer tu primer cambio.
+
+**Tiempo estimado**: 15 minutos.
+**Audiencia**: Developers que se incorporan al proyecto por primera vez.
+
+---
+
+## Prerrequisitos
+
+Antes de empezar, necesitas tener instalado:
+
+| Herramienta | Versión mínima | Cómo verificar | Cómo instalar |
+|------------|---------------|----------------|---------------|
+| **[Node.js / Python / etc.]** | [versión] | `[node --version]` | [nodejs.org / enlace] |
+| **[Git]** | [versión] | `git --version` | [git-scm.com] |
+| **[Package manager]** | [versión] | `[npm --version]` | Viene con Node.js |
+| **[Editor recomendado]** | — | — | [VS Code / etc.] |
+
+Si necesitas ayuda con la instalación completa, ver [`environment-setup.md`](environment-setup.md).
+
+---
+
+## Paso 1: Clonar el repositorio
+
+```bash
+git clone [URL_DEL_REPOSITORIO]
+cd [NOMBRE_DEL_PROYECTO]
+```
+
+Verificar que estás en la branch correcta:
+
+```bash
+git branch
+# Debería mostrar: * main
+```
+
+---
+
+## Paso 2: Instalar dependencias
+
+```bash
+[npm install]
+```
+
+Este comando descarga todas las dependencias del proyecto. Si hay errores:
+
+- Verificar que la versión de [Node / Python] sea la correcta.
+- Borrar `[node_modules]` y `[package-lock.json]` y volver a ejecutar.
+- Si persiste, ver [`troubleshooting.md`](../guides/troubleshooting.md).
+
+---
+
+## Paso 3: Configurar variables de entorno
+
+Copiar el archivo de ejemplo:
+
+```bash
+cp .env.example .env
+```
+
+Abrir `.env` y completar los valores necesarios. Los valores mínimos para desarrollo local son:
+
+```env
+# Obligatorios para arrancar
+APP_ENV=development
+APP_PORT=3000
+[DATABASE_URL]=[URL de desarrollo local]
+
+# Opcionales (tienen defaults para desarrollo)
+[LOG_LEVEL]=debug
+```
+
+Ver la referencia completa de variables en [`docs/reference/configuration.md`](../reference/configuration.md).
+
+---
+
+## Paso 4: Inicializar la base de datos *(si aplica)*
+
+```bash
+[comando de migración — ej. npm run db:migrate]
+```
+
+Opcionalmente, cargar datos de prueba:
+
+```bash
+[comando de seed — ej. npm run db:seed]
+```
+
+---
+
+## Paso 5: Arrancar el servidor de desarrollo
+
+```bash
+[npm run dev]
+```
+
+Deberías ver algo como:
+
+```
+✓ Servidor iniciado en http://localhost:3000
+✓ Hot-reload activo
+```
+
+Abrir `http://localhost:3000` en el navegador. Deberías ver [la página principal / el dashboard / la landing].
+
+---
+
+## Paso 6: Verificar que todo funciona
+
+Ejecutar los tests:
+
+```bash
+[npm run test]
+```
+
+Todos deberían pasar (verde). Si algún test falla:
+
+- Verificar que la base de datos esté configurada correctamente.
+- Verificar que las variables de entorno estén completas.
+- Ver [`troubleshooting.md`](../guides/troubleshooting.md).
+
+Ejecutar el linter:
+
+```bash
+[npm run lint]
+```
+
+No debería mostrar errores.
+
+---
+
+## Siguientes pasos
+
+- Para configurar tu entorno completo (editor, extensiones, herramientas): [`environment-setup.md`](environment-setup.md).
+- Para hacer tu primera contribución (branch → código → PR): [`first-task.md`](first-task.md).
+- Para entender la arquitectura del proyecto: [`docs/explanation/architecture.md`](../explanation/architecture.md).
+- Para conocer el vocabulario del dominio: [`docs/CONTEXT.md`](../CONTEXT.md).

package/templates/shared/.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+
+[*.md]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.json]
+indent_style = space
+indent_size = 2

package/templates/shared/.markdownlint.json

@@ -0,0 +1,14 @@
+{
+  "default": true,
+  "MD001": true,
+  "MD003": { "style": "atx" },
+  "MD004": { "style": "dash" },
+  "MD013": false,
+  "MD024": { "siblings_only": true },
+  "MD033": false,
+  "MD036": false,
+  "MD041": true,
+  "MD046": { "style": "fenced" },
+  "MD049": { "style": "asterisk" },
+  "MD050": { "style": "asterisk" }
+}