javi-forge 0.1.0

package/modules/engram/install-engram.sh

@@ -0,0 +1,216 @@
+#!/bin/bash
+# =============================================================================
+# INSTALL-ENGRAM: Instala Engram memory server para AI agents
+# =============================================================================
+# Uso:
+#   ./install-engram.sh              # Instalar ultima version
+#   ./install-engram.sh --check      # Solo verificar si esta instalado
+#   ./install-engram.sh --mcp-config # Generar config MCP
+#   ./install-engram.sh --no-verify  # Instalar sin verificar checksum (NO RECOMENDADO)
+# =============================================================================
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+REPO="Gentleman-Programming/engram"
+INSTALL_DIR="${ENGRAM_INSTALL_DIR:-$HOME/.local/bin}"
+NO_VERIFY=false
+
+# =============================================================================
+# Helpers
+# =============================================================================
+
+check_installed() {
+    if command -v engram &> /dev/null; then
+        local version
+        version=$(engram --version 2>/dev/null || echo "unknown")
+        echo -e "${GREEN}Engram ya instalado: $version${NC}"
+        echo -e "  Path: $(which engram)"
+        return 0
+    fi
+    return 1
+}
+
+detect_platform() {
+    local os arch
+
+    case "$(uname -s)" in
+        Linux*)  os="Linux" ;;
+        Darwin*) os="Darwin" ;;
+        MINGW*|MSYS*|CYGWIN*) os="Windows" ;;
+        *)       echo -e "${RED}OS no soportado: $(uname -s)${NC}"; exit 1 ;;
+    esac
+
+    case "$(uname -m)" in
+        x86_64|amd64)  arch="x86_64" ;;
+        arm64|aarch64) arch="arm64" ;;
+        *)             echo -e "${RED}Arquitectura no soportada: $(uname -m)${NC}"; exit 1 ;;
+    esac
+
+    echo "${os}_${arch}"
+}
+
+get_latest_version() {
+    curl -fsSL "https://api.github.com/repos/${REPO}/releases/latest" \
+        | grep '"tag_name"' \
+        | head -1 \
+        | sed 's/.*"tag_name": *"//;s/".*//'
+}
+
+generate_mcp_config() {
+    local project_name="${1:-$(basename "$(pwd)")}"
+    cat << EOF
+{
+  "mcpServers": {
+    "engram": {
+      "command": "engram",
+      "args": ["mcp"],
+      "env": {
+        "ENGRAM_PROJECT": "${project_name}"
+      }
+    }
+  }
+}
+EOF
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+case "${1:-install}" in
+    --check)
+        if check_installed; then
+            exit 0
+        else
+            echo -e "${YELLOW}Engram no instalado${NC}"
+            exit 1
+        fi
+        ;;
+    --mcp-config)
+        generate_mcp_config "$2"
+        exit 0
+        ;;
+    --no-verify)
+        NO_VERIFY=true
+        ;;
+    install|"")
+        ;;
+    *)
+        echo "Uso: $0 [--check|--mcp-config [project-name]|--no-verify]"
+        exit 1
+        ;;
+esac
+
+echo -e "${CYAN}=== Instalando Engram ===${NC}"
+
+# Verificar si ya existe
+if check_installed; then
+    read -p "  Reinstalar? [y/N]: " REINSTALL
+    [[ "$REINSTALL" != "y" && "$REINSTALL" != "Y" ]] && exit 0
+fi
+
+# Detectar plataforma
+PLATFORM=$(detect_platform)
+echo -e "${YELLOW}Plataforma: ${PLATFORM}${NC}"
+
+# Obtener ultima version
+echo -e "${YELLOW}Buscando ultima version...${NC}"
+VERSION=$(get_latest_version)
+if [[ -z "$VERSION" ]]; then
+    echo -e "${RED}No se pudo obtener la ultima version${NC}"
+    echo -e "${YELLOW}Instala manualmente desde: https://github.com/${REPO}/releases${NC}"
+    exit 1
+fi
+echo -e "${GREEN}Version: ${VERSION}${NC}"
+
+# Construir URL de descarga
+ARCHIVE_NAME="engram_${PLATFORM}.tar.gz"
+if [[ "$PLATFORM" == Windows_* ]]; then
+    ARCHIVE_NAME="engram_${PLATFORM}.zip"
+fi
+DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${VERSION}/${ARCHIVE_NAME}"
+
+# Descargar
+echo -e "${YELLOW}Descargando ${DOWNLOAD_URL}...${NC}"
+TMP_DIR=$(mktemp -d)
+chmod 700 "$TMP_DIR"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+if ! curl -fsSL -o "${TMP_DIR}/${ARCHIVE_NAME}" "$DOWNLOAD_URL"; then
+    echo -e "${RED}Error descargando. Verifica la URL:${NC}"
+    echo -e "  ${DOWNLOAD_URL}"
+    echo -e "${YELLOW}Releases disponibles: https://github.com/${REPO}/releases${NC}"
+    exit 1
+fi
+
+# Verify checksum (mandatory by default)
+CHECKSUM_URL="https://github.com/${REPO}/releases/download/${VERSION}/checksums.txt"
+if curl -fsSL -o "${TMP_DIR}/checksums.txt" "$CHECKSUM_URL" 2>/dev/null; then
+    echo -e "${CYAN}Verifying checksum...${NC}"
+    pushd "$TMP_DIR" > /dev/null
+    if command -v sha256sum &>/dev/null; then
+        sha256sum -c checksums.txt --ignore-missing || {
+            echo -e "${RED}Checksum verification failed!${NC}"
+            exit 1
+        }
+    elif command -v shasum &>/dev/null; then
+        shasum -a 256 -c checksums.txt --ignore-missing || {
+            echo -e "${RED}Checksum verification failed!${NC}"
+            exit 1
+        }
+    fi
+    popd > /dev/null
+    echo -e "${GREEN}Checksum verified${NC}"
+else
+    if [[ "$NO_VERIFY" == "true" ]]; then
+        echo -e "${YELLOW}WARNING: Skipping checksum verification (--no-verify)${NC}"
+    else
+        echo -e "${RED}Error: Could not download checksums. Cannot verify download integrity.${NC}"
+        echo -e "${YELLOW}Use --no-verify flag to skip verification (NOT RECOMMENDED).${NC}"
+        exit 1
+    fi
+fi
+
+# Extraer
+echo -e "${YELLOW}Extrayendo...${NC}"
+if [[ "$ARCHIVE_NAME" == *.zip ]]; then
+    unzip -o "${TMP_DIR}/${ARCHIVE_NAME}" -d "${TMP_DIR}" > /dev/null
+else
+    tar xzf "${TMP_DIR}/${ARCHIVE_NAME}" -C "${TMP_DIR}"
+fi
+
+# Instalar
+mkdir -p "$INSTALL_DIR"
+cp "${TMP_DIR}/engram" "${INSTALL_DIR}/engram" 2>/dev/null \
+    || cp "${TMP_DIR}/engram.exe" "${INSTALL_DIR}/engram.exe" 2>/dev/null
+chmod +x "${INSTALL_DIR}/engram" 2>/dev/null || true
+
+# Verificar PATH
+if ! echo "$PATH" | tr ':' '\n' | grep -q "^${INSTALL_DIR}$"; then
+    echo -e "${YELLOW}Agrega ${INSTALL_DIR} a tu PATH:${NC}"
+    echo -e "  export PATH=\"\$PATH:${INSTALL_DIR}\""
+    echo -e "  # O agrega a ~/.bashrc / ~/.zshrc"
+fi
+
+# Verificar instalacion
+if command -v engram &> /dev/null || [[ -f "${INSTALL_DIR}/engram" ]]; then
+    echo -e "${GREEN}Engram instalado correctamente${NC}"
+    echo -e "  Path: ${INSTALL_DIR}/engram"
+else
+    echo -e "${RED}Error: engram no encontrado despues de instalar${NC}"
+    exit 1
+fi
+
+# Generar config MCP
+echo -e ""
+echo -e "${CYAN}Config MCP para tu proyecto:${NC}"
+echo -e ""
+generate_mcp_config
+echo -e ""
+echo -e "${GREEN}Copia esto a .mcp.json en la raiz de tu proyecto${NC}"

