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.
auditmutiert nie.applyschreibt nursite/content.json; Committen, Pushen und das Pages-Deployment bleiben explizite Aktionen des Aufrufers (Push auf main löst.github/workflows/site-deploy.ymlaus). - Prosa wird nicht überschrieben. Site-Blurbs können umfangreicher sein als README-Karten-Beschriftungen;
applybewahrt 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.coodergrahama.co/resumemuss vor Commit/Pushtest-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; rohemailto:-Links sind ein Rückschritt, es sei denn, eine Aufgabe erfordert explizit natives Mail-Client-Startverhalten. - Eine-Quelle-Kaskade:
updateist 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 anops-linkedin. Es wendet keine LinkedIn-Änderungen an oder beansprucht Plattformverifizierung. - Review-URLs:
review-sitetrennt deterministischecandidate_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-reviewhä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üfung | Quelle | Abweichung wenn |
|---|---|---|
| stats.skills / sanity / agents | README „At a Glance“-Tabelle | Zahlen von content.json abweichen |
| Projektmitgliedschaft | README-Projektkarten-<strong>-Namen + hrefs | Slug nur auf einer Seite vorhanden oder href geändert |
| Live-Site | https://grahama.co, /sitemap.xml | Nicht-200, oder Startseite fehlt ein Nav-data-qid |
| Lebenslauf-Oberfläche | RESUME.md vs. site/resume.json | Gestempelter Commit != HEAD, oder aufgezeichneter sourceSha256 != der tatsächliche RESUME.md-Digest |
| Live-Lebenslauf | /resume, /resume.pdf, /resume.docx, /resume.md | Nicht-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.mdsite/DESIGN.mdskills/monitor-website/local/docs/BRAND.mdskills/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.