---
name: ingest-source
description: Digiere una fuente (PDF, link, vídeo de YouTube, captura, nota, política, transcripción) y la guarda PRE-ANALIZADA en la base de conocimiento de un proyecto siguiendo el modelo raw → wiki → schema. Úsalo cuando Vanessa suelte una fuente, pegue links, o diga "ingiere/digiere esto", "guárdalo en la biblioteca/knowledge", "mete esta fuente al proyecto". Convierte datos crudos en un digest enlazado a su fuente (como el índice de un libro) para que el contexto futuro sea preciso.
allowed-tools: Read, Edit, Write, Bash, Glob, Grep, WebFetch, WebSearch
metadata:
  category: Knowledge & Systems
  tags:
  - knowledge-base
  - ingestion
  - cos
  - second-brain
---

# 📥 ingest-source — digerir una fuente a la biblioteca del proyecto

Formaliza la pieza nº2 del sistema de los vídeos (Austin Marchese): coger
cualquier fuente, **pre-analizar** sus conceptos y guardarlos pre-digeridos en
la base de conocimiento del proyecto. No se guardan datos crudos sin más: se
crea un digest (como el índice de un libro) para que Claude sepa exactamente
dónde mirar y el contexto sea preciso.

Modelo de 3 capas (definido en cada `knowledge/SCHEMA.md`):
`raw/` (fuente cruda, no se edita) → `wiki/` (digest de Claude) → `SCHEMA.md`
(reglas + índice de fuentes).

## Cuándo se dispara
- Vanessa suelta una fuente en un proyecto o pega links / texto / un PDF.
- Dice "ingiere esto", "digiere", "guárdalo en la biblioteca / en knowledge",
  "mete esta fuente al proyecto", o comparte una URL de YouTube para guardar.
- Tras una investigación web que conviene conservar como conocimiento del proyecto.

## Procedimiento

1. **Localiza el proyecto activo y su `knowledge/`.**
   - Determina en qué proyecto estamos (carpeta de `Projects/` en contexto, o
     pregunta en una línea si es ambiguo).
   - Si NO existe `knowledge/` → créala con las 3 capas: `knowledge/raw/`,
     `knowledge/wiki/` y un `knowledge/SCHEMA.md` (copia la plantilla de
     `Projects/photo-collage/knowledge/SCHEMA.md`, adaptando el nombre del proyecto).
   - Lee el `SCHEMA.md` existente para respetar sus convenciones de nombres.

2. **Captura la fuente en `raw/` (la fuente de verdad, nunca se edita).**
   - Archivo: `raw/<tema>-<fuente>.md` (ej. `raw/oauth-drive-scope-googledocs.md`).
   - **Link / web:** guarda **URL + fecha de captura + por qué importa**, y si
     puedes, pega el texto clave (usa WebFetch para traer el contenido).
   - **YouTube:** usa el skill `youtube-transcript` para traer transcripción +
     metadatos y guárdalos en `raw/`.
   - **PDF / captura / nota que Vanessa ya dejó en el proyecto:** déjala donde
     está (es ya la fuente cruda) y referénciala desde el wiki.

3. **Crea/actualiza el digest en `wiki/<tema>.md`.** Un tema por archivo. Incluye:
   - **Fuente(s):** enlace(s) al archivo/URL en `raw/`.
   - **Resumen** en lenguaje claro (con paréntesis explicativos para términos
     técnicos — Vanessa es química PhD sin background de programación).
   - **Conceptos clave** (bullets).
   - **"Qué hacemos con esto"** — implicaciones concretas para ESTE proyecto/negocio.
   - Si actualiza un digest existente: integra, no dupliques; marca lo que cambió.

4. **Apunta la fuente en el índice de `SCHEMA.md`** (tabla raw → wiki, estado ✅).

5. **Actualiza el log del proyecto** (`<proyecto>_PROJECT_LOG.md`) con una línea
   fechada: qué fuente se ingirió y a qué wiki fue.

6. **Resume en una línea**: qué se digirió, en qué `wiki/` quedó, y cualquier
   contradicción/hueco detectado frente a lo ya guardado.

## Reglas
- **Nunca edites `raw/`** tras guardarlo: es la fuente de verdad.
- Cada digest SIEMPRE enlaza a su fuente en `raw/`.
- Herramientas gratis (WebFetch, youtube-transcript). No requiere suscripciones.
- Si detectas que el digest contradice algo ya en `wiki/`, márcalo para un
  health check (lo resuelve `improve-system` en modo *audit*).
- Plain-language + di qué cuenta se usa si la fuente toca una cuenta concreta.

## Relación con otros skills
- **`improve-system`** (modo *audit*) revisa periódicamente el `wiki/` por
  contradicciones / info obsoleta / huecos que esta ingesta haya dejado.
- Es la pieza *utility* que mejora a todas las demás: cuanto mejor la biblioteca,
  mejores las decisiones de cualquier otro skill.