package/modules/ghagga/.env.example

@@ -0,0 +1,43 @@
+# =============================================================================
+# GHAGGA - Variables de Entorno
+# =============================================================================
+# Copia este archivo como .env y configura tus valores.
+# NUNCA commitees el archivo .env con tus keys reales.
+# =============================================================================
+
+# --- Supabase ---
+POSTGRES_PASSWORD=CHANGE_ME_BEFORE_USE
+SUPABASE_URL=http://localhost:54321
+SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+# --- GitHub App ---
+GITHUB_APP_ID=
+GITHUB_PRIVATE_KEY=
+GITHUB_WEBHOOK_SECRET=
+
+# --- LLM Providers (configura al menos uno) ---
+
+# Anthropic (recomendado)
+ANTHROPIC_API_KEY=
+
+# OpenAI
+OPENAI_API_KEY=
+
+# Google
+GOOGLE_API_KEY=
+
+# Azure OpenAI (alternativa a OpenAI directo)
+# AZURE_OPENAI_API_KEY=
+# AZURE_OPENAI_ENDPOINT=
+# AZURE_OPENAI_DEPLOYMENT=
+
+# --- Review Config ---
+# Modo: simple | workflow | consensus
+REVIEW_MODE=simple
+
+# Modelo por defecto
+DEFAULT_MODEL=claude-sonnet-4-20250514
+
+# --- Semgrep (opcional) ---
+# SEMGREP_APP_TOKEN=

