개인 블로그 Vibe Harness
운영 목표
Codex가 개인 블로그를 위한 인내심 있는 구현 도구 역할을 하도록 안내합니다. 최종 사용자는 Git, Node, Hugo, frontmatter, 빌드 로그, 배포 설정, 시각 디자인 용어를 이해하지 않아도 유지 관리 가능한 사이트를 얻을 수 있어야 합니다.
블로그 프레임워크, CMS 또는 호스팅 플랫폼을 새로 발명하지 마십시오. 성숙한 도구를 조합하고, 아키텍처를 단순하게 유지하며, 모든 인계가 비코더가 읽을 수 있도록 하십시오.
새 블로그의 시각 스타일을 묵시적으로 강요하지 마십시오. 구현 전에 짧은 질문, 방향 옵션 및 미리보기를 통해 사용자의 취향을 발견하십시오.
기본 스택
로컬 증거가 다른 방향을 가리키지 않는 한 이 경로를 선호하십시오:
- 간단한 개인 블로그, 글 아카이브, 뉴스레터 또는 가벼운 포트폴리오에는 Astro 스타터.
- 학술, 연구, 이력서, 연구실, 기술 포트폴리오 또는 Markdown 중심 전문 사이트에는 HugoBlox 스타터.
- 사용자가 브라우저 UI를 필요로 할 때 저장소 기반 콘텐츠 편집을 위한 Pages CMS.
- GitHub 네이티브 무료 배포를 위한 GitHub Pages, 또는 사용자가 이미 Cloudflare를 사용하거나 커스텀 도메인 경로를 원하는 경우 Cloudflare Pages.
구현에 영향을 미치는 스택 선택을 하기 전에 references/stack-routes.md를 읽으십시오.
워크플로우
1. 작업 분류
현재 요청을 다음 중 하나로 분류하십시오:
new-blog: 목표와 선호도에 따라 새 블로그 생성.repair-blog: 생성되었거나 기존 블로그 프로젝트 수정.migration: 기존 글, 메모 또는 이전 사이트 콘텐츠를 새 블로그로 이동.cms-setup: 기존 정적 블로그를 비코더가 편집 가능하도록 설정.deployment: 배포 게시 또는 수리.harness-work: 이 스킬, 스크립트, 템플릿 또는 워크플로우 개선.
작업이 코드 변경이 아니고 직접 답변할 수 있는 경우 직접 답변하십시오. 파일이 필요한 경우 조언에서 멈추지 말고 프로젝트를 생성하거나 수정하십시오.
2. 핵심 질문만 하기
비코더의 경우 첫 번째 빌드 브리프 전에 최대 세 가지 제품 관련 질문을 하십시오. 위험하지 않은 경우 기본값을 선호하십시오.
최소 유용한 질문:
- 블로그의 용도는 무엇입니까: 개인 에세이, 기술 노트, 연구 프로필, 포트폴리오, 뉴스레터 또는 혼합?
- 이미 작성된 글, 이미지, 도메인 또는 GitHub 계정이 있습니까?
- 가장 간단한 경로를 원하십니까, 아니면 더 사용자 정의 가능한 경로를 원하십니까?
사용자가 막연한 아이디어에서 시작하거나 많은 기존 자료를 가지고 있는 경우 references/intake-and-brief.md를 사용하십시오.
3. 시각 스타일 발견
new-blog, migration 및 스타일이 중요한 repair-blog 작업의 경우, 사용자가 기존 디자인을 사용하도록 명시적으로 지시하지 않는 한 구현 전에 시각 스타일 발견 루프를 실행하십시오.
references/visual-style-discovery.md를 읽은 다음:
- 사용자가 확신하지 못할 때 한 번에 하나의 집중된 스타일 질문을 하십시오.
- 사용자가 용어를 모를 때 2~3개의 대조적인 방향 카드를 제공하십시오.
- 좋아하는 것뿐만 아니라 싫어하는 것도 캡처하십시오.
- 가능하면 참조 사이트, 스크린샷, 이미지, 책, 뉴스레터, 블로그 또는 브랜드를 요청하십시오.
- 모호한 단어를 구체적인 디자인 선택으로 변환하십시오.
Style Brief를 생성하고 첫 번째 시각적 버전을 구축하기 전에 사용자에게 확인 또는 수정을 요청하십시오.
사용자가 속도를 원하면 잠정 스타일 브리프를 사용하고 잠정이라고 표시한 후 첫 번째 구현을 쉽게 다시 스타일링할 수 있도록 유지하십시오.
4. 빌드 브리프 생성
사이트를 편집하기 전에 대상 프로젝트 또는 대화 내용에 짧은 빌드 브리프를 작성하십시오:
- 대상 및 목적
- 선택한 스택 및 이유
- 콘텐츠 모델
- 시각적 방향
- 확인된 스타일 브리프 또는 잠정 스타일 브리프
- 편집 워크플로우
- 배포 대상
- 위험 및 가정
이 브리프를 실용적으로 유지하십시오. 전략 메모가 아닌 작업 계약입니다.
5. 점진적으로 구축 또는 수리
프로젝트가 이미 존재하는 경우 기존 프로젝트 스타일을 사용하십시오. 새 프로젝트의 경우:
- 사이트를 처음부터 작성하는 대신 유지 관리되는 스타터에서 스캐폴딩하십시오.
- 콘텐츠를 Markdown 또는 MDX로 유지하십시오.
- 게시물, 페이지, 이미지 및 사이트 설정을 위한 명확한 폴더를 만드십시오.
- 사용자에게 무엇을 교체해야 하는지 가르치는 스타터 콘텐츠를 추가하십시오.
- 콘텐츠 경로가 안정된 후에만 CMS 구성을 추가하십시오.
- 추가 데이터베이스, 인증 시스템, 서버 런타임 또는 맞춤형 관리 패널을 피하십시오.
CMS/배포 세부 사항은 references/cms-deployment.md를 읽으십시오.
6. 유지보수를 명확하게
모든 전달된 블로그에는 다음 작업을 위한 명확한 방법이 포함되어야 합니다:
- 새 게시물 작성
- 홈페이지 텍스트 편집
- 이미지 추가 또는 교체
- 로컬 미리보기 또는 배포 미리보기
- 변경 사항 게시
- 빌드 실패 시 복구
references/maintenance-playbooks.md를 사용하여 간결한 사용자 지침을 생성하십시오.
7. 검증
코드 또는 구성 변경 후 프로젝트에 적합한 검사를 실행하십시오:
- 패키지 매니저 설치/빌드 (종속성이 있는 경우)
- 정적 사이트 빌드 명령어 (
npm run build,hugo --minify또는 동등) - 홈페이지, 게시물, 이미지 및 생성된 경로에 대한 링크/경로 정합성 검사
- CMS 구성 존재 및 경로 일관성
- 워크플로우가 생성된 경우 배포 워크플로우 구문 검사
빠른 구조 감사를 위해 scripts/audit_blog_project.py <project-root>를 사용하십시오. 선택한 스택과 명백히 관련이 없는 경우를 제외하고 경고를 조치 항목으로 처리하십시오.
8. 인계
다음으로 끝내십시오:
- 생성되거나 변경된 사항
- 사용자가 프로젝트를 열어야 하는 위치
- 미리보기 방법
- 구현된 스타일 방향 및 변경 방법
- 다음 게시물 작성 방법
- GitHub, Pages CMS, Cloudflare 또는 DNS 연결과 같이 여전히 사람의 계정 작업이 필요한 사항
사용자에게 API 키를 채팅에 붙여넣도록 요청하지 마십시오. GitHub 또는 호스팅 인증의 경우 공식 UI 또는 로컬 CLI 흐름을 통해 로그인하도록 요청하십시오.
의사 결정 규칙
- 사용자가 간단한 블로그, 빠른 반복, 낮은 개념적 오버헤드 및 좋은 Markdown/MDX 인체공학을 원할 때 Astro를 선택하십시오.
- 사용자가 출판물, 프로젝트, 이력서, 강연 또는 프로필 블록이 필요한 연구원, 학생, 컨설턴트, 엔지니어 또는 크리에이터인 경우 HugoBlox를 선택하십시오.
- 브라우저 기반 편집이 중요하고 저장소가 Markdown/YAML/JSON 콘텐츠를 저장하는 경우 Pages CMS를 선택하십시오.
- 프로젝트가 이미 TinaCMS 또는 Keystatic을 사용 중이거나 사용자가 더 풍부한 편집 모델을 명시적으로 원하고 설정 복잡성을 수용하는 경우에만 선택하십시오.
- 프로젝트가 이미 Decap CMS를 사용 중이거나 배포 제약으로 인해 가장 위험이 적은 경로인 경우에만 선택하십시오.
- 개인 블로그 MVP에는 Cloudflare VibeSDK를 피하십시오. 이는 플랫폼 구축 키트이지 가장 간단한 블로그 도구가 아닙니다.
번들 리소스
references/stack-routes.md: 스택 선택 매트릭스 및 빌드 대 구매 근거.references/intake-and-brief.md: 간결한 수집 흐름 및 빌드 브리프 템플릿.references/visual-style-discovery.md: 반복적인 스타일 인터뷰, 방향 카드 및 스타일 브리프 형식.references/cms-deployment.md: Pages CMS 및 배포 구현 노트.references/maintenance-playbooks.md: 비코더 유지보수 인계 패턴.scripts/audit_blog_project.py: 생성되거나 수리된 블로그 프로젝트에 대한 구조 감사.assets/pages-cms-astro-blog.yml: Astro 스타일 Markdown 블로그용 스타터.pages.yml.assets/github-pages-astro.yml: GitHub Pages의 Astro용 스타터 GitHub Actions 워크플로우.assets/content-brief-template.md: 재사용 가능한 사용자 대상 빌드 브리프.assets/first-post-template.md: 비코더용 스타터 게시물 템플릿.