monitor-website
RESUME.md es la fuente de verdad de grahama.co/resume: gen_resume.py lo analiza para generar site/resume.json y copia las exportaciones PDF, DOCX y Markdown en site/public/, de modo que la página, /resume.pdf, /resume.docx y /resume.md son el contenido de un solo commit. La comprobación de resumen más abajo detecta un currículum editado cuya superficie nunca se regeneró.
El sitio público (site/, servido en https://grahama.co) refleja dos superficies seleccionadas en README.md: las fichas de proyecto "Cosas divertidas en las que estoy trabajando" y la tabla de inventario "De un vistazo". README es la fuente de verdad; el sitio lee site/content.json. Esta habilidad los mantiene honestos.
Comandos
# Solo informe: desviación README vs content.json + salud del sitio en vivo. Sale con 1 si hay desviación.
./run.sh audit --json
# Solo informe: falla si BRAND.md / DESIGN.md son prosa de intención vaga en lugar de contratos concretos de marca + diseño.
./run.sh design-contract-check --json
# Omitir las pruebas del sitio en vivo https://grahama.co (fuera de línea / antes de DNS)
./run.sh audit --no-live --json
# Regenerar site/content.json desde el README (estadísticas siempre; conjunto de proyectos
# agregar/eliminar por slug — los textos existentes se conservan, los nuevos proyectos toman el
# texto de la ficha del README). NO hace commit ni push.
./run.sh apply
# Apply y luego comprobar que el sitio aún se construye y pasa la puerta qid.
./run.sh apply --build
# Regenerar las superficies generadas (inventory.json, artifacts.json,
# generated/battle-lineage.json, research-map.json) desde el estado actual del repo,
# con puerta qid + build; --commit/--push son explícitos.
# battle-lineage.json se deriva del fixture en vivo battle-004 registrado
# y falla cerrado si ese fixture se desvía de su forma afirmada.
# research-map.json agrupa los proyectos en una taxonomía de áreas de investigación DECLARADA
# (las áreas se mantienen en gen_research_map.py, no inferidas por LLM) y cuenta
# las habilidades coincidentes por área — el minimapa de la página de inicio se genera, no es prosa.
# El texto (preguntas/textos/secciones) NUNCA se modifica con refresh.
./run.sh refresh
./run.sh refresh --commit --push
# Una cascada de colaboración local única para las actualizaciones de Graham + project-agent. Este es
# el comando para ejecutar después de editar README.md o RESUME.md.
#
# Fuentes:
# README.md -> site/content.json y superficies generadas del sitio público
# RESUME.md -> currículum PDF, DOCX, Markdown, site/resume.json, llms.txt
# RESUME.md -> JSON editable ops-linkedin.profile_entry.v1
#
# LinkedIn es solo un handoff local: execution_claim permanece como NOT_EXECUTED y no se
# produce acceso a navegador ni a la plataforma LinkedIn aquí.
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build
# Alias estables para humanos que piensan en esto como el monitor de grahama.co en lugar de
# el monitor genérico del sitio web.
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan
# Congelar unidades de revisión de sección/estado de página y servir una URL de capacidad de bucle invertido.
./run.sh review-site prepare --url http://127.0.0.1:3003/ --out /tmp/grahama-review --json
./run.sh review-site verify --run-dir /tmp/grahama-review --json
./run.sh review-site serve --run-dir /tmp/grahama-review --bind 127.0.0.1 --port 43117 --json
./run.sh review-site stop --run-dir /tmp/grahama-review --json
# Verificar el transporte del revisor G11 basado en URL sin consumir un asiento de evaluador.
./run.sh design-review preflight --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --json
./run.sh design-review submit --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --prompt prompt.md --out /tmp/rater --json
./run.sh design-review verify --rater-dir /tmp/rater --json
Un servicio nocturno deshabilitado por defecto está registrado en
agents/website-maintainer/services.yaml (convención del repositorio: las entradas cron se envían deshabilitadas; habilitar solo cuando el entorno del programador esté listo).
Contrato
- Solo informe por defecto.
auditnunca muta.applyescribe solosite/content.json; el commit, push y el despliegue de Pages siguen siendo acciones explícitas de quien lo invoca (hacer push a main activa.github/workflows/site-deploy.yml). - La prosa no se sobrescribe. Los textos del sitio pueden ser más ricos que los pies de foto de las fichas del README;
applyconserva los textos existentes para los proyectos que permanecen, y solo se sincronizan la pertenencia (slugs/hrefs) y las estadísticas. - Prueba: el JSON de auditoría informa cada elemento de desviación; después de que un cambio aplicado llega a main, el recibo es una ejecución verde de
site-deploymás una lectura curl de los valores modificados en https://grahama.co. - Puerta de interacción: cualquier cambio visible en la interfaz de usuario de
grahama.coograhama.co/resumedebe ejecutar el descubrimiento y la reproducción detest-interactionsen la superficie modificada antes del commit/push. El manifiesto debe provenir del DOM en vivo, y los controles que lanzan protocolos, como el correo electrónico de la navegación superior, deben probarse como comportamiento en la página o clasificarse explícitamente como enlaces externos de solo espera. Los controles de contacto por correo electrónico en estas superficies utilizan por defecto botones de copia al portapapeles; los enlacesmailto:sin procesar son una regresión a menos que una tarea requiera explícitamente el comportamiento de lanzamiento nativo del cliente de correo. - Cascada de una sola fuente:
updatees la ruta de colaboración project-agent/Graham. Ejecuta los exportadores de currículum existentes antes del generador del sitio, luego delega el JSON del perfil de LinkedIn y la planificación opcional de sincronización del propio perfil aops-linkedin. No aplica cambios de LinkedIn ni reclama verificación de plataforma. - URLs de revisión:
review-sitesepara la integridad determinista decandidate_fingerprintdel enrutamiento de solo tiempo de ejecución deaccess_nonce. Consume el manifiesto del corpus de secciones, copia las representaciones canónicas en el paquete de revisión, sirve solo en bucle invertido por defecto y nunca trata la URL opaca como autenticación para material privado, regulado o ITAR. - Recibos del revisor:
design-reviewmantiene separados los estados de transporte, inspección y evaluador. Un preflight puede probar el acceso a URL/fingerprint/unidad/imagen canónica, pero nunca consume un asiento de evaluador. Un evaluador es utilizable solo cuando la salida sin procesar del proveedor se conserva y refleja la fingerprint esperada, los ids de unidad y el canario de revisión.
Qué comprueba la auditoría
| Comprobación | Fuente | Desviación cuando |
|---|---|---|
| stats.skills / sanity / agents | Tabla "De un vistazo" de README | los números difieren de content.json |
| pertenencia de proyectos | Nombres <strong> de fichas de proyecto de README + hrefs | slug presente solo en un lado, o href cambiado |
| sitio en vivo | https://grahama.co, /sitemap.xml | no 200, o la página de inicio carece de un nav data-qid |
| superficie del currículum | RESUME.md vs site/resume.json | el commit sellado != HEAD, o el sourceSha256 registrado != el resumen real de RESUME.md |
| currículum en vivo | /resume, /resume.pdf, /resume.docx, /resume.md | no 200, o el archivo servido no es la página/PDF/DOCX/Markdown esperado |
Intención de marca/diseño — curiosidad sobre categoría
Antes de proponer o aplicar cambios de diseño o posicionamiento de grahama.co, lea:
site/BRAND.mdsite/DESIGN.mdskills/monitor-website/local/docs/BRAND.mdskills/monitor-website/local/docs/DESIGN.md
Luego ejecute skills/monitor-website/run.sh design-contract-check --json. Un DESIGN.md superficial o basado en vibraciones es un contrato fallido, no un primer borrador aceptable.
El sitio está destinado a ser descubierto, entretenido, honesto, hecho a medida e inconfundiblemente Graham. No lo normalice a una propuesta de valor de servicios de IA, tecnología de defensa, tipo Palantir, tipo Straive o I+D genérica. Trate lo inusual como intencional a menos que la evidencia actual muestre un defecto de hecho, accesibilidad, procedencia o ruta rota.
Mantenimiento del diseño — contrato visual-personalizado (#1337)
El mantenimiento del diseño/identidad visual de grahama.co se compone con
best-practices-bespoke-design y best-practices-font. El mundo visual del sitio está bloqueado en
site/design-world.yml (fuente de verdad automatizada) + site/DESIGN_WORLD.md
(legible): una premisa narrativa, tres invariantes no cromáticas, la gramática de roles completa
y los residuos prohibidos de plantillas de IA estructurales.
Un rediseño visual nunca puede informarse como listo desde la confianza en prosa. Para el trabajo de reparación local normal, ejecute el carril de renderizado determinista:
skills/monitor-website/run.sh design-render-check --json
Valida el contrato fuente, el bloqueo fuente, las prohibiciones comprobables de forma determinista,
el recibo de tipo, la geometría de recorte de sección responsiva y el recibo
renderizado artesanal. Este carril puede devolver PASS, pero explícitamente no prueba el estado LISTO formal de diseño-personalizado,
la distintividad ciega, la resistencia al intercambio de competidores, la finalización de accesibilidad
o el rendimiento en campo.
Ejecute el carril de certificación formal solo cuando la tarea actual sea una puerta final de diseño-personalizado:
skills/monitor-website/run.sh design-certify --json
design-certify incluye el recibo del evaluador ciego G11 y sale con código distinto de cero a menos que
cada puerta sea PASS. Las salidas de evaluador actuales faltantes son NOT_TESTED, no un fallo de renderizado del sitio.
design-world-check permanece como un alias de compatibilidad para el comprobador
formal; prefiera los dos comandos explícitos anteriores.
Contrato de voz (#1298)
La voz humana en primera persona de grahama.co está bloqueada en site/VOICE.md (contrato) +
site/voice-anchors.yml (líneas de firma). Los trabajos automatizados pueden validar,
sincronizar metadatos fácticos y publicar notas aprobadas, pero no pueden
reescribir la prosa del sitio a menos que un archivo fuente creado por humanos haya cambiado. Solo informe, determinista:
skills/monitor-website/run.sh copy-audit --json
Marca nosotros/nuestro/nos en primera persona, superlativos de startups de IA,
marcadores de posición/lorem y cualquier línea de firma que haya desaparecido del texto.
Las etiquetas de evidencia permanecen derivadas de metadatos estructurados — la prosa no puede fortalecerlas.