Communitygithub.com

umairmsm/wp-site

WordPress 사이트 제작을 위한 시작점입니다. 빈 폴더에서 라이브 사이트까지 wp-site-kit 기반의 모든 WordPress 작업을 처리합니다. "WordPress 사이트 구축", "클라이언트 새 사이트", "사이트 진행 상황", "출시 전 다음 단계" 등의 요청이나 사이트 프로젝트를 계속 진행할 때 사용합니다. SITE_STATUS.md에서 현재 단계를 찾고, 핵심 규칙을 적용한 후 적절한 단계 스킬로 넘깁니다.

wp-site란 무엇인가요?

이 스킬은 wp-site-kit 프로젝트를 위한 완전한 WordPress 사이트 개발 워크플로우를 제공합니다. 빈 폴더부터 운영 단계까지 8단계(킥오프, 디자인, 빌드, 콘텐츠, SEO 및 언어, 품질, 출시, 운영)로 구성되며, 각 단계는 통과 게이트(gate)와 증거 문서로 종료됩니다. 프로젝트 루트에서 SITE_STATUS.md 파일을 확인하여 현재 진행 단계를 파악하고, AGENTS.md, SESSION_LOG.md, DECISIONS.md를 참조하여 맥락을 이해합니다. 이 스킬은 플러그인 우선 아키텍처, 실제 사진 사용, 소유자 승인 필수, 보안 및 성능 모범 사례 등 14가지 엄격한 규칙을 모든 단계에서 강제합니다. Claude Code, Cursor, Codex, Antigravity 등 여러 AI 에이전트 플랫폼에서 사용할 수 있으며, 각 단계의 작업을 전담 스킬로 위임합니다. 주요 기능으로는 프로젝트 진행 상태 자동 감지, 단계별 게이트 기반 진행, 소유자 승인 프로세스, 보안 중심 개발, 테스트 무결성 유지 등이 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-site

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

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

문서

WordPress 사이트: 빈 폴더에서 운영까지

이 키트는 방법론과 스타터 프로젝트를 결합한 것입니다. 실제 고객이 결제하는 라이브 다국어 예약 사이트에서 학습되었습니다. 단계를 순서대로 따르세요. 각 단계는 게이트(gate)로 끝납니다. 해당 게이트가 참(true)이고 증거가 문서로 기록된 경우에만 단계를 떠날 수 있습니다.

1. 프로젝트 위치 찾기

  1. 프로젝트 루트에서 SITE_STATUS.md를 찾습니다.
    • 없음: 프로젝트가 시작되지 않았습니다. wp-kickoff를 사용하세요.
    • 있음: 읽습니다. 현재 단계는 체크되지 않은 게이트가 있는 첫 번째 단계입니다.
  2. AGENTS.md(프로젝트 규칙), 그 다음 SESSION_LOG.md와 DECISIONS.md의 최신 줄을 읽습니다.
  3. 소유자에게 두 줄로 알립니다: 현재 단계와 다음 구체적인 단계.

2. 단계

#단계스킬떠나기 위한 게이트 (증거는 SITE_STATUS.md에 기록)
1킥오프wp-kickoff소유자가 승인한 브리프; 결정 사항이 잠겨 기록됨; 비공개 리포지토리; 자격 증명이 이름별로 나열됨
2디자인wp-design정적 프로토타입 승인(스크린샷 + 날짜); 토큰 설정; 폰트 자체 호스팅
3빌드wp-build로컬 사이트 실행; 핵심 플러그인 + 하위 테마 활성화; 실제 아이템이 핵심 함수를 통해 렌더링됨; 문의가 전달되기 전에 저장됨; 구조 테스트 통과
4콘텐츠wp-content모든 공개 페이지에 소유자가 승인한 사본과 실제 사진이 있음; 법적 페이지 존재; 승인되지 않은 AI 텍스트 없음
5SEO 및 언어wp-seo제목, 설명, canonical, schema 및 hreflang 테스트 통과; 이전 URL 리디렉션 맵; 각 추가 언어가 파일럿 통과
6품질wp-quality전체 스위트 통과; 접근성 위반 0건; 스테이징에서 성능 예산 충족
7출시wp-ship스테이징이 라이브 미러링; 강화 적용; launch-auditor PASS; 전환 완료; 7일 모니터링
8운영wp-operate오프라인 사본이 있는 자동 백업; 복원 훈련 1회 완료; 업데이트 및 알림 루틴 작성
  • 단계 작업을 빌더 에이전트(Antigravity, Codex, 다른 Claude)에 전달: wp-task-file.
  • 병합 전 검토: 에이전트 wp-rules-reviewer. 라이브 전환 전: 에이전트 launch-auditor.

