Communitygithub.com

grahama1970/agent-stack-public

Website-Überwachung und Sync für grahama.co: Auditiert, synchronisiert und aktualisiert die öffentliche Seite und Resume-Oberflächen aus README.md und RESUME.md.

Was ist agent-stack-public?

Dieses Skill dient der kontinuierlichen Überwachung und Synchronisation der öffentlichen Website grahama.co mit seinen beiden Quellen der Wahrheit: README.md (Projektkarten und „At a Glance“-Tabelle) und RESUME.md (Lebenslauf). Es bietet einen reinen Report-Modus (Audit), der Abweichungen zwischen README, site/content.json und der Live-Site aufdeckt, sowie einen „Apply“-Modus, der site/content.json aus dem README regeneriert. Der „Update“-Befehl führt eine vollständige Kaskade durch: Er aktualisiert alle generierten Resume-Formate (PDF, DOCX, Markdown, JSON, llms.txt) und bereitet optional LinkedIn-Profilaktualisierungen vor (ohne diese auszuführen). Das Skill unterstützt einen strengen Design- und Voice-Contract: Es validiert, dass BRAND.md und DESIGN.md konkrete Designvorgaben enthalten, und stellt sicher, dass der einzigartige, handgeschriebene Stil der Site nicht durch KI-generierte oder generische Inhalte verwässert wird. Es ist ideal für Entwickler, die nach „Ist die Website aktuell?“, „Sync die Site mit dem README“ oder „Website-Drift“ fragen, und wird über die Kommandozeile (run.sh) mit umfangreichen Flags gesteuert.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

monitor-website

RESUME.md ist die Quelle der Wahrheit für grahama.co/resume: gen_resume.py parst es in site/resume.json und kopiert die PDF-, DOCX- und Markdown-Exporte in site/public/, sodass die Seite, /resume.pdf, /resume.docx und /resume.md mit einem einzigen Commit aktuell sind. Der unten stehende Digest-Check erkennt einen bearbeiteten Lebenslauf, dessen Oberfläche nie neu generiert wurde.

