monitor-website
RESUME.md는 grahama.co/resume의 진실 공급원입니다: gen_resume.py가 이를 파싱하여 site/resume.json으로 만들고 PDF, DOCX, 마크다운 내보내기 파일을 site/public/에 복사하여 페이지, /resume.pdf, /resume.docx, /resume.md가 하나의 커밋 콘텐츠가 되도록 합니다. 아래의 다이제스트 검사는 편집되었지만 표면이 재생성되지 않은 이력서를 잡아냅니다.
공개 사이트(site/, https://grahama.co 에서 제공)는 README.md의 두 가지 큐레이션 표면을 반영합니다: 'Fun Stuff I'm Working On' 프로젝트 카드와 'At a Glance' 인벤토리 표입니다. README가 진실 공급원이고 사이트는 site/content.json을 읽습니다. 이 스킬은 이 둘을 정직하게 유지합니다.
명령어
# 보고 전용: README vs content.json 드리프트 + 라이브 사이트 상태. 드리프트가 있으면 Exit 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 재생성 (통계는 항상 업데이트; 프로젝트 세트는 slug로 추가/제거 —
# 기존 블러브는 유지되고 새 프로젝트는 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, 마크다운, 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에 등록되어 있습니다(저장소 규칙: 크론 항목은 비활성화된 상태로 제공되며, 스케줄러 환경이 준비되었을 때만 활성화).
계약
- 기본적으로 보고 전용.
audit은 절대 변이하지 않습니다.apply는 오직site/content.json만 씁니다; 커밋, 푸시 및 Pages 배포는 호출자의 명시적 작업으로 남습니다(main에 푸시하면.github/workflows/site-deploy.yml이 트리거됨). - 산문은 덮어쓰지 않음. 사이트 블러브는 README 카드 캡션보다 풍부할 수 있습니다;
apply는 유지되는 프로젝트의 기존 블러브를 보존하고, 멤버십(slug/href)과 통계만 동기화됩니다. - 증명: 감사 JSON은 각 드리프트 항목을 보고합니다; 적용된 변경 사항이 main에 반영된 후에는 녹색
site-deploy실행과 https://grahama.co 에서 변경된 값을 curl로 읽어오는 것으로 확인됩니다. - 상호작용 게이트:
grahama.co또는grahama.co/resume에 대한 UI 표시 변경은 커밋/푸시 전에 변경된 표면에서test-interactions탐색 및 재생을 실행해야 합니다. 매니페스트는 라이브 DOM에서 가져와야 하며, 상단 탐색 이메일과 같은 프로토콜 실행 컨트롤은 페이지 내 동작으로 테스트하거나 명시적으로 외부 대기 전용 링크로 분류해야 합니다. 이러한 표면의 이메일 연락처 컨트롤은 기본적으로 클립보드 복사 버튼입니다; 작업이 명시적으로 기본 메일 클라이언트 실행 동작을 요구하지 않는 한 원시mailto:링크는 회귀입니다. - 단일 소스 연쇄:
update는 프로젝트 에이전트/Graham 협업 경로입니다. 사이트 생성기 전에 기존 이력서 내보내기 도구를 실행한 다음 LinkedIn 프로필 JSON 및 선택적 자체 프로필 동기화 계획을ops-linkedin에 위임합니다. LinkedIn 변경 사항을 적용하거나 플랫폼 확인을 주장하지 않습니다. - 검토 URL:
review-site는 결정론적candidate_fingerprint무결성과 런타임 전용access_nonce라우팅을 분리합니다. 섹션 코퍼스 매니페스트를 소비하고, 표준 렌더링을 검토 번들로 복사하며, 기본적으로 루프백 전용으로 제공하고, 불투명 URL을 개인 정보, 규제 정보 또는 ITAR 자료에 대한 인증으로 취급하지 않습니다. - 검토자 영수증:
design-review는 전송, 검사 및 평가자 상태를 분리합니다. 사전 점검은 URL/지문/단위/표준 이미지 접근을 증명할 수 있지만 평가자 자리를 소모하지 않습니다. 평가자는 원시 공급자 출력이 보존되고 예상 지문, 단위 ID 및 검토 카나리아를 반영할 때만 사용 가능합니다.
감사 확인 항목
| 검사 항목 | 소스 | 드리프트 발생 조건 |
|---|---|---|
| stats.skills / sanity / agents | README "At a Glance" 표 | 숫자가 content.json과 다를 때 |
| 프로젝트 멤버십 | README 프로젝트 카드 <strong> 이름 + hrefs | slug가 한 쪽에만 있거나 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/마크다운이 아닐 때 |
브랜드/디자인 의도 — 호기심은 카테고리보다 우선
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(읽기 가능)에 잠겨 있습니다: 내러티브 전제, 세 가지 비색상 불변 조건, 전체 역할 문법, 금지된 구조적 AI 템플릿 잔여물.
시각적 재디자인은 절대 산문 확신만으로 준비되었다고 보고되어서는 안 됩니다. 일반적인 로컬 수리 작업의 경우 결정론적 렌더링 레인을 실행하십시오:
skills/monitor-website/run.sh design-render-check --json
이 명령어는 소스 계약, 소스 잠금, 결정론적으로 확인 가능한 금지 사항, 유형 영수증, 반응형 섹션-크롭 지오메트리, 공예-렌더 영수증을 검증합니다. 이 레인은 PASS를 반환할 수 있지만, 공식 맞춤형 디자인 READY, 블라인드 차별성, 경쟁사 대체 저항, 접근성 완료, 또는 현장 성능을 증명하지 않습니다.
현재 작업이 최종 맞춤형 디자인 게이트인 경우에만 공식 인증 레인을 실행하십시오:
skills/monitor-website/run.sh design-certify --json
design-certify는 G11 블라인드 평가자 영수증을 포함하며 모든 게이트가 PASS가 아닌 경우 0이 아닌 종료 코드로 종료됩니다. 현재 평가자 출력이 없으면 NOT_TESTED이며 사이트 렌더링 실패가 아닙니다. design-world-check는 공식 검사기의 호환성 별칭으로 유지됩니다; 위의 두 가지 명시적 명령어를 선호하십시오.
음성 계약 (#1298)
grahama.co의 1인칭 인간 음성은 site/VOICE.md(계약) + site/voice-anchors.yml(서명 라인)에 잠겨 있습니다. 자동화된 작업은 사실적 메타데이터를 검증, 동기화 및 승인된 노트를 게시할 수 있지만, 사람이 작성한 소스 파일이 변경되지 않는 한 사이트 산문을 재작성할 수 없습니다. 보고 전용, 결정론적:
skills/monitor-website/run.sh copy-audit --json
이 명령어는 1인칭 we/our/us, AI 스타트업 최상급 표현, 플레이스홀더/lorem, 그리고 사본에서 사라진 서명 라인을 플래그합니다. 증거 레이블은 구조화된 메타데이터에서 파생된 상태로 유지됩니다 — 산문이 이를 강화할 수 없습니다.