Aria Han

진행 중, 감사 및 컴파일러 배포 완료

site-spec

웹사이트의 시각적 완성도와 별개로, 검색 엔진 및 AI 시스템이 요구하는 데이터 레이어의 결함을 진단합니다.

해결한 문제

브라우저는 렌더링된 화면만 보여주지만, 검색 크롤러와 AI 답변 엔진은 robots 정책, 구조화 데이터, 응답 헤더, 접근성 시맨틱, 사이트맵, 서버 렌더링 결과 등 보이지 않는 레이어에 의존합니다.

구축 내용

site-spec은 웹사이트의 보이지 않는 데이터 레이어를 정밀 감사합니다. 라이브 URL이나 로컬 빌드를 크롤링하여 실제 전달되는 페이지 및 HTTP 헤더를 분석하고, AI 검색성, SEO, 구조화 데이터, 접근성, 보안, 성능, 링크 무결성 전반의 구체적 오류를 보고합니다.

결정론적 사이트 컴파일러를 포함하고 있어, 검증된 SiteSpec을 기계 판독 기반이 완비된 HTML로 직접 빌드함으로써 잘못된 마크업이나 환각 정보를 배제합니다.

검증 결과

v0.2.0 배포: 라이브 URL 및 로컬 디렉터리 감사, JSON 출력, CI용 종료 코드, 결정론적 사이트 빌드 지원.

학습한 점

웹사이트의 보이지 않는 영역 역시 화면만큼 엄격한 테스트가 필요합니다. 요구사항을 명시적 스펙으로 관리할 때 안정적인 검증과 컴파일이 가능합니다.

웹 표준 규격을 바탕으로 기존 사이트를 검증하고 신규 사이트를 무결하게 빌드하는 결정론적 도구 개발 역량을 보여줍니다.

기술 스택

TypeScript · Node.js · Vitest

status
진행 중 · v0.2.0
stack
TypeScript · Node.js · Vitest
scope
감사 · 빌드 · 인수인계
license
Apache-2.0

관련 링크

기계 판독 레이어까지 온전히 검증되어야 사이트가 완성된 것입니다.

연계 프로젝트