코드로서의 SEO, 스프레드시트가 아닌 SEO: Publish-Grade 거버넌스 워크플로

Source: Dev.to

소개

대부분의 팀은 SEO에 관심이 없어서 실패하는 것이 아니라,
표준이 문서에만 존재하고 실행 가능하지 않으며, 감사가 릴리스 후에 이루어지고,
수정이 즉흥적이고 추적하기 어렵기 때문에 문제입니다.

SEO‑Audit‑Remediation (SAR) 은 규칙‑맵 기반, CI‑친화적인 워크플로우로 그 격차를 메웁니다.

SAR 아키텍처

SAR은 다섯 개의 연결된 레이어를 가진 저장소‑우선 거버넌스 스택입니다:

• standards/ – 사람이 읽을 수 있는 정책 및 경계.
• rulemaps/ – 기계가 읽을 수 있는 규칙 계약.
• core/ – 실행 엔진 (discover / generate / audit).
• skills/seo-audit/SKILL.md – 에이전트 워크플로우 계약 (단계별 가드레일 포함).
• skills/seo-audit/scripts/*.cjs – 번들된 런타임 아티팩트.

핵심은 표준, 실행, 그리고 수정 가이드가 하나의 버전 관리 시스템에 존재한다는 점입니다. 규칙은 애플리케이션 흐름에 하드코딩되지 않으며, 다음과 같은 rule‑map 설정 필드에서 실행됩니다:

• category
• severity
• blocking
• runtime.scope
• runtime.evaluator
• runtime.params

런타임 스코프

규칙이 진화하더라도 아키텍처는 안정적으로 유지됩니다.

핵심 차별점: 오케스트레이션된 수정 워크플로우

많은 도구가 SEO 문제를 보고할 수 있지만, 안전하게 수정 워크플로우를 오케스트레이션할 수 있는 도구는 드뭅니다.
skills/seo-audit/SKILL.md 은 실용적인 에이전트 런북을 정의합니다:

1. 단계별 실행 – discover → generate → audit
2. 경로 발견 후 필수 인간 체크포인트
3. 명시적인 명령 계약
4. 수정 후 재감사 루프

즉, SAR은 “AI 자동 수정 마법”이 아니라, 검토 게이트가 포함된 제어된 자동화입니다.

CLI 명령

원샷 감사 (경로 기반)

pnpm seo:audit --routes core/examples/routes.sample.json --origin https://your-site.com

단계별 흐름

# 경로 발견
pnpm seo:discover --project-root /path/to/project --origin https://your-site.com

# 발견된 경로를 기반으로 자산 생성
pnpm seo:generate --routes .outputs//routes.json --origin https://your-site.com

# 생성된 URL 감사
pnpm seo:audit --urls .outputs//urls.txt

실행당 생성되는 아티팩트

• audit-report.json – CI 기록을 위한 기계 가공 가능한 보고서.
• action-plan.md – 우선순위가 매겨진 수정 계획.
• 선택적 AI 수정 제안 (--ai-remediation) – 맹목적인 코드 변형이 아닌 권고 중심.

릴리스 게이트 기준

검증 명령:

pnpm seo:verify

번들된 런타임 아티팩트

SAR은 다음 CommonJS 스크립트를 제공하여, 런타임 node_modules에 의존하지 않고 CI/CD에서 예측 가능한 실행을 가능하게 합니다:

• skills/seo-audit/scripts/discover.cjs
• skills/seo-audit/scripts/generate.cjs
• skills/seo-audit/scripts/audit.cjs

이상적인 사용 사례

SAR은 다음과 같은 팀에 강력히 적합합니다:

• 크로스‑레포 SEO 거버넌스
• 감사 가능한 릴리스 기준
• 결정론적인 CLI + 에이전트 워크플로우

저장소

https://github.com/zandko/seo-foundation