Communitygithub.com

grahama1970/agent-stack-public

Audite, sincronize e atualize o site público grahama.co e as superfícies de currículo a partir de README.md e RESUME.md. Auditoria apenas com relatório detecta desvios entre projetos/inventário curados do README e site/content.json, além da saúde do site ativo; apply regenera content.json a partir do README; update propaga alterações do README/RESUME para o conteúdo do site, JSON de currículo, Markdown, PDF, DOCX, llms.txt e handoffs JSON do ops-linkedin. Use para "o site está atualizado", "sincronizar o site com o README", "desvio do site", "monitorar grahamaco" ou após editar cartões de projeto do README, a tabela 'At a Glance' ou RESUME.md.

O que é agent-stack-public?

Esta skill implementa um sistema completo de auditoria e sincronização para o site pessoal grahama.co, garantindo que o site público reflita fielmente as fontes de verdade em README.md (cartões de projeto e tabela de inventário) e RESUME.md (currículo). Ela oferece três modos principais: `audit` (apenas relatório), `apply` (regeneração local) e `update` (cascata completa de colaboração para projeto-agent/Graham). Suporta auditoria de desvio entre README e content.json, verificação de saúde do site ativo (código 200 + data-qid), verificação de contrato de design/identidade visual (BRAND.md/DESIGN.md), revisão de design com provas cegas (G11) e revisão de seções congeladas do site. A skill é projetada para ser segura por padrão: comandos de auditoria nunca mutam, apply só escreve site/content.json, e commit/push são ações explícitas do chamador. Ela também preserva textos enriquecidos (blurbs) existentes, sincroniza apenas associação de projetos (slugs/hrefs) e estatísticas, e inclui verificações de voz (primeira pessoa, sem superlativos de startup de IA) e contrato de design visual (proibição de resíduos de template de IA). A skill pode ser usada em plataformas como Claude Code, Cursor ou Codex, e seus comandos são executados via `./run.sh` com saída JSON para integração programática.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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. audit nunca modifica. apply escreve apenas site/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; apply preserva 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-deploy mais uma leitura curl dos valores alterados em https://grahama.co.
  • Verificação de interação: Qualquer alteração visível na UI de grahama.co ou grahama.co/resume deve executar a descoberta e reprodução de test-interactions na 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; links mailto: 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 para ops-linkedin. Ele não aplica alterações no LinkedIn nem reivindica verificação da plataforma.
  • URLs de revisão: review-site separa a integridade determinística de candidate_fingerprint do roteamento de runtime access_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-review manté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çãoFonteDesvio quando
stats.skills / sanity / agentsTabela "At a Glance" do READMEnúmeros diferem de content.json
associação de projetosnomes <strong> dos cartões de projeto README + hrefsslug presente em apenas um lado, ou href alterado
site ativohttps://grahama.co, /sitemap.xmlnão-200, ou página inicial faltando um data-qid de navegação
superfície do currículoRESUME.md vs site/resume.jsoncommit carimbado != HEAD, ou sourceSha256 registrado != digest real do RESUME.md
currículo ativo/resume, /resume.pdf, /resume.docx, /resume.mdnã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.md
  • site/DESIGN.md
  • skills/monitor-website/local/docs/BRAND.md
  • skills/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.

Habilidades Relacionadas