monitor-website
RESUME.md は grahama.co/resume の信頼できる情報源です。gen_resume.py がそれを解析して site/resume.json に出力し、PDF、DOCX、Markdown のエクスポートを site/public/ にコピーします。これにより、ページ、/resume.pdf、/resume.docx、/resume.md は 1 つのコミットのコンテンツになります。以下のダイジェストチェックは、編集されたレジュメが再生成されなかったことを検出します。
公開サイト (site/、https://grahama.co で提供) は、README.md 内の 2 つのキュレーションされた表面をミラーリングしています。「現在取り組んでいる楽しいこと」プロジェクトカードと「一目でわかる」インベントリテーブルです。README が信頼できる情報源であり、サイトは site/content.json を読み取ります。このスキルはそれらの整合性を保ちます。
コマンド
# レポートのみ: README vs content.json のドリフト + ライブサイトの健全性。ドリフトがあれば終了コード 1。
./run.sh audit --json
# レポートのみ: BRAND.md / DESIGN.md があいまいな意図の散文ではなく、具体的なブランド + 実装設計契約であることを確認。
./run.sh design-contract-check --json
# ライブ https://grahama.co のプローブをスキップ (オフライン / DNS 解決前の使用)
./run.sh audit --no-live --json
# README から site/content.json を再生成 (統計は常に; プロジェクトセットはスラッグで追加/削除 — 既存の説明文は保持され、新しいプロジェクトは README カードの説明文を取得)。コミットやプッシュは行いません。
./run.sh apply
# Apply を実行し、サイトがビルドされ qid ゲートを通過することを確認。
./run.sh apply --build
# 生成された表面 (inventory.json、artifacts.json、generated/battle-lineage.json、research-map.json) を現在のリポジトリ状態から再生成し、qid + ビルドでゲート。--commit/--push は明示的。
# battle-lineage.json は記録された battle-004 ライブフィクスチャから派生し、そのフィクスチャがアサートされた形状からドリフトした場合はフェイルクローズします。
# research-map.json はプロジェクトを DECLARED 研究領域タクソノミ (領域は gen_research_map.py で管理され、LLM は推論しない) にグループ化し、領域ごとに一致するスキルをカウントします。ホームページのミニマップは生成され、散文ではありません。
# コピー (質問/説明文/セクション) は refresh によって絶対に変更されません。
./run.sh refresh
./run.sh refresh --commit --push
# Graham + プロジェクトエージェント更新のためのローカルコラボレーションカスケード。これは README.md または RESUME.md を編集した後に実行するコマンドです。
#
# ソース:
# README.md -> site/content.json および生成された公開サイト表面
# RESUME.md -> レジュメ PDF、DOCX、Markdown、site/resume.json、llms.txt
# RESUME.md -> 編集可能な ops-linkedin.profile_entry.v1 JSON
#
# LinkedIn はローカルハンドオフのみ: execution_claim は NOT_EXECUTED のままで、ブラウザや LinkedIn プラットフォームへのアクセスはここでは行われません。
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build
# これを汎用のウェブサイトモニターではなく grahama.co モニターと考える人間向けの安定したエイリアス。
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan
# セクション/ページ状態レビューユニットをフリーズし、ループバック機能 URL を提供。
./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
# レーターシートを消費せずに URL ファーストの G11 レビュアートランスポートを検証。
./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
デフォルトでは無効化された夜間サービスが agents/website-maintainer/services.yaml に登録されています (リポジトリの規約: cron エントリは無効化された状態で出荷; スケジューラ環境の準備ができた場合のみ有効化)。
契約
- デフォルトではレポートのみ。
auditは決して変更しません。applyはsite/content.jsonのみを書き込みます。コミット、プッシュ、Pages デプロイは呼び出し元の明示的なアクションのままです (main へのプッシュは.github/workflows/site-deploy.ymlをトリガーします)。 - 散文は上書きされません。 サイトの説明文は README カードのキャプションより豊かかもしれません。
applyは残っているプロジェクトの既存の説明文を保持し、メンバーシップ (スラッグ/href) と統計のみが同期されます。 - 証明: audit の JSON は各ドリフト項目を報告します。適用された変更が main に反映された後、証拠は緑色の
site-deployの実行と、https://grahama.co で変更された値を curl で読み戻した結果です。 - 相互作用ゲート:
grahama.coまたはgrahama.co/resumeへの UI に表示される変更は、コミット/プッシュの前に、変更された表面でtest-interactionsの検出とリプレイを実行する必要があります。マニフェストはライブ DOM から取得する必要があり、トップナビゲーションの電子メールなどのプロトコル起動コントロールは、ページ内の動作としてテストされるか、外部の待機のみのリンクとして明示的に分類される必要があります。これらの表面の電子メール連絡先コントロールは、デフォルトでクリップボードコピーボタンになります。タスクがネイティブのメールクライアント起動動作を明示的に必要としない限り、rawmailto:リンクは後退です。 - 単一ソースカスケード:
updateはプロジェクトエージェント/Graham のコラボレーションパスです。サイトジェネレーターの前に既存のレジュメエクスポーターを実行し、その後 LinkedIn プロファイル JSON とオプションの自己プロファイル同期計画をops-linkedinに委任します。LinkedIn の変更を適用したり、プラットフォームの検証を主張したりしません。 - レビュー URL:
review-siteは決定論的なcandidate_fingerprintの整合性を、ランタイムのみのaccess_nonceルーティングから分離します。セクションコーパスマニフェストを消費し、正規のレンダリングをレビューバンドルにコピーし、デフォルトでループバックのみを提供し、不透明な URL をプライベート、規制対象、または ITAR マテリアルの認証として扱うことはありません。 - レビューアの領収書:
design-reviewはトランスポート、検査、およびレーターの状態を分離します。事前確認は URL/フィンガープリント/ユニット/正規画像へのアクセスを証明できますが、レーターシートを消費することはありません。レーターは、raw プロバイダー出力が保存され、期待されるフィンガープリント、ユニット ID、およびレビューカナリアをエコーする場合にのみ使用可能です。
audit がチェックするもの
| チェック | ソース | ドリフト条件 |
|---|---|---|
| stats.skills / sanity / agents | README 「一目でわかる」テーブル | 数値が content.json と異なる |
| プロジェクトメンバーシップ | README プロジェクトカードの <strong> 名 + href | スラッグが片方にのみ存在する、または href が変更された |
| ライブサイト | https://grahama.co、/sitemap.xml | 非 200、またはホームページに nav data-qid がない |
| レジュメ表面 | RESUME.md vs site/resume.json | スタンプされたコミットが HEAD と異なる、または記録された sourceSha256 が実際の RESUME.md ダイジェストと異なる |
| ライブレジュメ | /resume、/resume.pdf、/resume.docx、/resume.md | 非 200、または提供されたファイルが期待されるページ/PDF/DOCX/Markdown でない |
ブランド/デザインの意図 — 好奇心はカテゴリに優先する
grahama.co のデザインやポジショニングの変更を提案または適用する前に、以下を読んでください:
site/BRAND.mdsite/DESIGN.mdskills/monitor-website/local/docs/BRAND.mdskills/monitor-website/local/docs/DESIGN.md
次に skills/monitor-website/run.sh design-contract-check --json を実行します。薄いまたは雰囲気だけの DESIGN.md は、許容可能な最初のパスではなく、契約違反です。
サイトは、発見され、楽しく、正直で、特注品であり、間違いなく Graham のものであることを意図しています。AI サービス、防衛テクノロジー、Palantir 風、Straive 風、または一般的な R&D テクノロジーのバリュープロポジションに正常化しないでください。現在の証拠が事実、アクセシビリティ、出典、または壊れたパスの欠陥を示さない限り、異常性を意図的なものとして扱ってください。
デザイン保守 — 特注のビジュアルワールド契約 (#1337)
grahama.co のデザイン/ビジュアルアイデンティティ保守は、best-practices-bespoke-design および best-practices-font と合成されます。サイトのビジュアルワールドは、site/design-world.yml (機械の信頼できる情報源) + site/DESIGN_WORLD.md (人間が読める) に固定されています: ナラティブの前提、3 つの非色不変条件、完全なロール文法、および禁止された構造的 AI テンプレートの残骸。
ビジュアル再デザインは、散文の自信から「準備完了」と報告しては決してなりません。通常のローカル修復作業では、決定論的レンダリングレーンを実行します:
skills/monitor-website/run.sh design-render-check --json
これは、ソース契約、ソースロック、決定論的にチェック可能な禁止事項、タイプ領収書、レスポンシブセクションクロップジオメトリ、およびクラフトレンダリング領収書を検証します。このレーンは PASS を返す可能性がありますが、正式な特注デザイン READY、ブラインドの独自性、競合他社置換耐性、アクセシビリティの完了、またはフィールドパフォーマンスを証明しません。
現在のタスクが最終的な特注デザインゲートである場合にのみ、正式な認証レーンを実行します:
skills/monitor-website/run.sh design-certify --json
design-certify は G11 ブラインドレーター領収書を含み、すべてのゲートが PASS でない限り非ゼロで終了します。現在のレーター出力がない場合は NOT_TESTED であり、サイトレンダリングの失敗ではありません。design-world-check は正式なチェッカーの互換性エイリアスとして残ります。上記の 2 つの明示的なコマンドを優先してください。
ボイス契約 (#1298)
grahama.co の一人称の人間の声は、site/VOICE.md (契約) + site/voice-anchors.yml (署名行) に固定されています。自動ジョブは、事実上のメタデータを検証、同期し、承認されたメモを公開することができますが、人間が作成したソースファイルが変更されない限り、サイトの散文を書き換えてはなりません。レポートのみ、決定論的:
skills/monitor-website/run.sh copy-audit --json
これは、一人称の we/our/us、AI スタートアップの最上級表現、プレースホルダー/ロレム・イプサム、およびコピーから消えた署名行を示します。証拠ラベルは構造化メタデータから派生したままです — 散文はそれらを強化できません。