Community생산성 & 협업github.com

umairmsm/wp-kickoff

WordPress 사이트 구축 1단계: 새로운 사이트 시작, 인수, 재구축 시 필요한 디스커버리 브리프, 스택 결정, 프로젝트 생성, 자격 증명 목록 작성 등을 처리합니다.

wp-kickoff란 무엇인가요?

이 스킬은 `wp-site-kit` 워크플로우의 첫 번째 단계(Stage 1: Kickoff)를 실행합니다. 새로운 WordPress 웹사이트를 시작하거나, 기존 사이트를 인수/재구축할 때 사용됩니다. 주요 목표는 비즈니스에 대한 '진실의 한 페이지(one page of truth)'를 생성하고, 메서드가 기대하는 모든 파일을 포함한 빈 프로젝트를 생성하는 것입니다. 아직 디자인이나 빌드는 진행되지 않습니다. 이 스킬은 **Claude Code**, **Cursor**, 또는 유사한 AI 에이전트용으로 설계되었습니다. `SKILL.md`에 정의된 8단계 프로세스(기존 사이트 인벤토리 작성, 디스커버리 브리지 질문, 스택 결정, `bin/wp-site-new`로 프로젝트 생성, `AGENTS.md` 작성, 비공개 원격 저장소 설정, 자격 증명 인벤토리 작성, 게이트 완료 표시)를 순서대로 수행합니다. 각 단계는 세부 지침과 피해야 할 함정(pitfalls)을 포함하여 AI 에이전트가 사람의 개입 없이도 체계적으로 진행할 수 있도록 합니다. 이 스킬의 핵심 가치는 작업의 일관성과 재현성입니다. 예를 들어, 기존 사이트를 대체할 때는 모든 URL, 결제 단계, 수익원을 보존해야 하며, 디스커버리 브리프는 추측 없이 출처가 명확한 사실만 기록하도록 강제합니다. 이는 WordPress 개발 워크플로우를 표준화하여 실수를 줄이고, 여러 프로젝트에서 동일한 품질을 유지하는 데 도움을 줍니다. 지원 플랫폼: Claude Code, Cursor, Codex 등 AI 에이전트 기반 개발 환경. GitHub 저장소 `umairmsm/wp-kickoff`에서 제공됩니다.

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

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

1단계: 킥오프

목표: 비즈니스에 대한 진실의 한 페이지와, 메서드가 기대하는 모든 파일이 포함된 빈 프로젝트를 생성합니다. 아무것도 디자인되거나 빌드되지 않습니다.

단계

  1. 이미 운영 중인 사이트가 있습니까? 그렇다면, 방치된 도메인이 아닌 운영 중인 비즈니스로 취급하십시오. 먼저 인벤토리를 작성하십시오 (references/discovery-brief.md, "기존 사이트"):
    • 모든 URL (사이트맵에서), 양식, 결제 단계, 블로그 게시물 및 연락처 세부 정보;
    • 사이트 소유자가 공유할 수 있는 경우 Search Console 데이터;
    • 현재 수익을 창출하는 요소. 재구축 시 이 모든 것이 계속 작동하도록 유지해야 합니다. 예의 바르게 크롤링하십시오: 먼저 이용 약관을 읽고 (robots.txt는 허가가 아닙니다), 요청 사이에 2초 이상의 간격을 두십시오.
  2. 디스커버리 브리프. references/discovery-brief.md의 질문을 하고 답변을 docs/BRIEF.md에 작성하십시오. 각 사실에 출처(소유자, 문서, 크롤링)를 표시하십시오. 사실을 모르면 PENDING-<대상>이라고 작성하십시오. 절대 추측하지 마십시오.
  3. 스택. references/stack.md의 기본값에서 시작하십시오. 명시할 수 있는 이유가 있을 때만 계층을 변경하고, 그 이유를 DECISIONS.md에 기록하십시오.
  4. 프로젝트 생성 이 스킬에서 두 폴더 위에 있는 키트의 스캐폴더를 사용하십시오:
    bash <kit>/bin/wp-site-new --name "Acme Tours" --slug acme-tours --prefix acme \
         --domain example.com --dir ~/sites/acme-tours --git
    
    • slug: 소문자와 하이픈. DDEV 프로젝트, 폴더 및 텍스트 도메인의 이름을 지정합니다.
    • prefix: 2~12자의 소문자 또는 숫자. 모든 함수, 옵션, 포스트 타입, 메타 키, 훅 및 논스는 <prefix>_로 시작합니다.
  5. AGENTS.md 작성:
    • 사이트가 무엇인지;
    • 디자인과 고객 카피를 승인하는 사람;
    • 확정된 결정 사항;
    • 규제된 주장, 표시해야 할 라이선스, 소유자가 원하지 않는 단어 등 이 비즈니스에 특화된 엄격한 규칙.
  6. 비공개 원격 저장소, 1일차에 설정. 소유자가 비공개 리포지토리를 만들고 푸시합니다. 로컬 사이트가 존재하면 (3단계), scripts/backup.sh를 실행하고 다른 컴퓨터에 사본 하나를 보관하십시오.
  7. 자격 증명 인벤토리 (docs/reference/CREDENTIALS_INVENTORY.md):
    • 모든 계정(레지스트라, DNS, 호스트, SMTP, 분석, Search Console, 결제, CDN)을 나열하십시오;
    • 각 비밀번호가 어디에 있는지 기록하십시오;
    • 이름만 작성하고, 값은 절대 적지 마십시오.
  8. SITE_STATUS.md에서 킥오프 게이트를 체크하고 증거(브리프 승인 날짜, 첫 번째 커밋 SHA, 원격 이름)를 첨부하십시오.

게이트

  • docs/BRIEF.md가 소유자에 의해 승인됨 (날짜)
  • 확정된 결정 사항과 비즈니스 엄격 규칙이 AGENTS.md에 있음
  • 프로젝트가 생성되고 커밋됨; 비공개 원격 저장소가 존재함
  • 자격 증명 인벤토리 시작됨 (이름만)
  • 기존 사이트를 대체하는 경우: URL 및 기능 인벤토리가 docs/data/legacy/에 저장됨 (또는 "해당 없음")

우리가 겪은 함정

  • "전환"을 단순한 DNS 변경으로 처리했는데, 그날 오래된 사이트에서 유료 예약이 진행 중이었습니다.
  • 오래된 사이트의 리뷰 수("1,118개 리뷰")가 조작된 것으로 밝혀졌습니다. 이를 이월하지 마십시오.
  • 오래된 호스트가 IP별로 요청을 제한하는데 Cloudflare를 통해 도메인을 프록시했습니다. 호스트는 Cloudflare의 IP만 보았고, 실제 방문자는 429 오류를 받았습니다. 프록시를 켜기 전에 원본의 제한을 확인하십시오.
  • "해결됨"이라고 말한 다른 에이전트의 노트를 신뢰했습니다. 수정 사항은 푸시되지 않았고, 테스트되지 않았으며, 배포되지 않았습니다. 실제 상황을 확인하십시오.
  • 누군가 API 키를 에이전트 채팅에 붙여넣었습니다. 에이전트가 본 키는 모두 교체하십시오.

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-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".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

관련 스킬