Skip to content

Latest commit

 

History

History
19 lines (13 loc) · 2.9 KB

File metadata and controls

19 lines (13 loc) · 2.9 KB

Repository Guidelines

Project Structure & Module Organization

Flow es un vault de Obsidian dedicado a la metodología; 00-manifiesto.md fija los principios fundacionales y debe leerse antes de proponer cambios. 01-kit-diseño/ concentra los artefactos operativos (checklist-flowificacion.md, guia-diseño-flow.md, plantilla-flow.md) y cada nuevo recurso debe seguir la nomenclatura NN-nombre/. 02-catalogo/catalogo-flows.md lista los flows activos, en diseño o concepto; documenta ahí todo nuevo flujo antes de crear repositorios derivados. Usa Temas pendientes.md como backlog único de dudas, workshops y decisiones abiertas.

Build, Test, and Development Commands

obsidian /mnt/c/workspaces_projects/flow abre el vault con backlinks y vista gráfica; ejecútalo antes de editar para conservar el grafo de contexto. rg -n "offer-flow" 02-catalogo reutiliza descripciones existentes y evita que cambie la nomenclatura de etapas/agentes. markdownlint '**/*.md' valida que las tablas, listas y bloques cumplan reglas Markdown; instala markdownlint-cli localmente si aún no está disponible.

Coding Style & Naming Conventions

Escribe en español neutro, frases cortas y tono consultivo. Las carpetas y archivos usan prefijo de dos dígitos (NN-) seguido de nombre en minúsculas; evita espacios y mezcla de idiomas. Usa encabezados consecutivos, tablas para mapear agentes/etapas y bloques de código con backticks para diagramas ASCII. Actualiza checklists con [ ]/[x] y mantén ejemplos anclados a flows reales.

Testing Guidelines

Los “tests” son revisiones estructuradas: ejecuta la Checklist de Flowificación desde 01-kit-diseño antes de aceptar un nuevo proceso. Contrasta cada entrada de 02-catalogo con la leyenda de estados y el manifiesto para asegurar que propósito, inputs, outputs y agentes están completos. Antes de publicar entregables o plantillas, solicita una revisión cruzada y registra hallazgos dentro del documento modificado.

Commit & Pull Request Guidelines

A falta de historial git público, adopta Conventional Commits (feat: documenta strategy-flow) y redacta mensajes en presente describiendo el valor generado. Los PR deben incluir resumen, lista de archivos tocados, vínculo al ítem de Temas pendientes.md y, si aplica, capturas o exports compartibles. Pide revisión obligatoria al modificar 00-manifiesto.md o 01-kit-diseño/guia-diseño-flow.md y registra la decisión aceptada en el PR.

Agent-Specific Instructions

Los agentes CLI (Codex, Claude Code) documentan supuestos y comandos relevantes en la conversación y reflejan decisiones persistentes dentro del flow activo (por ejemplo, 00-meta/estado.md). No dejes archivos temporales en el vault; guarda todo como Markdown rastreable o descártalo fuera del repo. Si una acción depende de intervención humana presencial, abre un ítem en Temas pendientes.md con contexto y siguiente paso esperado.