# grikyproducto/infografia-automatizaci-n-griky architecture

> Architecture diagram of the GitHub repository grikyproducto/infografia-automatizaci-n-griky, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/grikyproducto/infografia-automatizaci-n-griky
- Repository: https://github.com/grikyproducto/infografia-automatizaci-n-griky

## Overview

Infografías — Automatización Griky Genius is a Python image-generation system with a shared, brand-profile-driven pipeline, exposed through a local CLI and a Claude Cowork skill. The main workflow turns unit briefs into enriched prompts and generated images, then validates and saves them, with optional logo composition and SharePoint upload. The repository also includes a separate ESAM interactive-HTML reference workflow; the README explicitly says the main motor does not yet produce interactive infographics. Some relationships below rely on the SOURCE INDEX and README rather than full source excerpts.

Main entry points: [`generar.py`](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/generar.py) (Pipeline CLI), [`skill_build/infografias-griky/scripts/run_pipeline.py`](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/run_pipeline.py) (Skill pipeline), [`skill_build/infografias-griky/scripts/image_generator.py`](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/image_generator.py) (Skill image generator), [`src/brief_parser.py`](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brief_parser.py) (Brief parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_main["Local pipeline"]
  node_cli["Pipeline CLI<br/>[generar.py]"]
end

subgraph group_shared["Shared processing"]
  node_brief["Brief parser<br/>[brief_parser.py]"]
  node_extractor["AI brief extractor<br/>[brief_extractor.py]"]
  node_prompt["Prompt builder<br/>[prompt_builder.py]"]
  node_enricher["Prompt enricher<br/>[prompt_enricher.py]"]
  node_brand["Brand profiles<br/>[brand_profile.py]"]
  node_images["Image generation<br/>[image_generator.py]"]
  node_validate["Image validation<br/>[validator.py]"]
  node_overlay["Logo composition<br/>[logo_overlay.py]"]
  node_sharepoint["SharePoint integration<br/>[sharepoint.py]"]
  node_paths["Path utilities<br/>[paths.py]"]
  node_pages["Page scripts<br/>[guion_pages.py]"]
end

subgraph group_skill["Cowork skill"]
  node_skill_runner["Skill pipeline<br/>[run_pipeline.py]"]
  node_locator["Brief locator<br/>[brief_locator.py]"]
  node_skill_prompt["Skill prompt tools<br/>[prompt_builder.py]"]
  node_skill_enrich["Skill prompt enricher<br/>[prompt_enricher.py]"]
  node_skill_images["Skill image generator<br/>[image_generator.py]"]
  node_genius["Genius API client<br/>[genius_api.py]"]
  node_skill_brand["Skill brand profiles<br/>[brand_profile.py]"]
  node_stock["Stock integration<br/>[magnific_stock.py]"]
  node_html["HTML renderer<br/>[griky_html.py]"]
  node_icons["Icon utilities<br/>[griky_icons.py]"]
end

subgraph group_interactive["Interactive reference"]
  node_html_generator["ESAM HTML generator"]
  node_montage["Script-to-montage<br/>[guion_a_montaje.py]"]
end

node_operator(("Content operator"))
node_openai{{"OpenAI services"}}

node_operator -->|"runs"| node_cli
node_cli -->|"parses briefs"| node_brief
node_cli -->|"extracts briefs"| node_extractor
node_cli -->|"builds prompts"| node_prompt
node_cli -->|"enriches prompts"| node_enricher
node_cli -->|"loads profiles"| node_brand
node_cli -->|"generates images"| node_images
node_images -->|"calls image API"| node_openai
node_cli -->|"validates output"| node_validate
node_cli -->|"applies overlays"| node_overlay
node_cli -->|"uploads optionally"| node_sharepoint
node_brief -->|"uses utilities"| node_paths
node_prompt -->|"reads brief"| node_brief
node_enricher -->|"uses extraction"| node_extractor
node_operator -->|"runs skill"| node_skill_runner
node_skill_runner -->|"locates briefs"| node_locator
node_skill_runner -->|"builds prompts"| node_skill_prompt
node_skill_runner -->|"enriches prompts"| node_skill_enrich
node_skill_runner -->|"generates images"| node_skill_images
node_skill_runner -->|"validates output"| node_validate
node_skill_images -->|"requests generation"| node_genius
node_skill_enrich -->|"requests enrichment"| node_genius
node_skill_images -->|"loads profile"| node_skill_brand
node_skill_images -->|"uses prompts"| node_skill_enrich
node_stock -->|"uses API"| node_genius
node_html -->|"uses icons"| node_icons
node_operator -.->|"uses reference"| node_html_generator
node_html_generator -->|"uses montage"| node_montage

click node_cli "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/generar.py"
click node_brief "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brief_parser.py"
click node_extractor "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brief_extractor.py"
click node_prompt "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/prompt_builder.py"
click node_enricher "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/prompt_enricher.py"
click node_brand "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brand_profile.py"
click node_images "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/image_generator.py"
click node_validate "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/validator.py"
click node_overlay "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/logo_overlay.py"
click node_sharepoint "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/sharepoint.py"
click node_paths "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/paths.py"
click node_pages "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/guion_pages.py"
click node_skill_runner "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/run_pipeline.py"
click node_locator "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/brief_locator.py"
click node_skill_prompt "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/prompt_builder.py"
click node_skill_enrich "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/prompt_enricher.py"
click node_skill_images "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/image_generator.py"
click node_genius "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/genius_api.py"
click node_skill_brand "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/brand_profile.py"
click node_stock "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/magnific_stock.py"
click node_html "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/griky_html.py"
click node_icons "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/griky_icons.py"
click node_html_generator "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/referencias/interactivo-html-esam/scripts/generar_planb_html.py"
click node_montage "https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/referencias/interactivo-html-esam/scripts/guion_a_montaje.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli toneBlue
class node_brief,node_extractor,node_prompt,node_enricher,node_brand,node_images,node_validate,node_overlay,node_sharepoint,node_paths,node_pages toneAmber
class node_skill_runner,node_locator,node_skill_prompt,node_skill_enrich,node_skill_images,node_genius,node_skill_brand,node_stock,node_html,node_icons toneMint
class node_html_generator,node_montage toneRose
class node_operator,node_openai toneIndigo
```

## Components

### Local pipeline

- [Pipeline CLI](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/generar.py): `generar.py`

### Shared processing

- [Brief parser](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brief_parser.py): `src/brief_parser.py`
- [AI brief extractor](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brief_extractor.py): `src/brief_extractor.py`
- [Prompt builder](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/prompt_builder.py): `src/prompt_builder.py`
- [Prompt enricher](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/prompt_enricher.py): `src/prompt_enricher.py`
- [Brand profiles](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/brand_profile.py): `src/brand_profile.py`
- [Image generation](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/image_generator.py): `src/image_generator.py`
- [Image validation](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/validator.py): `src/validator.py`
- [Logo composition](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/logo_overlay.py): `src/logo_overlay.py`
- [SharePoint integration](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/sharepoint.py): `src/sharepoint.py`
- [Path utilities](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/paths.py): `src/paths.py`
- [Page scripts](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/src/guion_pages.py): `src/guion_pages.py`

### Cowork skill

- [Skill pipeline](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/run_pipeline.py): `skill_build/infografias-griky/scripts/run_pipeline.py`
- [Brief locator](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/brief_locator.py): `skill_build/infografias-griky/scripts/brief_locator.py`
- [Skill prompt tools](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/prompt_builder.py): `skill_build/infografias-griky/scripts/prompt_builder.py`
- [Skill prompt enricher](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/prompt_enricher.py): `skill_build/infografias-griky/scripts/prompt_enricher.py`
- [Skill image generator](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/image_generator.py): `skill_build/infografias-griky/scripts/image_generator.py`
- [Genius API client](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/genius_api.py): `skill_build/infografias-griky/scripts/genius_api.py`
- [Skill brand profiles](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/brand_profile.py): `skill_build/infografias-griky/scripts/brand_profile.py`
- [Stock integration](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/magnific_stock.py): `skill_build/infografias-griky/scripts/magnific_stock.py`
- [HTML renderer](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/griky_html.py): `skill_build/infografias-griky/scripts/griky_html.py`
- [Icon utilities](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/skill_build/infografias-griky/scripts/griky_icons.py): `skill_build/infografias-griky/scripts/griky_icons.py`

### Interactive reference

- [ESAM HTML generator](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/referencias/interactivo-html-esam/scripts/generar_planb_html.py): `referencias/interactivo-html-esam/scripts/generar_planb_html.py`
- [Script-to-montage](https://github.com/grikyproducto/infografia-automatizaci-n-griky/blob/main/referencias/interactivo-html-esam/scripts/guion_a_montaje.py): `referencias/interactivo-html-esam/scripts/guion_a_montaje.py`

### Other components

- **Content operator**
- **OpenAI services**

## Connections

- Content operator → Pipeline CLI: runs (evidence: `README.md`)
- Pipeline CLI → Brief parser: parses briefs (evidence: `generar.py`)
- Pipeline CLI → AI brief extractor: extracts briefs (evidence: `generar.py`)
- Pipeline CLI → Prompt builder: builds prompts (evidence: `generar.py`)
- Pipeline CLI → Prompt enricher: enriches prompts (evidence: `generar.py`)
- Pipeline CLI → Brand profiles: loads profiles (evidence: `generar.py`)
- Pipeline CLI → Image generation: generates images (evidence: `generar.py`)
- Image generation → OpenAI services: calls image API (evidence: `src/image_generator.py`)
- Pipeline CLI → Image validation: validates output (evidence: `generar.py`)
- Pipeline CLI → Logo composition: applies overlays (evidence: `generar.py`)
- Pipeline CLI → SharePoint integration: uploads optionally (evidence: `README.md`)
- Brief parser → Path utilities: uses utilities (evidence: `src/brief_parser.py`)
- Prompt builder → Brief parser: reads brief (evidence: `src/prompt_builder.py`)
- Prompt enricher → AI brief extractor: uses extraction (evidence: `src/prompt_enricher.py`)
- Content operator → Skill pipeline: runs skill (evidence: `README.md`)
- Skill pipeline → Brief locator: locates briefs (evidence: `skill_build/infografias-griky/scripts/run_pipeline.py`)
- Skill pipeline → Skill prompt tools: builds prompts (evidence: `skill_build/infografias-griky/scripts/run_pipeline.py`)
- Skill pipeline → Skill prompt enricher: enriches prompts (evidence: `skill_build/infografias-griky/scripts/run_pipeline.py`)
- Skill pipeline → Skill image generator: generates images (evidence: `skill_build/infografias-griky/scripts/run_pipeline.py`)
- Skill pipeline → Image validation: validates output (evidence: `skill_build/infografias-griky/scripts/run_pipeline.py`)
- Skill image generator → Genius API client: requests generation (evidence: `skill_build/infografias-griky/scripts/image_generator.py`)
- Skill prompt enricher → Genius API client: requests enrichment (evidence: `skill_build/infografias-griky/scripts/prompt_enricher.py`)
- Skill image generator → Skill brand profiles: loads profile (evidence: `skill_build/infografias-griky/scripts/image_generator.py`)
- Skill image generator → Skill prompt enricher: uses prompts (evidence: `skill_build/infografias-griky/scripts/image_generator.py`)
- Stock integration → Genius API client: uses API (evidence: `skill_build/infografias-griky/scripts/magnific_stock.py`)
- HTML renderer → Icon utilities: uses icons (evidence: `skill_build/infografias-griky/scripts/griky_html.py`)
- Content operator → ESAM HTML generator: uses reference (evidence: `README.md`)
- ESAM HTML generator → Script-to-montage: uses montage (evidence: `referencias/interactivo-html-esam/scripts/generar_planb_html.py`)
