---
id: write_analysis_md_bash_infra
name: write_analysis_md
kind: function
lang: bash
domain: infra
version: 1.0.0
purity: impure
signature: "write_analysis_md(analysis_dir: string, name: string, description: string, tags_csv: string) -> string"
description: "Genera un archivo analysis.md con frontmatter valido para el registry. Calcula dir_path relativo a FN_REGISTRY_ROOT (o lo deduce buscando registry.db hacia arriba). Acepta tags como CSV."
tags: [analysis, frontmatter, registry, markdown]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
example: "source write_analysis_md.sh && write_analysis_md projects/aurgi/analysis/ventas ventas 'Analisis de ventas' 'aurgi,ventas'"
tested: false
file_path: "bash/functions/infra/write_analysis_md.sh"
params:
  - name: analysis_dir
    desc: "Directorio del analisis donde se escribira analysis.md"
  - name: name
    desc: "Nombre del analisis (se usa en frontmatter name)"
  - name: description
    desc: "Descripcion breve del analisis"
  - name: tags_csv
    desc: "Tags separados por coma (opcional)"
output: "Ruta absoluta del analysis.md creado"
---

## Notas

Forma parte del workflow de creacion rapida de analyses dentro de proyectos.

Requiere que `analysis_dir` exista fisicamente antes de llamar (para resolver path absoluto). Normalmente se llama dentro del pipeline `init_jupyter_analysis` despues de crear la estructura de carpetas.

El `dir_path` del frontmatter debe ser relativo a la raiz del registry para que `fn index` lo enlace correctamente al `project_id` si esta bajo `projects/{nombre}/analysis/`.