3. 핵심 규칙 (모든 단계, 모든 에이전트)

  1. 플러그인 우선. 로직, 데이터, 정책 텍스트, 양식, 스키마 및 SEO는 핵심 must-use 플러그인에 저장됩니다. 테마는 레이아웃입니다. 스킨은 외관입니다. 리디자인 시 기능을 잃어서는 안 됩니다.
  2. 템플릿에 카드, 가격 또는 슬러그를 하드코딩하지 않습니다. 콘텐츠 유형을 쿼리하고 핵심 렌더 함수를 통해 렌더링하여 CMS 편집이 모든 곳에 반영되도록 합니다.
  3. 리드는 먼저 저장됩니다. 양식은 nonce와 함께 admin-post.php로 POST됩니다. 사이트는 리드를 자체 데이터베이스에 저장한 다음 전달합니다. 페이지에 API 키나 타사 엔드포인트가 없습니다.
  4. 가짜 증거 금지. 누구도 증명할 수 없는 평점, 리뷰 수 또는 사용 후기를 표시하지 마십시오. 가져오거나 "레거시" 리뷰 숫자는 증명될 때까지 가짜로 간주합니다.
  5. 실제 사진은 명명된 장소, 방, 제품 또는 사람에 대해 사용합니다. AI 이미지는 일반적인 풍경으로만 사용하며, ai-*로 이름을 지정하고 기록하며, "이것이 당신의 방입니다"라고 제시하지 않습니다.
  6. 사실은 소유자에게서 나옵니다. 가격, 정책, 포함 사항 및 안전 사실은 절대 만들어내지 않습니다. AI 사본은 소유자가 승인할 때까지 초안입니다. 알 수 없음 = PENDING-<누구>.
  7. 운영 환경에 AI로 작성된 PHP를 브랜치, 로컬 테스트, diff 및 사람의 병합 없이 배포하지 않습니다. WordPress 코딩 표준을 따릅니다. 모든 것에 접두사를 붙입니다.
  8. 페이지 빌더 없음. Google Fonts 호출 없음. 폰트를 자체 호스팅합니다: 독일 법원은 Google에서 폰트를 로드하면 방문자의 IP 주소가 유출되므로 손해 배상을 명령했습니다.
  9. 스테이징 및 로컬은 절대 인덱싱되지 않으며 실제 고객에게 이메일을 보내지 않습니다.
  10. 테스트는 통과를 위해 절대 약화되지 않습니다: 삭제, 건너뛰기 또는 재스냅샷 금지. 테스트 이름 변경은 소유자의 승인이 필요합니다.
  11. 배포는 소유자의 몫입니다. 커밋에서 scripts/deploy-safe.sh를 통해: 먼저 드라이 런, 먼저 백업, 사람이 live라는 단어를 입력합니다.
  12. 데이터베이스는 콘텐츠입니다. 검토 가능한 변경 파일과 드라이 런이 있는 보호된 스크립트를 통해서만 변경합니다. 모든 DB 변경 전에 백업합니다.
  13. 비밀은 절대 git, 로그, 프롬프트 또는 페이지에 들어가지 않습니다. CREDENTIALS_INVENTORY.md는 각 비밀의 이름과 위치를 나열하고 값은 절대 나열하지 않습니다.
  14. 하나의 스키마 소유자(일반적으로 SEO 플러그인). 가격 없이 Offer를 출력하지 마십시오.

4. 먼저 소유자에게 질문

  • 플러그인, 테마, 도구 또는 유료 서비스 설치(페이지 빌더: 절대 안 됨).
  • 가격, 통화, 정책, 브랜드 이름 또는 로고 변경. 새 언어 게시.
  • DNS, Cloudflare, 호스팅, 스테이징 또는 라이브에 영향을 미치는 모든 것. 파괴적인 DB 또는 파일 명령.
  • 코드 또는 고객 콘텐츠를 타사 AI API로 전송.

5. 작업 방법

  • 한 번에 한 단계, 한 번에 한 작은 단계. 각 의미 있는 단계 후에 커밋(Conventional Commits).
  • 브랜치, 로컬 테스트, diff, 그런 다음 소유자가 병합. 에이전트는 소유자가 정확한 작업을 요청하지 않는 한 절대 push, merge, deploy 또는 서버에 ssh하지 않습니다.
  • 모든 결정은 DECISIONS.md에 기록(날짜, 누가, 왜). 각 세션은 SESSION_LOG.md 줄로 종료.
  • "완료"는 확인되었음을 의미합니다: 페이지 열기, 테스트 실행, 서버 응답 읽기. 다른 에이전트의 "해결됨"을 직접 확인하지 않고 반복하지 마십시오.

6. 다른 키트의 유용한 스킬 (설치된 경우)

  • agent-skills-kit: wordpress-modern, wp-plugin-development, wp-wpcli-and-ops, wp-performance (WordPress API 세부 정보).
  • agent-loop-kit: supervised-build, agent-supervisor (게이트와 검토자가 있는 무인 빌더 루프).

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-design

Stage 2 of a wp-site-kit WordPress build - design direction, a static HTML/CSS prototype with design tokens, owner sign-off with screenshots, self-hosted fonts, and porting the approved look into a swappable WordPress skin. Use for "design the site", "new look", "redesign", "change colours or fonts", "make a new skin", "port the prototype to WordPress".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-seo

Stage 5 of a wp-site-kit WordPress build - titles and descriptions, canonical URLs, one schema owner and JSON-LD, sitemaps, robots.txt and llms.txt, AI crawler access, redirects (301 vs 302), legacy URL maps, Search Console, and adding languages one pilot at a time with Polylang (hreflang, .po/.mo strings, native review). Use for "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

관련 스킬