Los sitios web están hechos para el promedio. Chameleon los adapta para que cualquiera logre lo que vino a hacer.
Una extensión de navegador aplica un tema sobre cada página, sin tocar el sitio original. El tema sale de agentes de IA que recorren el sitio como lo haría una persona y encuentran dónde se pierde.
chameleonmode.app, con la descarga para Firefox y Chrome · Platanus Hack 26: Santiago ft. Buk · Track 🔗 Multiplayer
El tema de una página sale de una revisión, que se le pide a la API (just aws revision <url>). La extensión
solo consulta las que existen:
flowchart LR
P[Pedido de revisión] --> A[API]
A --> C[Catalogador]
C -->|un objetivo| G1[Guía] --> V1[Visitante]
C -->|otro objetivo| G2[Guía] --> V2[Visitante]
V1 --> D[Diseñador]
V2 --> D
D -->|tema.css| E[Extensión]
- El Catalogador lee la página y elige qué viene a hacer la gente en ella.
- Por cada objetivo, varios a la vez, la Guía encuentra y verifica el camino con el DOM; después el Visitante, un usuario sintético que solo ve capturas, intenta recorrerlo.
- El Diseñador escribe el tema con lo que aprendieron, y la extensión lo aplica para todos los que visitan esa página.
Cada paso queda en S3 y el estado de la revisión en DynamoDB, así que el backoffice muestra a los agentes trabajando mientras avanzan.
| Pieza | Qué es |
|---|---|
extension/ |
Extensión de Firefox y Chrome que aplica el tema de cada página |
backend/ |
API de revisiones: dispara la revisión de una página y entrega su tema |
backoffice/ |
Visor de las revisiones y de los recorridos de los agentes |
agents/app/conductor/ |
Conductor: corre una revisión completa, etapa por etapa |
agents/app/cataloger/ |
Catalogador: cataloga los objetivos de un sitio, clasificados |
agents/app/guide/ |
Guía: encuentra y verifica la ruta de un objetivo, con el DOM y capturas |
agents/app/visitor/ |
Visitante: usuarios sintéticos que intentan un objetivo viendo solo capturas |
agents/app/web_designer/ |
Diseñador: escribe el tema de la página |
agents/app/summary/ |
Resumen de un sitio: la ruta de la Guía contra los intentos del Visitante |
agents/app/runtime/ |
Entrada de los agentes en AWS AgentCore |
agents/shared/ |
Lo que comparten los agentes: almacén, navegador, Claude, nodos, DOM y catálogo |
infra/ |
Terraform y AgentCore: API, almacén, tabla, backoffice y runtime |
Más detalle en docs/: arquitectura, objetivos y métricas y glosario.
No hace falta clonar nada:
- Instala la extensión desde chameleonmode.app. Todavía no está en las
tiendas: la de Firefox (140 o superior) viene firmada por Mozilla y se instala desde el botón; la de Chrome (148 o
superior) es un
.zipque se carga enchrome://extensionscon el modo desarrollador. - Entra a una de las páginas de la demo, las que siembra
just aws seed: las 8 deagents/tasks/demo.json(metro.cl, sii.cl, wom.cl, dt.gob.cl y otras). El tema es de esa página: las demás del mismo sitio quedan tal cual. - El ícono de la extensión abre un interruptor que prende y apaga el tema; apagado, la página queda como la dejó el sitio.
El backoffice muestra cada revisión: los objetivos que encontró, el recorrido de cada usuario sintético y el tema que quedó.
Requisitos: just (brew install just), Node.js 22 o más reciente con npm,
uv, Firefox
(la extensión también corre en Chrome 148 o superior: npm run dev:chrome, ver extension/README.md)
y, para los pasos 4, 5, 6, 8 y 9, Claude Code con la sesión iniciada. Probado en macOS. Desde un
clon nuevo, en este orden:
just local setup # 1. once, after cloning: checks requirements, installs dependencies
just local up # 2. backend, backoffice (http://localhost:4848/backoffice/) and a separate Firefox with the extension, in the background
just local up sesion # same, with a copy of your Firefox profile (made the first time)
just local down # stops them (just local logs follows their logs)
just local test # 3. before pushing: every test that does not call Claude
just local catalog <url> # 4. cataloger: goal catalog of a site (calls Claude)
just local guide <host>/<goal> # 5. guide: reference route of a task in agents/tasks/ (calls Claude)
just local visit <url> "<task>" # 6. visitor: synthetic users try a task on a site (calls Claude)
just local visit-tasks [wom|sii|dt] # visitor on the tasks in agents/tasks/ (calls Claude)
just local backoffice # 7. viewer of the visitor runs
just local revision <url> # 8. the whole pipeline on one page: catalog, guide and visitor per goal, and tema.css (calls Claude)
just local site <url> [goals] # 9. per site, without tema.css: catalog, guide and visitor per goal, and a summary (calls Claude)
just local summary <url> # rewrites that summary from the files on diskCada pull request a main corre las mismas pruebas en GitHub Actions (pruebas.yml):
npm run check y pytest en cada proyecto de Python bajo agents/ que tenga tests/, sin llamar a Claude ni a AWS.
El check Todas las pruebas tiene que pasar para mergear.
Los despliegues y las versiones de la extensión corren como GitHub Actions en un repo personal y privado,
brayanmoreno/hackathon-grupo36, una copia de main de este (ver infra/README.md). Necesitan gh con la sesión iniciada:
just sync # copies main to the personal repo now and follows the deploy, if any
just publish v0.3.0 # signs that version of the extension and publishes it as a releaseCorre just local para ver esta lista. Funciona desde cualquier carpeta del repo; los comandos están en
local/justfile.
Los agentes corren en AgentCore, con Claude en Bedrock (export AWS_PROFILE=<perfil>). just aws revision <url>
revisa una página completa, igual que just local revision <url>, y muestra su avance; just aws seed siembra las
páginas de la demo. Todo se despliega solo al mergear a main: ver el runtime y
la infraestructura. Corre just aws para ver todos los comandos.
- Jorge Eduardo León Reyes (@jorvan758)
- Brayan Moreno Avendaño (@brayanmoreno)
- Rodrigo Elicer Krause (@rodrigoelicer)
- Ariel Ignacio Madariaga González (@arielm-unholster)
