어떻게 만들어졌나

이 문서는 파생 산출물입니다. 기억으로 작성한 게 아니라 PulseAd 라이브 소스 저장소에서 생성되며, 각 페이지가 생성된 정확한 커밋에 고정됩니다. 그래서 재동기화가 가능합니다: 코드가 바뀌면 동기화를 다시 돌리고 영향받은 페이지만 바뀝니다. (방법은 문서 갱신하기 참고.)

아이디어

• 소스 저장소가 무엇이 존재하는지의 진실. 엔드포인트, 에이전트, 모델, 테이블, CLI 명령 — 모두 기억이 아니라 코드에서 읽음.
• 이 저장소가 멘탈 모델과 관점의 진실. 조각들이 어떻게 맞물리는지, 무엇을 예측할지, 함정이 어디 있는지 설명.
• 모든 페이지가 출처를 기록. sync/manifest.json이 각 페이지를 도출 소스 경로에 매핑하고 마지막 생성 커밋을 고정. 프레시니스 체크(npm run freshness)는 페이지에 출처가 없거나 링크가 깨지면 빌드를 실패시킴.
• 검증 불가 주장은 게시하지 않음. 코드가 확인할 수 없는 것은 추측하지 않고 _internal/needs-johnny.md로 보냄.

전체 계약은 저장소 루트의 AGENTS.md에 있고, 이 페이지는 사람이 읽는 요약입니다.

무엇으로 만들었나

• Astro Starlight — 문서 사이트 프레임워크.
• 이중 언어 — 영어 /, 한국어 미러 /ko/.
• Cloudflare Pages — 정적 호스팅.
• 인터랙티브 요소(AI 모델 맵)는 Astro 컴포넌트; 제공자 로고는 lobe-icons.

이 문서가 도출된 GitHub 프로젝트

모든 페이지는 하나 이상의 PulseAd/* 저장소에서 도출됩니다. 각자 기여하는 것:

GitHub 프로젝트	브랜치	이 문서에서 기여하는 것
PulseAd/ai-api	develop	백엔드 “두뇌” — 개요, 기능, 레퍼런스, 챗/리포트 에이전트, AI 모델 맵 대부분
PulseAd/pulsy-frontend	develop	Pulson 웹 앱 — 개요, 가이드, 사용자 대면 에이전트(세 패밀리)
PulseAd/pulsead-agents	master	자율 AgentCore 레이어 — 캠페인 에이전트, optimize-cycle, AI 모델 맵의 자율 측면
PulseAd/snowflake-semantic-agent	main	시맨틱 레이어 구축/리프레시 — 데이터 모델
PulseAd/data_semanticview	main	시맨틱 뷰와 도메인별 애널리스트 — 데이터 모델
PulseAd/off-amazon-upload	main	off-Amazon 채널 적재 — 데이터 & 커버리지
PulseAd/aop-hermes	main	오퍼레이터 도구 표면 — aop CLI와 기능의 읽기-vs-쓰기 디테일
PulseAd/banana-bunch	main	대량 이미지 생성 — 크리에이티브
PulseAd/ads-variation	main	배너 변형 — 크리에이티브
PulseAd/video-generator	main	비디오 생성 게이트웨이 — 크리에이티브
PulseAd/portal · portal-api · portal-frontend	main/develop	이전 세대 제품 — 제품 타임라인, 무엇이 deprecated인가

이 매핑의 정규 기계 판독 버전 — 저장소별 정확한 고정 커밋과 각 페이지의 도출 소스 경로 포함 — 은 sync/manifest.json입니다.

최신으로 유지하기

소스 저장소는 계속 움직입니다. 그럴 때 **문서를 갱신**하세요 — 그 페이지가 소스가 바뀐 페이지만 다시 쓰도록 동기화를 재실행하는 법을 안내합니다.