Die öffentliche Website (site/, bereitgestellt unter https://grahama.co) spiegelt zwei kuratierte Oberflächen in README.md wider: die Projektkarten „Fun Stuff I'm Working On“ und die Inventartabelle „At a Glance“. Das README ist die Quelle der Wahrheit; die Site liest site/content.json. Dieses Skill hält sie ehrlich.

Befehle

# Nur Bericht: README vs. content.json-Abweichung + Live-Site-Health. Exit 1 bei Abweichung.
./run.sh audit --json

# Nur Bericht: Fehlschlag, wenn BRAND.md / DESIGN.md vage Absichtsprosa statt konkreter
# Marken- und Implementierungsdesignverträge sind.
./run.sh design-contract-check --json

# Überspringe die Live-https://grahama.co-Prüfungen (offline / vor DNS-Verwendung)
./run.sh audit --no-live --json

# Regeneriere site/content.json aus dem README (Statistiken immer; Projektset
# hinzufügen/entfernen per Slug – bestehende Blurbs bleiben erhalten, neue Projekte
# übernehmen den README-Karten-Blurb). Commit oder Push erfolgt NICHT.
./run.sh apply

# Apply, dann beweise, dass die Site noch baut und das qid-Gate besteht.
./run.sh apply --build

# Regeneriere die generierten Oberflächen (inventory.json, artifacts.json,
# generated/battle-lineage.json, research-map.json) aus dem aktuellen Repository-Stand,
# Gate auf qid + Build; --commit/--push sind explizit.
# battle-lineage.json wird aus der aufgezeichneten battle-004-Live-Fixtur abgeleitet
# und schlägt fehl, wenn diese Fixtur von ihrer erwarteten Form abweicht.
# research-map.json gruppiert die Projekte in eine DEKLARIERTE Research-Area-Taxonomie
# (Bereiche werden in gen_research_map.py gepflegt, nicht von LLMs abgeleitet) und zählt
# passende Skills pro Bereich – die Homepage-Minimap wird generiert, nicht als Prosa.
# Kopie (Fragen/Blurbs/Abschnitte) wird NIEMALS durch refresh verändert.
./run.sh refresh
./run.sh refresh --commit --push

# Eine lokale Kollaborationskaskade für Graham + Projektagenten-Updates. Dies ist
# der Befehl, der nach Bearbeitung von README.md oder RESUME.md ausgeführt wird.
#
# Quellen:
#   README.md  -> site/content.json und generierte Public-Site-Oberflächen
#   RESUME.md  -> Lebenslauf-PDF, DOCX, Markdown, site/resume.json, llms.txt
#   RESUME.md  -> editierbares ops-linkedin.profile_entry.v1 JSON
#
# LinkedIn ist nur eine lokale Übergabe: execution_claim bleibt NOT_EXECUTED und es
# findet kein Browser- oder LinkedIn-Plattformzugriff statt.
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build

# Stabile Aliase für Menschen, die dies eher als grahama.co-Monitor denn als
# generischen Website-Monitor betrachten.
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan

# Einfriere Abschnitts-/Seitenzustands-Überprüfungseinheiten und stelle eine Loopback-Fähigkeits-URL bereit.
./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

# Verifiziere URL-basierten G11-Reviewer-Transport, ohne einen Rater-Sitz zu verbrauchen.
./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

Ein standardmäßig deaktivierter nächtlicher Dienst ist unter agents/website-maintainer/services.yaml registriert (Repository-Konvention: Cron-Einträge werden deaktiviert ausgeliefert; nur aktivieren, wenn die Scheduler-Umgebung bereit ist).

Vertrag

  • Standardmäßig nur Bericht. audit mutiert nie. apply schreibt nur site/content.json; Committen, Pushen und das Pages-Deployment bleiben explizite Aktionen des Aufrufers (Push auf main löst .github/workflows/site-deploy.yml aus).
  • Prosa wird nicht überschrieben. Site-Blurbs können umfangreicher sein als README-Karten-Beschriftungen; apply bewahrt vorhandene Blurbs für verbleibende Projekte, und nur die Mitgliedschaft (Slugs/hrefs) und Statistiken werden synchronisiert.
  • Nachweis: Audit-JSON meldet jedes Abweichungselement; nachdem eine angewandte Änderung auf main gelandet ist, ist der Beleg ein grüner site-deploy-Lauf plus ein curl-Rücklesen der geänderten Werte auf https://grahama.co.
  • Interaktions-Gate: Jede sichtbare Änderung an grahama.co oder grahama.co/resume muss vor Commit/Push test-interactions-Erkennung und -Wiederholung auf der geänderten Oberfläche durchlaufen. Das Manifest muss vom Live-DOM stammen, und protokollstartende Steuerelemente wie die obere Navigations-E-Mail müssen als In-Seite-Verhalten getestet oder explizit als externe Warten-auf-Link-Links klassifiziert werden. E-Mail-Kontaktsteuerelemente auf diesen Oberflächen standardmäßig auf Zwischenablage-Kopier-Buttons; rohe mailto:-Links sind ein Rückschritt, es sei denn, eine Aufgabe erfordert explizit natives Mail-Client-Startverhalten.
  • Eine-Quelle-Kaskade: update ist der Projektagent/Graham-Kollaborationspfad. Es führt die vorhandenen Lebenslauf-Exporteure vor dem Site-Generator aus, delegiert dann LinkedIn-Profil-JSON und optionale Own-Profile-Sync-Planung an ops-linkedin. Es wendet keine LinkedIn-Änderungen an oder beansprucht Plattformverifizierung.
  • Review-URLs: review-site trennt deterministische candidate_fingerprint-Integrität von Laufzeit-only-access_nonce-Routing. Es verbraucht das Abschnittskorpus-Manifest, kopiert kanonische Renderings in das Review-Bundle, bedient standardmäßig nur Loopback und behandelt die opaque URL niemals als Authentifizierung für privates, reguliertes oder ITAR-Material.
  • Reviewer-Quittungen: design-review hält Transport-, Inspektions- und Rater-Zustände getrennt. Ein Preflight kann URL/Fingerabdruck/Einheit/Kanonisches-Bild-Zugriff nachweisen, verbraucht aber nie einen Rater-Sitz. Ein Rater ist nur verwendbar, wenn die rohe Provider-Ausgabe erhalten bleibt und den erwarteten Fingerabdruck, die Einheiten-IDs und den Review-Canary widerspiegelt.

Was audit prüft

PrüfungQuelleAbweichung wenn
stats.skills / sanity / agentsREADME „At a Glance“-TabelleZahlen von content.json abweichen
ProjektmitgliedschaftREADME-Projektkarten-<strong>-Namen + hrefsSlug nur auf einer Seite vorhanden oder href geändert
Live-Sitehttps://grahama.co, /sitemap.xmlNicht-200, oder Startseite fehlt ein Nav-data-qid
Lebenslauf-OberflächeRESUME.md vs. site/resume.jsonGestempelter Commit != HEAD, oder aufgezeichneter sourceSha256 != der tatsächliche RESUME.md-Digest
Live-Lebenslauf/resume, /resume.pdf, /resume.docx, /resume.mdNicht-200, oder die bereitgestellte Datei ist nicht die erwartete Seite/PDF/DOCX/Markdown

Marken-/Design-Absicht – Neugier über Kategorie

Bevor Design- oder Positionierungsänderungen an grahama.co vorgeschlagen oder angewendet werden, lies:

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

Führe dann skills/monitor-website/run.sh design-contract-check --json aus. Ein dünnes oder vibe-only DESIGN.md ist ein fehlgeschlagener Vertrag, kein akzeptabler erster Entwurf.

Die Site soll entdeckt werden, unterhaltsam, ehrlich, maßgeschneidert und unverkennbar Graham sein. Normalisiere sie nicht zu einem AI-Services-, Defense-Tech-, Palantir-artigen, Straive-artigen oder generischen R&D-Tech-Wertversprechen. Behandle Ungewöhnlichkeit als beabsichtigt, es sei denn, aktuelle Beweise zeigen einen faktischen, Zugänglichkeits-, Herkunfts- oder defekten Pfad.

Design-Pflege – maßgeschneiderter visuell-weltlicher Vertrag (#1337)

Design/visuelle-Identitätspflege von grahama.co setzt sich zusammen aus best-practices-bespoke-design und best-practices-font. Die visuelle Welt der Site ist festgelegt in site/design-world.yml (maschinelle Quelle der Wahrheit) + site/DESIGN_WORLD.md (lesbar): eine narrative Prämisse, drei Nicht-Farb-Invarianten, die vollständige Rollengrammatik und die verbotenen strukturellen KI-Vorlagenreste.

Ein visuelles Redesign darf niemals aus Prosa-Vertrauen als bereit gemeldet werden. Für normale lokale Reparaturarbeiten führe die deterministische Render-Spur aus:

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

Es validiert den Quellvertrag, die Quellsperre, deterministisch prüfbare Verbote, den Typbeleg, die responsive Abschnitts-Zuschneidegeometrie und den Handwerks-Render-Beleg. Diese Spur kann PASS zurückgeben, beweist aber explizit nicht formale maßgeschneiderte Design-BEREITSCHAFT, blinde Unterscheidbarkeit, Wettbewerber-Austausch-Resistenz, Barrierefreiheit-Abschluss oder Feldleistung.

Führe die formale Zertifizierungsspur nur aus, wenn die aktuelle Aufgabe ein finales maßgeschneidertes Design-Gate ist:

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

design-certify enthält den G11-Blind-Rater-Beleg und beendet sich mit einem Fehlercode, es sei denn, jedes Gate ist PASS. Fehlende aktuelle Rater-Ausgaben sind NOT_TESTED, kein Site-Render-Fehler. design-world-check bleibt als Kompatibilitätsalias für den formalen Prüfer; bevorzuge die beiden expliziten Befehle oben.

Sprachvertrag (#1298)

grahama.cos menschliche Ich-Perspektive ist festgelegt in site/VOICE.md (Vertrag) + site/voice-anchors.yml (Signaturzeilen). Automatisierte Jobs können validieren, faktenbezogene Metadaten synchronisieren und genehmigte Notizen veröffentlichen, aber dürfen nicht Site-Prosa umschreiben, es sei denn, eine von Menschen verfasste Quelldatei wurde geändert. Nur Bericht, deterministisch:

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

Es kennzeichnet eigene wir/unser/uns, KI-Startup-Superlative, Platzhalter/Lorem und jede Signaturzeile, die aus dem Text verschwunden ist. Beweisetiketten bleiben aus strukturierten Metadaten abgeleitet – Prosa kann sie nicht verstärken.

Verwandte Skills