Communitygithub.com

grahama1970/agent-stack-public

Auditez, synchronisez et mettez à jour les surfaces publiques du site grahama.co et du CV à partir de README.md et RESUME.md.

Qu'est-ce que agent-stack-public ?

Cette compétence pour agent IA est conçue pour maintenir la cohérence entre les sources de vérité (README.md, RESUME.md) et les surfaces publiées du site grahama.co. Elle propose des audits en lecture seule qui détectent les dérives entre l'inventaire des projets du README et le fichier `site/content.json`, ainsi que l'état de santé du site en direct. La commande `apply` régénère `content.json` depuis le README, tandis que `update` cascade les modifications du README et de RESUME.md vers le contenu du site, le CV au format JSON, Markdown, PDF, DOCX, le fichier `llms.txt` et les exports JSON pour LinkedIn. La compétence respecte des contrats stricts : elle ne modifie jamais la prose existante, ne commit ni ne push automatiquement, et intègre des vérifications de conception, de marque et de voix. Elle supporte des workflows de revue de site avec URL de bouclage et de certification formelle de design sur mesure.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

monitor-website

RESUME.md est la source de vérité pour grahama.co/resume : gen_resume.py le parse en site/resume.json et copie les exports PDF, DOCX et Markdown dans site/public/, de sorte que la page, /resume.pdf, /resume.docx et /resume.md soient le contenu d'un seul commit. La vérification de somme de contrôle ci-dessous détecte un CV modifié dont la surface n'a jamais été régénérée.

