Remezcla tus Artifacts de Claude: una ficha para cualquier sensor

Este verano hemos montado un DHT22, un BMP280, un GPS, un Sense HAT… y cada sensor nuevo nos ha hecho escribir la misma ficha de instrucciones desde cero: qué componentes hacen falta, cómo se conecta cada pin, qué código lo pone en marcha, y qué hacer cuando algo no funciona. Se puede pedir esa ficha una sola vez y reutilizarla como plantilla para cada sensor nuevo, incluso en una conversación distinta sin tener el Artifact original delante. Aquí tienes el proceso completo, paso a paso, para que lo repitas tú mismo.

El problema que resuelve

Cada sensor o placa nueva que se monta genera su propio documento de instrucciones desde cero. Es el mismo problema que resuelve una función en programación —escribir el bloque una vez y reutilizarlo cambiando los parámetros— pero aplicado esta vez a documentación técnica de montajes.

Lo que necesitas antes de empezar

• Una cuenta de Claude con Artifacts activado (viene activado por defecto).
• Un montaje de hardware sobre el que ya tengas experiencia (en esta guía se usa un DHT22 con una Heltec ESP32, pero funciona con cualquier sensor y placa).

Paso 1 — Crea la ficha técnica base

Pide una ficha técnica interactiva para tu primer montaje, con secciones fijas: componentes, esquema de conexión, código y problemas comunes.

“Crea una ficha técnica interactiva para montar un sensor DHT22 con una placa Heltec ESP32 LoRa V3. Que tenga estas secciones: lista de componentes necesarios, esquema de conexión de pines (DHT22 a los pines de la Heltec), el código base para Arduino IDE que lee la temperatura y la humedad, y una sección de solución de problemas comunes (lecturas en blanco, sensor no detectado, etc). Usa un diseño claro tipo ficha técnica, con pestañas o secciones separadas para cada bloque.”

Revisa el resultado: comprueba que las secciones estén completas y que el código coincide con lo que de verdad necesitas para ese montaje.

Paso 2 — Remézclala para un sensor distinto

En vez de pedir una ficha nueva desde cero para el siguiente sensor, dile a Claude que tome la que ya tienes y la adapte, siendo explícito sobre qué cambia:

“Toma esta ficha técnica de montaje y adáptala para un sensor BMP280 conectado a una Heltec ESP32-S3 por I2C en vez de por pines digitales. Cambia el esquema de conexión a los pines SDA y SCL correspondientes, actualiza el código base para leer presión y temperatura con la librería del BMP280, y cambia la sección de problemas comunes a los típicos de I2C (dirección incorrecta, sensor no responde, lecturas erráticas). Mantén exactamente el mismo diseño de ficha, las mismas secciones y el mismo estilo visual.”

El resultado conserva el diseño y la estructura que ya funcionaban, con contenido técnico completamente nuevo. Compara las dos fichas: el formato debería ser prácticamente idéntico, solo cambia lo específico de cada sensor.

Paso 3 — Llévala a una conversación nueva, sin la ficha original delante

Cuando el salto es más grande —de Arduino a Raspberry Pi, por ejemplo— no hace falta encontrar la conversación antigua: describe de memoria cómo era la ficha en un chat nuevo.

“Hace poco hice una ficha técnica interactiva para montar sensores en placas Arduino/ESP32: tenía secciones de componentes necesarios, esquema de conexión, código base y solución de problemas comunes, con un diseño de pestañas. Hazme la misma ficha pero para conectar el Sense HAT a una Raspberry Pi usando Python: componentes, cómo se conecta el Sense HAT (se acopla directamente a los pines GPIO), el código en Python para leer temperatura y humedad con la librería sense_hat, y los problemas comunes de esa combinación (librería no instalada, permisos, etc).”

Claude reconstruye la misma estructura de ficha para una plataforma y un lenguaje completamente distintos, sin el Artifact original delante.

Avisos

• Al remezclar, indica siempre con precisión qué cambia y qué se mantiene (tipo de conexión, librería, tipo de problema) — una petición vaga deja a Claude adivinando qué conservar del diseño.
• El código que genera Claude para un sensor nuevo conviene probarlo en el montaje real antes de fiarse de él en un proyecto o de dárselo al alumnado — la ficha documenta, pero no sustituye la comprobación física del cableado y del código.

Idea para llevarse a casa

Una ficha técnica reutilizable —componentes, esquema, código, problemas comunes— es la misma idea que la reutilización de código con funciones, aplicada a la documentación de un montaje en vez de al código. Y no se queda en el aula: en cualquier proyecto de electrónica o de ingeniería, tener una plantilla de documentación que ya funciona y remezclarla para cada sensor o placa nueva es de las costumbres que más tiempo ahorran.