package/modules/ghagga/README.md

@@ -0,0 +1,153 @@
+# GHAGGA - AI Code Review for GitHub PRs
+
+> Multi-Agent code review automatizado para Pull Requests de GitHub.
+
+## Que es GHAGGA
+
+[GHAGGA](https://github.com/JNZader/ghagga/) es un sistema de code review con IA que revisa automaticamente tus Pull Requests usando multiples proveedores LLM (Claude, GPT, Gemini).
+
+## Arquitectura
+
+```
+GitHub PR → Webhook → Supabase Edge Function → Multi-LLM Review → PR Comments
+                                    ↓
+                              Dashboard React
+```
+
+### Componentes
+
+| Componente | Stack | Descripcion |
+|-----------|-------|-------------|
+| Dashboard | React + Mantine + Vite | UI para configurar y monitorear reviews |
+| Backend | Supabase + Deno Edge Functions | Procesa webhooks y orquesta reviews |
+| Database | PostgreSQL + pgvector + pg_trgm | Almacena reviews, embeddings, busqueda |
+| Analysis | Semgrep | Analisis estatico complementario |
+
+### Modos de Review
+
+| Modo | Descripcion | Cuando usar |
+|------|-------------|-------------|
+| **Simple** | Un solo LLM analiza el codigo | Reviews rapidas, bajo costo |
+| **Workflow** | Pipeline multi-paso secuencial | Analisis profundo, cada paso especializado |
+| **Consensus** | Multiples LLMs evaluan y votan | Maxima confiabilidad, reviews criticas |
+
+## Opciones de Deployment
+
+| Opcion | Complejidad | Costo | Cuando usar |
+|--------|------------|-------|-------------|
+| Reusable Workflow | Baja | Free tier | Solo quieres PR reviews, sin dashboard |
+| Docker Compose | Media | Self-hosted | Equipo quiere dashboard, tiene servidor |
+| Full Clone | Alta | Self-hosted | Necesitas personalizar logica de review |
+
+### Costos de API
+- **Simple mode**: ~$0.01-0.05 por review (1 LLM call)
+- **Workflow mode**: ~$0.05-0.15 por review (multi-paso)
+- **Consensus mode**: ~$0.15-0.50 por review (multiples LLMs)
+
+## Instalacion
+
+### Prerequisitos
+
+- [Supabase CLI](https://supabase.com/docs/guides/cli)
+- [Docker](https://docker.com) (para Supabase local)
+- [Deno](https://deno.land) (para Edge Functions)
+- Una GitHub App configurada
+
+### Opcion 1: Reusable Workflow (CI)
+
+En tu `.github/workflows/ci.yml`:
+
+```yaml
+jobs:
+  review:
+    uses: JNZader/project-starter-framework/.github/workflows/reusable-ghagga-review.yml@main
+    with:
+      ghagga-url: ${{ vars.GHAGGA_URL }}
+    secrets:
+      ghagga-token: ${{ secrets.GHAGGA_TOKEN }}
+```
+
+### Opcion 2: Docker Compose (este modulo)
+
+```bash
+# Desde tu proyecto
+cp optional/ghagga/docker-compose.yml .
+cp optional/ghagga/.env.example .env.ghagga
+
+# Editar .env.ghagga con tus keys
+# Levantar servicios
+docker compose -f docker-compose.yml up -d
+```
+
+### Opcion 3: Full Clone (desarrollo)
+
+```bash
+# Clonar GHAGGA
+git clone https://github.com/JNZader/ghagga.git
+cd ghagga
+
+# Levantar Supabase local
+supabase start
+
+# Configurar variables de entorno
+cp .env.example .env
+# Editar .env con tus API keys
+
+# Servir Edge Functions
+supabase functions serve
+
+# Dashboard
+cd dashboard && npm install && npm run dev
+```
+
+## Setup GitHub App
+
+1. Ir a GitHub Settings > Developer settings > GitHub Apps
+2. Crear nueva app con permisos:
+   - **Pull requests**: Read & Write (para comentar)
+   - **Contents**: Read (para leer codigo)
+   - **Webhooks**: Activar para eventos `pull_request`
+3. Configurar Webhook URL apuntando a tu instancia de GHAGGA
+4. Generar Private Key y guardarla como secret
+
+Ver guia completa: [GHAGGA - GitHub App Setup](https://github.com/JNZader/ghagga/blob/main/docs/GITHUB_APP_SETUP.md)
+
+## Configuracion de Providers
+
+GHAGGA soporta multiples proveedores LLM:
+
+| Provider | Modelos | Variable de entorno |
+|----------|---------|-------------------|
+| Anthropic | claude-sonnet-4-20250514 | `ANTHROPIC_API_KEY` |
+| OpenAI | gpt-4o, gpt-4-turbo | `OPENAI_API_KEY` |
+| Google | gemini-2.0-flash, gemini-1.5-pro | `GOOGLE_API_KEY` |
+| Azure OpenAI | gpt-4o (via Azure) | `AZURE_OPENAI_*` |
+
+Configura al menos un provider en tu `.env`.
+
+## Features Avanzadas
+
+### Hebbian Learning
+
+GHAGGA aprende de reviews anteriores para mejorar recomendaciones futuras.
+Los patrones recurrentes se refuerzan automaticamente.
+
+### Hybrid Search
+
+Combina busqueda semantica (pgvector embeddings) con full-text search (pg_trgm) para encontrar codigo similar y reviews previas relevantes.
+
+### Semgrep Integration
+
+Ejecuta reglas Semgrep como complemento al analisis LLM, cubriendo patrones de seguridad OWASP.
+
+## Integracion con el Framework
+
+Cuando usas GHAGGA con project-starter-framework:
+
+- **CI-Local** valida codigo antes del push (pre-commit, pre-push)
+- **GHAGGA** revisa el PR despues del push (review automatico)
+- **Ambos** usan Semgrep: CI-Local para chequeo local, GHAGGA para analisis profundo
+
+```
+Developer → CI-Local (pre-push) → Push → PR → GHAGGA Review → Merge
+```

package/modules/ghagga/docker-compose.yml

@@ -0,0 +1,80 @@
+# =============================================================================
+# GHAGGA Local Development - Docker Compose
+# =============================================================================
+# Levanta Supabase + Dashboard para desarrollo local de GHAGGA.
+#
+# Uso:
+#   docker compose up -d          # Levantar servicios
+#   docker compose logs -f        # Ver logs
+#   docker compose down           # Detener
+#
+# Prerequisitos:
+#   - Docker y Docker Compose
+#   - Copiar .env.example a .env y configurar API keys
+# =============================================================================
+
+services:
+  # ---------------------------------------------------------------------------
+  # Supabase (PostgreSQL + Auth + Edge Functions)
+  # ---------------------------------------------------------------------------
+  supabase-db:
+    image: supabase/postgres:15.6.1.143
+    ports:
+      - "127.0.0.1:54322:5432"
+    environment:
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env.ghagga}
+      POSTGRES_DB: ghagga
+    volumes:
+      - ghagga-db:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  supabase-kong:
+    image: kong:3.5
+    # NOTE: kong.yml is required. Get it from the GHAGGA repository:
+    #   curl -o kong.yml https://raw.githubusercontent.com/JNZader/ghagga/main/kong.yml
+    volumes:
+      - ./kong.yml:/home/kong/kong.yml:ro
+    ports:
+      - "127.0.0.1:54321:8000"   # Supabase API
+      - "127.0.0.1:54323:8443"   # Supabase API (HTTPS)
+    environment:
+      KONG_DATABASE: "off"
+      KONG_DECLARATIVE_CONFIG: /home/kong/kong.yml
+    depends_on:
+      supabase-db:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "kong health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # ---------------------------------------------------------------------------
+  # GHAGGA Dashboard (React + Vite)
+  # ---------------------------------------------------------------------------
+  dashboard:
+    build:
+      context: .
+      dockerfile: Dockerfile.dashboard
+      args:
+        GHAGGA_REPO: https://github.com/JNZader/ghagga.git
+    ports:
+      - "127.0.0.1:5173:5173"
+    environment:
+      VITE_SUPABASE_URL: http://localhost:54321
+      VITE_SUPABASE_ANON_KEY: ${SUPABASE_ANON_KEY:?Set SUPABASE_ANON_KEY in .env.ghagga}
+    depends_on:
+      supabase-kong:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:5173/ || exit 1"]
+      interval: 15s
+      timeout: 5s
+      retries: 3
+
+volumes:
+  ghagga-db:

package/modules/ghagga/setup-ghagga.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# =============================================================================
+# SETUP-GHAGGA: Configura GHAGGA code review para tu proyecto
+# =============================================================================
+# Uso:
+#   ./setup-ghagga.sh               # Setup interactivo
+#   ./setup-ghagga.sh --workflow     # Solo copiar reusable workflow
+#   ./setup-ghagga.sh --docker       # Setup Docker Compose
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+echo -e "${CYAN}=== Setup GHAGGA Code Review ===${NC}"
+
+# =============================================================================
+# Helpers
+# =============================================================================
+
+setup_workflow() {
+    echo -e "${YELLOW}Configurando GitHub Actions workflow...${NC}"
+
+    mkdir -p .github/workflows
+
+    cat > .github/workflows/ghagga-review.yml << 'EOF'
+# =============================================================================
+# GHAGGA AI Code Review
+# =============================================================================
+# Trigger: Pull requests to main/develop
+# Requires: GHAGGA_URL and GHAGGA_TOKEN in repo settings
+# =============================================================================
+
+name: AI Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches: [main, develop]
+
+concurrency:
+  group: ghagga-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  review:
+    uses: JNZader/project-starter-framework/.github/workflows/reusable-ghagga-review.yml@main
+    with:
+      ghagga-url: ${{ vars.GHAGGA_URL }}
+      review-mode: simple
+    secrets:
+      ghagga-token: ${{ secrets.GHAGGA_TOKEN }}
+EOF
+
+    echo -e "${GREEN}  Creado .github/workflows/ghagga-review.yml${NC}"
+    echo -e ""
+    echo -e "${YELLOW}Configura en tu repo (Settings > Secrets and variables):${NC}"
+    echo -e "  Variables:"
+    echo -e "    GHAGGA_URL = URL de tu instancia GHAGGA"
+    echo -e "  Secrets:"
+    echo -e "    GHAGGA_TOKEN = Token de autenticacion"
+}
+
+setup_docker() {
+    echo -e "${YELLOW}Configurando Docker Compose...${NC}"
+
+    if [[ -f "$SCRIPT_DIR/docker-compose.yml" ]]; then
+        cp "$SCRIPT_DIR/docker-compose.yml" ./docker-compose.ghagga.yml
+        echo -e "${GREEN}  Copiado docker-compose.ghagga.yml${NC}"
+    fi
+
+    if [[ -f "$SCRIPT_DIR/.env.example" ]]; then
+        if [[ ! -f ".env.ghagga" ]]; then
+            cp "$SCRIPT_DIR/.env.example" .env.ghagga
+            echo -e "${GREEN}  Copiado .env.ghagga (editar con tus API keys)${NC}"
+        else
+            echo -e "${YELLOW}  .env.ghagga ya existe, no se sobreescribe${NC}"
+        fi
+    fi
+
+    echo -e ""
+    echo -e "${CYAN}Para levantar GHAGGA local:${NC}"
+    echo -e "  1. Editar .env.ghagga con tus API keys"
+    echo -e "  2. docker compose -f docker-compose.ghagga.yml up -d"
+    echo -e "  3. Dashboard: http://localhost:5173"
+}
+
+setup_gitignore() {
+    local entries=(".env.ghagga" "docker-compose.ghagga.yml")
+    for entry in "${entries[@]}"; do
+        if ! grep -qF "$entry" .gitignore 2>/dev/null; then
+            echo "$entry" >> .gitignore
+        fi
+    done
+    echo -e "${GREEN}  .gitignore actualizado${NC}"
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+case "${1:-interactive}" in
+    --workflow)
+        setup_workflow
+        ;;
+    --docker)
+        setup_docker
+        setup_gitignore
+        ;;
+    interactive|"")
+        echo -e "  ${CYAN}Como quieres integrar GHAGGA?${NC}"
+        echo -e "    1) GitHub Actions workflow (recomendado)"
+        echo -e "    2) Docker Compose local"
+        echo -e "    3) Ambos"
+        echo -e ""
+        read -p "  Opcion [1/2/3]: " GHAGGA_CHOICE
+
+        case "$GHAGGA_CHOICE" in
+            1) setup_workflow ;;
+            2) setup_docker; setup_gitignore ;;
+            3) setup_workflow; setup_docker; setup_gitignore ;;
+            *) echo -e "${GREEN}  Sin GHAGGA${NC}" ;;
+        esac
+        ;;
+    *)
+        echo "Uso: $0 [--workflow|--docker]"
+        exit 1
+        ;;
+esac
+
+echo -e ""
+echo -e "${GREEN}Setup GHAGGA completado${NC}"
+echo -e "Docs: https://github.com/JNZader/ghagga/"