Le site public (site/, servi sur https://grahama.co) reflète deux surfaces organisées dans README.md : les cartes de projets "Fun Stuff I'm Working On" et le tableau d'inventaire "At a Glance". Le README est la source de vérité ; le site lit site/content.json. Cette compétence les maintient honnêtes.

Commandes

# Lecture seule : dérive README vs content.json + santé du site en direct. Sortie 1 en cas de dérive.
./run.sh audit --json

# Lecture seule : échoue si BRAND.md / DESIGN.md sont des intentions vagues au lieu de contrats concrets de marque et de conception.
./run.sh design-contract-check --json

# Ignore les sondes https://grahama.co en direct (hors ligne / avant DNS)
./run.sh audit --no-live --json

# Régénère site/content.json depuis le README (statistiques toujours ; ajout/suppression de projets par slug — les blurbs existants sont conservés, les nouveaux projets prennent le blurb de la carte README). Ne commit NI ne push.
./run.sh apply

# Apply, puis prouve que le site se construit toujours et passe la porte qid.
./run.sh apply --build

# Régénère les surfaces générées (inventory.json, artifacts.json, generated/battle-lineage.json, research-map.json) depuis l'état actuel du dépôt, vérifie qid + build ; --commit/--push sont explicites.
# battle-lineage.json est dérivé du fixture en direct battle-004 et échoue fermé si ce fixture dérive de sa forme attendue.
# research-map.json regroupe les projets dans une taxonomie DÉCLARÉE de domaines de recherche (domaines maintenus dans gen_research_map.py, pas inférés par LLM) et compte les compétences correspondantes par domaine — la mini-carte de la page d'accueil est générée, pas rédigée.
# Le texte (questions/blurbs/sections) n'est JAMAIS touché par refresh.
./run.sh refresh
./run.sh refresh --commit --push

# Une seule cascade de collaboration locale pour les mises à jour de Graham + projet-agent. C'est la commande à exécuter après avoir modifié README.md ou RESUME.md.
#
# Sources :
#   README.md  -> site/content.json et surfaces générées du site public
#   RESUME.md  -> CV PDF, DOCX, Markdown, site/resume.json, llms.txt
#   RESUME.md  -> JSON éditable ops-linkedin.profile_entry.v1
#
# LinkedIn n'est qu'un transfert local : execution_claim reste NOT_EXECUTED et aucun accès navigateur ou plateforme LinkedIn n'a lieu ici.
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build

# Alias stables pour les humains qui considèrent ceci comme le moniteur grahama.co plutôt que le moniteur de site générique.
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan

# Gèle des unités de revue de section/état de page et sert une URL de capacité en boucle locale.
./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

# Vérifie le transport du reviewer G11 prioritaire à l'URL sans consommer de siège d'évaluateur.
./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 service nocturne désactivé par défaut est enregistré dans agents/website-maintainer/services.yaml (convention du dépôt : les entrées cron sont livrées désactivées ; activer seulement lorsque l'environnement du planificateur est prêt).

Contrat

  • Lecture seule par défaut. audit ne mute jamais. apply écrit seulement site/content.json ; le commit, le push et le déploiement Pages restent des actions explicites de l'appelant (push sur main déclenche .github/workflows/site-deploy.yml).
  • La prose n'est pas écrasée. Les blurbs du site peuvent être plus riches que les légendes des cartes README ; apply préserve les blurbs existants pour les projets qui restent, et seule l'appartenance (slugs/hrefs) et les statistiques sont synchronisées.
  • Preuve : le rapport JSON d'audit liste chaque élément de dérive ; après qu'une modification appliquée atterrit sur main, le reçu est une exécution verte de site-deploy plus une lecture curl des valeurs modifiées sur https://grahama.co.
  • Porte d'interaction : tout changement visible dans l'interface de grahama.co ou grahama.co/resume doit exécuter la découverte et la relecture de test-interactions sur la surface modifiée avant commit/push. Le manifeste doit provenir du DOM en direct, et les contrôles de lancement de protocole tels que l'email de la navigation supérieure doivent être testés comme comportement en page ou explicitement classés comme liens externes à attente seule. Les contrôles de contact par email sur ces surfaces sont par défaut des boutons de copie dans le presse-papier ; les liens bruts mailto: sont une régression sauf si une tâche nécessite explicitement un comportement de lancement de client de messagerie natif.
  • Cascade à source unique : update est le chemin de collaboration projet-agent/Graham. Il exécute les exportateurs de CV existants avant le générateur de site, puis délègue le JSON de profil LinkedIn et la planification de synchronisation de profil optionnelle à ops-linkedin. Il n'applique pas de modifications LinkedIn ni ne revendique de vérification de plateforme.
  • URLs de revue : review-site sépare l'intégrité déterministe candidate_fingerprint du routage d'exécution access_nonce. Il consomme le manifeste du corpus de sections, copie les rendus canoniques dans le bundle de revue, sert par défaut en boucle locale seulement, et ne traite jamais l'URL opaque comme une authentification pour du matériel privé, réglementé ou ITAR.
  • Reçus de reviewer : design-review maintient séparés les états de transport, d'inspection et d'évaluateur. Une pré-vérification peut prouver l'accès à l'URL/empreinte/unité/image canonique, mais ne consomme jamais un siège d'évaluateur. Un évaluateur n'est utilisable que lorsque la sortie brute du fournisseur est préservée et correspond à l'empreinte attendue, aux identifiants d'unité et au canari de revue.

Ce que vérifie l'audit

VérificationSourceDérive quand
stats.skills / sanity / agentsTableau "At a Glance" du READMEles nombres diffèrent de content.json
appartenance aux projetsNoms <strong> des cartes README + hrefsslug présent d'un seul côté, ou href modifié
site en directhttps://grahama.co, /sitemap.xmlnon-200, ou page d'accueil manquant un data-qid de navigation
surface du CVRESUME.md vs site/resume.jsoncommit stampé != HEAD, ou sourceSha256 enregistré != le vrai condensé de RESUME.md
CV en direct/resume, /resume.pdf, /resume.docx, /resume.mdnon-200, ou le fichier servi n'est pas la page/PDF/DOCX/Markdown attendu

Intention de marque/conception — curiosité plutôt que catégorie

Avant de proposer ou d'appliquer des modifications de conception ou de positionnement de grahama.co, lisez :

  • site/BRAND.md
  • site/DESIGN.md
  • skills/monitor-website/local/docs/BRAND.md
  • skills/monitor-website/local/docs/DESIGN.md

Exécutez ensuite skills/monitor-website/run.sh design-contract-check --json. Un DESIGN.md superficiel ou basé sur l'ambiance est un contrat échoué, pas une première version acceptable.

Le site est conçu pour être découvert, divertissant, honnête, sur mesure et indubitablement Graham. Ne le normalisez pas en une proposition de valeur de services IA, technologie de défense, Palantir-like, Straive-like, ou R&D générique. Traitez l'inhabituel comme intentionnel sauf si les preuves actuelles montrent un défaut factuel, d'accessibilité, de provenance ou de chemin cassé.

Maintenance de la conception — contrat visuel sur mesure (#1337)

La maintenance de la conception/identité visuelle de grahama.co se compose avec best-practices-bespoke-design et best-practices-font. Le monde visuel du site est verrouillé dans site/design-world.yml (source de vérité machine) + site/DESIGN_WORLD.md (lisible) : un postulat narratif, trois invariants non colorimétriques, la grammaire complète des rôles, et les résidus interdits de template IA structurel.

Une refonte visuelle ne peut jamais être signalée comme prête sur la base d'une simple confiance textuelle. Pour les travaux de réparation locaux normaux, exécutez le pipeline de rendu déterministe :

skills/monitor-website/run.sh design-render-check --json

Il valide le contrat source, le verrou source, les interdictions vérifiables de manière déterministe, le reçu de type, la géométrie de recadrage de section réactive, et le reçu de rendu artisanal. Ce pipeline peut retourner PASS, mais il ne prouve explicitement pas l'état PRÊT formel de conception sur mesure, la distinctivité aveugle, la résistance au changement de concurrent, l'achèvement de l'accessibilité, ou la performance sur le terrain.

Exécutez le pipeline de certification formelle uniquement lorsque la tâche actuelle est une porte finale de conception sur mesure :

skills/monitor-website/run.sh design-certify --json

design-certify inclut le reçu de l'évaluateur aveugle G11 et sort avec un code non nul sauf si chaque porte est PASS. Les sorties manquantes de l'évaluateur sont NOT_TESTED, pas un échec de rendu du site. design-world-check reste un alias de compatibilité pour le vérificateur formel ; préférez les deux commandes explicites ci-dessus.

Contrat de voix (#1298)

La voix humaine à la première personne de grahama.co est verrouillée dans site/VOICE.md (contrat) + site/voice-anchors.yml (lignes de signature). Les tâches automatisées peuvent valider, synchroniser les métadonnées factuelles et publier les notes approuvées, mais ne peuvent pas réécrire la prose du site sauf si un fichier source rédigé par un humain a changé. Lecture seule, déterministe :

skills/monitor-website/run.sh copy-audit --json

Il signale les nous/notre/nos à la première personne, les superlatifs de startup IA, les espaces réservés/lorem, et toute ligne de signature qui a disparu du texte. Les étiquettes de preuve restent dérivées de métadonnées structurées — la prose ne peut pas les renforcer.

Skills associés