Communitygithub.com

grahama1970/agent-stack-public

README.md와 RESUME.md를 기반으로 grahama.co 공개 사이트와 이력서 표면을 감사, 동기화, 업데이트합니다. 보고 전용 감사는 README의 프로젝트/인벤토리와 사이트/content.json 간의 드리프트와 라이브 사이트 상태를 감지하며, apply는 README에서 content.json을 재생성하고, update는 README/RESUME 변경 사항을 사이트 콘텐츠, 이력서 JSON, 마크다운, PDF, DOCX, llms.txt, ops-linkedin JSON 핸드오프에 연쇄 적용합니다.

agent-stack-public란 무엇인가요?

이 스킬은 grahama.co 공개 사이트와 이력서 표면을 README.md와 RESUME.md를 단일 진실 공급원으로 삼아 감사, 동기화, 업데이트하는 에이전트 도구입니다. 보고 전용 감사 명령어(예: `audit`)는 README의 'Fun Stuff I'm Working On' 프로젝트 카드, 'At a Glance' 인벤토리 표와 사이트의 site/content.json 간의 드리프트를 감지하고, 라이브 사이트 상태(HTTP 상태, data-qid 존재 여부)를 확인합니다. `apply` 명령어는 README에서 site/content.json을 재생성하되 기존 블러브는 보존합니다. `update` 명령어는 README와 RESUME.md의 변경 사항을 사이트 콘텐츠, 이력서 PDF/DOCX/마크다운, llms.txt, ops-linkedin JSON 핸드오프에 연쇄 적용하는 원스톱 협업 경로입니다. 또한 사이트의 독특한 브랜드, 디자인, 음성 계약을 강제하는 `design-contract-check`, `design-render-check`, `design-certify`, `copy-audit` 같은 계약 검사 명령어도 포함되어 있어, 에이전트가 사이트를 일반적인 AI 서비스나 방위 산업 템플릿으로 평준화하지 않도록 방지합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 모든 변형은 명시적인 커밋/푸시 단계를 요구합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 / agentsREADME "At a Glance" 표숫자가 content.json과 다를 때
프로젝트 멤버십README 프로젝트 카드 <strong> 이름 + hrefsslug가 한 쪽에만 있거나 href가 변경되었을 때
라이브 사이트https://grahama.co, /sitemap.xml200이 아니거나 홈페이지에 nav data-qid가 없을 때
이력서 표면RESUME.md vs site/resume.json스탬프된 커밋 != HEAD, 또는 기록된 sourceSha256이 실제 RESUME.md 다이제스트와 다를 때
라이브 이력서/resume, /resume.pdf, /resume.docx, /resume.md200이 아니거나 제공된 파일이 예상 페이지/PDF/DOCX/마크다운이 아닐 때

브랜드/디자인 의도 — 호기심은 카테고리보다 우선

grahama.co 디자인이나 포지셔닝 변경을 제안하거나 적용하기 전에 다음을 읽으십시오:

  • site/BRAND.md
  • site/DESIGN.md
  • skills/monitor-website/local/docs/BRAND.md
  • skills/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, 그리고 사본에서 사라진 서명 라인을 플래그합니다. 증거 레이블은 구조화된 메타데이터에서 파생된 상태로 유지됩니다 — 산문이 이를 강화할 수 없습니다.

관련 스킬