Communitygithub.com

grahama1970/agent-stack-public

Audita, sincroniza y actualiza el sitio público grahama.co y las superficies del currículum a partir de README.md y RESUME.md.

¿Qué es agent-stack-public?

Esta habilidad permite auditar, sincronizar y actualizar el sitio web público grahama.co y todas las superficies del currículum (resumen) a partir de los archivos README.md y RESUME.md, que son las fuentes de verdad. Realiza auditorías de solo informe para detectar desviaciones entre los proyectos seleccionados en el README y el archivo site/content.json, así como la salud del sitio en vivo. Con el comando `apply` se regenera site/content.json desde el README, y con `update` se propagan los cambios del README y RESUME.md al contenido del sitio, al JSON del currículum, a los formatos Markdown, PDF, DOCX, llms.txt y a los JSON de handoff para LinkedIn. Es compatible con entornos de desarrollo local y despliegue mediante GitHub Actions. Su arquitectura de solo informe por defecto evita mutaciones accidentales; el usuario debe confirmar explícitamente los commits y despliegues. Incluye verificaciones de integridad de diseño, revisión de sitios congelados y contratos de voz, todo diseñado para mantener la coherencia y la calidad artesanal del sitio.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/grahama1970/agent-stack-public/tree/HEAD/skills/monitor-website

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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. audit nunca muta. apply escribe solo site/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; apply conserva 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-deploy má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.co o grahama.co/resume debe ejecutar el descubrimiento y la reproducción de test-interactions en 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 enlaces mailto: 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: update es 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 a ops-linkedin. No aplica cambios de LinkedIn ni reclama verificación de plataforma.
  • URLs de revisión: review-site separa la integridad determinista de candidate_fingerprint del enrutamiento de solo tiempo de ejecución de access_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-review mantiene 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ónFuenteDesviación cuando
stats.skills / sanity / agentsTabla "De un vistazo" de READMElos números difieren de content.json
pertenencia de proyectosNombres <strong> de fichas de proyecto de README + hrefsslug presente solo en un lado, o href cambiado
sitio en vivohttps://grahama.co, /sitemap.xmlno 200, o la página de inicio carece de un nav data-qid
superficie del currículumRESUME.md vs site/resume.jsonel commit sellado != HEAD, o el sourceSha256 registrado != el resumen real de RESUME.md
currículum en vivo/resume, /resume.pdf, /resume.docx, /resume.mdno 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.md
  • site/DESIGN.md
  • skills/monitor-website/local/docs/BRAND.md
  • skills/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.

Skills relacionados