package/modules/memory-simple/.project/NOTES.md

@@ -0,0 +1,22 @@
+# Project Notes
+
+> Notas simples del proyecto. Actualizar según sea necesario.
+
+## Estado Actual
+
+- **Fase:** [Desarrollo/Testing/Producción]
+- **Última actualización:** [Fecha]
+
+## Decisiones Importantes
+
+1. [Decisión 1]
+2. [Decisión 2]
+
+## TODOs
+
+- [ ] Task 1
+- [ ] Task 2
+
+## Notas
+
+[Cualquier nota relevante del proyecto]

package/modules/memory-simple/README.md

@@ -0,0 +1,23 @@
+# Simple Memory
+
+> Alternativa simple a VibeKanban. Solo un archivo de notas.
+
+## Instalación
+
+```bash
+cp -r optional/memory-simple/.project /path/to/your/project/
+```
+
+## Uso
+
+Editar `.project/NOTES.md` con:
+- Estado actual del proyecto
+- Decisiones importantes
+- TODOs pendientes
+- Notas relevantes
+
+## Cuándo usar
+
+- Proyectos pequeños/personales
+- No necesitas gestión de oleadas
+- Prefieres simplicidad sobre metodología

package/modules/obsidian-brain/.obsidian/app.json

@@ -0,0 +1,23 @@
+{
+  "useMarkdownLinks": false,
+  "newLinkFormat": "relative",
+  "attachmentFolderPath": ".project/Attachments",
+  "alwaysUpdateLinks": true,
+  "showLineNumber": true,
+  "userIgnoreFilters": [
+    "node_modules/",
+    "target/",
+    "build/",
+    "dist/",
+    ".gradle/",
+    ".ci-local/docker/",
+    "__pycache__/",
+    ".pytest_cache/",
+    "coverage/",
+    ".git/",
+    "vendor/"
+  ],
+  "newFileLocation": "current",
+  "strictLineBreaks": false,
+  "showFrontmatter": true
+}