monitor-website
RESUME.md é a fonte da verdade para grahama.co/resume: gen_resume.py o analisa e gera site/resume.json, copiando os exports PDF, DOCX e Markdown para site/public/, de modo que a página, /resume.pdf, /resume.docx e /resume.md são o conteúdo de um único commit. A verificação de resumo abaixo detecta um currículo editado cuja superfície nunca foi regenerada.
O site público (site/, servido em https://grahama.co) espelha duas superfícies curadas em README.md: os cartões de projeto "Coisas Divertidas em que Estou Trabalhando" e a tabela de inventário "At a Glance". O README é a fonte da verdade; o site lê site/content.json. Esta skill os mantém honestos.
Comandos
# Apenas relatório: desvio entre README vs content.json + saúde do site ativo. Exit 1 em caso de desvio.
./run.sh audit --json
# Apenas relatório: falha se BRAND.md / DESIGN.md forem prosa de intenção vaga em vez de
# contratos concretos de marca + design de implementação.
./run.sh design-contract-check --json
# Pula as sondas https://grahama.co ao vivo (uso offline / pré-DNS)
./run.sh audit --no-live --json
# Regenera site/content.json a partir do README (estatísticas sempre; conjunto de projetos
# adiciona/remove por slug — blurbs existentes são preservados, novos projetos recebem o
# blurb do cartão README). NÃO faz commit ou push.
./run.sh apply
# Apply, depois prova que o site ainda compila e passa a verificação qid.
./run.sh apply --build
# Regenera as superfícies geradas (inventory.json, artifacts.json,
# generated/battle-lineage.json, research-map.json) a partir do estado atual do repositório,
# com verificação de qid + build; --commit/--push são explícitos.
# battle-lineage.json é derivado do fixture ao vivo battle-004 registrado
# e falha fechado se esse fixture se desviar de sua forma declarada.
# research-map.json agrupa os projetos em uma taxonomia DECLARADA de área de pesquisa
# (áreas mantidas em gen_research_map.py, não inferidas por LLM) e conta
# habilidades correspondentes por área — o mini-mapa da página inicial é gerado, não prosa.
# O texto (perguntas/blurbs/seções) NUNCA é tocado pelo refresh.
./run.sh refresh
./run.sh refresh --commit --push
# Uma cascata de colaboração local para atualizações de Graham + project-agent. Este é
# o comando a ser executado após editar README.md ou RESUME.md.
#
# Fontes:
# README.md -> site/content.json e superfícies geradas do site público
# RESUME.md -> PDF, DOCX, Markdown do currículo, site/resume.json, llms.txt
# RESUME.md -> JSON editável ops-linkedin.profile_entry.v1
#
# LinkedIn é apenas um handoff local: execution_claim permanece NOT_EXECUTED e nenhum
# acesso a navegador ou plataforma LinkedIn ocorre aqui.
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build
# Aliases estáveis para humanos que pensam nisso como o monitor grahama.co em vez
# do monitor genérico de site.
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan
# Congela unidades de revisão de seção/página e serve uma URL de capacidade de loopback.
./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
# Verifica o transporte de revisor G11 baseado em URL sem consumir um assento de avaliador.
./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
Um serviço noturno desabilitado por padrão está registrado em
agents/website-maintainer/services.yaml (convenção do repositório: entradas cron
são enviadas desabilitadas; ative apenas quando o ambiente do agendador estiver pronto).
Contrato
- Apenas relatório por padrão.
auditnunca modifica.applyescreve apenassite/content.json; commit, push e o deploy do Pages permanecem como ações explícitas do chamador (push para main aciona.github/workflows/site-deploy.yml). - A prosa não é sobrescrita. Blurbs do site podem ser mais ricos que legendas
de cartões README;
applypreserva blurbs existentes para projetos que permanecem e apenas a associação (slugs/hrefs) e estatísticas são sincronizadas. - Prova: O JSON de auditoria relata cada item de desvio; após uma alteração aplicada chegar
ao main, o recibo é uma execução verde
site-deploymais uma leitura curl dos valores alterados em https://grahama.co. - Verificação de interação: Qualquer alteração visível na UI de
grahama.coougrahama.co/resumedeve executar a descoberta e reprodução detest-interactionsna superfície alterada antes de commit/push. O manifesto deve vir do DOM ativo, e controles que lançam protocolos, como e-mail na navegação superior, devem ser testados como comportamento na página ou explicitamente classificados como links externos de espera. Controles de contato por e-mail nessas superfícies padrão são botões de cópia para área de transferência; linksmailto:são uma regressão a menos que uma tarefa exija explicitamente comportamento nativo de inicialização do cliente de e-mail. - Cascata de fonte única:
updateé o caminho de colaboração project-agent/Graham. Ele executa os exportadores de currículo existentes antes do gerador de site, depois delega o JSON de perfil LinkedIn e o planejamento de sincronização opcional do próprio perfil paraops-linkedin. Ele não aplica alterações no LinkedIn nem reivindica verificação da plataforma. - URLs de revisão:
review-sitesepara a integridade determinística decandidate_fingerprintdo roteamento de runtimeaccess_nonce. Ele consome o manifesto do corpus de seções, copia renderizações canônicas no pacote de revisão, serve apenas loopback por padrão e nunca trata a URL opaca como autenticação para material privado, regulamentado ou ITAR. - Recibos de revisor:
design-reviewmantém transporte, inspeção e estados do avaliador separados. Um preflight pode provar acesso à URL/fingerprint/unit/imagem-canônica, mas nunca consome um assento de avaliador. Um avaliador é utilizável apenas quando a saída bruta do provedor é preservada e ecoa o fingerprint esperado, ids de unidade e canário de revisão.
O que a auditoria verifica
| Verificação | Fonte | Desvio quando |
|---|---|---|
| stats.skills / sanity / agents | Tabela "At a Glance" do README | números diferem de content.json |
| associação de projetos | nomes <strong> dos cartões de projeto README + hrefs | slug presente em apenas um lado, ou href alterado |
| site ativo | https://grahama.co, /sitemap.xml | não-200, ou página inicial faltando um data-qid de navegação |
| superfície do currículo | RESUME.md vs site/resume.json | commit carimbado != HEAD, ou sourceSha256 registrado != digest real do RESUME.md |
| currículo ativo | /resume, /resume.pdf, /resume.docx, /resume.md | não-200, ou o arquivo servido não é a página/PDF/DOCX/Markdown esperado |
Intenção de marca/design — curiosidade sobre categoria
Antes de propor ou aplicar alterações de design ou posicionamento em grahama.co, leia:
site/BRAND.mdsite/DESIGN.mdskills/monitor-website/local/docs/BRAND.mdskills/monitor-website/local/docs/DESIGN.md
Depois execute skills/monitor-website/run.sh design-contract-check --json. Um DESIGN.md
fraco ou baseado em vibe é um contrato falho, não uma primeira passagem aceitável.
O site deve ser descoberto, divertido, honesto, artesanal e inconfundivelmente Graham. Não o normalize em uma proposta de valor de serviços de IA, tecnologia de defesa, estilo Palantir, estilo Straive ou P&D genérico. Trate a incomumidade como intencional, a menos que as evidências atuais mostrem um defeito factual, de acessibilidade, proveniência ou caminho quebrado.
Manutenção de design — contrato visual artesanal (#1337)
A manutenção de design/identidade visual de grahama.co compõe-se com
best-practices-bespoke-design e best-practices-font. O mundo visual do site está bloqueado em
site/design-world.yml (fonte da verdade de máquina) + site/DESIGN_WORLD.md
(legível): uma premissa narrativa, três invariantes não relacionados a cor, a gramática completa de função,
e os resíduos proibidos de template de IA estrutural.
Uma reformulação visual nunca pode ser reportada como pronta com base em confiança em prosa. Para reparo local normal, execute o pipeline de renderização determinística:
skills/monitor-website/run.sh design-render-check --json
Ele valida o contrato de origem, o bloqueio de origem, as proibições verificáveis deterministicamente,
o recibo de tipo, a geometria de corte de seção responsiva e o recibo de renderização artesanal.
Este pipeline pode retornar PASS, mas explicitamente não prova PRONTO formal de design artesanal,
distintividade cega, resistência a troca de concorrente, conclusão de acessibilidade ou desempenho em campo.
Execute o pipeline de certificação formal apenas quando a tarefa atual for uma verificação final de design artesanal:
skills/monitor-website/run.sh design-certify --json
design-certify inclui o recibo do avaliador cego G11 e sai com código diferente de zero a menos
que cada verificação seja PASS. Saídas de avaliador ausentes atualmente são NOT_TESTED, não uma falha
de renderização do site. design-world-check permanece como um alias de compatibilidade para o
verificador formal; prefira os dois comandos explícitos acima.
Contrato de voz (#1298)
A voz humana em primeira pessoa de grahama.co está bloqueada em site/VOICE.md (contrato) +
site/voice-anchors.yml (linhas de assinatura). Trabalhos automatizados podem validar,
sincronizar metadados factuais e publicar notas aprovadas, mas não podem reescrever prosa do site
a menos que um arquivo de origem de autoria humana tenha sido alterado. Apenas relatório, determinístico:
skills/monitor-website/run.sh copy-audit --json
Ele sinaliza nós/nosso/nos em primeira pessoa, superlativos de startup de IA,
espaços reservados/lorem e qualquer linha de assinatura que tenha desaparecido do texto. Rótulos de evidência permanecem derivados
de metadados estruturados — a prosa não pode fortalecê-los.