How ice-data-dm/cerebro-gremial-andi works
Purpose and Operating Model
Cerebro Comercial UNIANDI is a file-backed commercial knowledge system for UNIANDI KAMs and AI assistants. It preserves client context, commercial decisions, promotions, incidents, and commitments so future actions reuse organizational learning. The primary entry point is README.md; operational storage conventions begin at vault/README.md, while agent procedures begin at skills/README.md.
Knowledge Vault Boundary
vault/ is the authoritative persistent-memory layer, organized by client, business unit, and team member. It is intended to be read before commercial decisions and updated immediately after activity. There is no application runtime or executable service in this repository; the consumer is an assistant/CRM integration operating over Markdown files.
Paths: vault/README.md, vault/clientes/, vault/unidades/.
Client-Centric Record Aggregate
Each client directory is the central aggregate for account knowledge: a canonical profile, contacts, pending work, and optional operational histories. The profile naming convention (00-ficha.md) establishes a stable account entry record.
Paths: vault/clientes/red-la-vecindad/00-ficha.md, vault/clientes/superandes/contactos.md, vault/clientes/ahorramas/00-ficha.md.
Activity, Incident, and Promotion Streams
Client histories are partitioned into append-oriented streams: bitacora for visits/activity, incidentes for commercial or operational failures, and promociones for campaign learning. Timestamped filenames encode chronology plus business context, enabling recent-activity retrieval and later pattern analysis.
Paths: vault/clientes/red-la-vecindad/bitacora/, vault/clientes/superandes/incidentes/, vault/clientes/red-la-vecindad/promociones/.
Business-Unit Knowledge Dimension
The five UNIANDI business units form a cross-client classification layer. Records identify their unit so an assistant can combine account-specific evidence with portfolio/category knowledge and propagate lessons across customers.
Paths: vault/unidades/alimentos.md, vault/unidades/aseo.md, vault/unidades/cuidado-personal.md.
AI Workflow Skills
skills/ packages repeatable assistant workflows as independently discoverable SKILL.md instructions. These govern the critical control flow: consult institutional knowledge first, act with context, then register outcomes; specialized skills handle onboarding, promotions, incidents, contradiction governance, daily cadence, and executive preparation.
Paths: skills/consultar-antes-de-decidir/SKILL.md, skills/registrar-incidente-completo/SKILL.md, skills/aprendizaje-de-promociones/SKILL.md.
External Integration and Runtime
The stated operational runtime is each KAM’s assistant connected to the external “Cerebro Gremial ANDI” CRM connector. The repository itself supplies durable Markdown knowledge and procedural prompts, not a web service, database, or deployment stack. The assistant/connector is responsible for discovery, retrieval, applying skills, and writing structured records back into vault/.
Paths: README.md, skills/montar-la-colmena/SKILL.md, vault/equipo/david.md.
Main entry points: skills/README.md Skills index · consultar-antes-de-decidir/SKILL.md Consult before deciding · vault/README.md Vault conventions · registrar-incidente-completo/SKILL.md Register complete incident
Components 20
Knowledge Vault
Authoritative Markdown persistent memory.
- Vault conventions · Defines operational storage conventions.
vault/README.md - Client record directories · Central account context organized by client.
- Red La Vecindad profile · Canonical account entry record.
vault/clientes/red-la-vecindad/00-ficha.md - AhorraMas profile · Canonical account entry record.
vault/clientes/ahorramas/00-ficha.md - SuperAndes contacts
vault/clientes/superandes/contactos.md - Activity stream · Timestamped visits and commercial activity.
- Incident stream · Commercial and operational failures.
- Promotion stream · Campaign outcomes and learning.
- Business-unit knowledge · Connects account evidence to portfolio knowledge.
- Foods unit
vault/unidades/alimentos.md - Cleaning unit
vault/unidades/aseo.md - Personal care unit
vault/unidades/cuidado-personal.md - KAM record
vault/equipo/david.md
Assistant Skills
Procedural workflows for assistants.
- Skills index · Entry point for agent procedures.
skills/README.md - Consult before deciding · Requires institutional knowledge retrieval before action.
skills/consultar-antes-de-decidir/SKILL.md - Register complete incident · Guides structured incident capture.
skills/registrar-incidente-completo/SKILL.md - Promotion learning · Captures and reuses campaign learning.
skills/aprendizaje-de-promociones/SKILL.md - Mount the hive · Sets up the assistant operating workflow.
skills/montar-la-colmena/SKILL.md
Operational Runtime
External assistant and CRM integration.
- KAM assistant + CRM connector · Discovers, retrieves, applies skills, and writes Markdown records.
Other components
- Repository entry point · Explains the operating model and boundaries.
README.md
Connections 27
- Repository entry point → Vault conventions: introduces
- Repository entry point → Skills index: points to
- Vault conventions → Client record directories: governs
- Vault conventions → Business-unit knowledge: governs
- Client record directories → Red La Vecindad profile: contains
- Client record directories → AhorraMas profile: contains
- Client record directories → SuperAndes contacts: contains
- Client record directories → Activity stream: records
- Client record directories → Incident stream: records
- Client record directories → Promotion stream: records
- Business-unit knowledge → Foods unit: includes
- Business-unit knowledge → Cleaning unit: includes
- Business-unit knowledge → Personal care unit: includes
- Skills index → Consult before deciding: indexes
- Skills index → Register complete incident: indexes
- Skills index → Promotion learning: indexes
- Skills index → Mount the hive: indexes
- KAM assistant + CRM connector → Consult before deciding: applies
- Consult before deciding → Client record directories: retrieves context from
- Consult before deciding → Business-unit knowledge: combines with
- KAM assistant + CRM connector → Register complete incident: uses to register
- Register complete incident → Incident stream: writes
- KAM assistant + CRM connector → Promotion learning: uses to learn
- Promotion learning → Promotion stream: writes
- KAM assistant + CRM connector → Activity stream: updates after activity
- KAM assistant + CRM connector → KAM record: supports
- Mount the hive → KAM assistant + CRM connector: configures workflow for