06/02/2026 · zyss

하네스 엔지니어링이란? 워드프레스와 AI 작업에 맞는 운영 규칙 만들기

하네스 엔지니어링은 AI에게 프롬프트만 잘 쓰는 방법이 아닙니다. AI가 실수하지 않게 작업 환경, 규칙, 검증, 권한, 기록을 함께 설계하는 방식입니다.

쉽게 말하면 프롬프트 엔지니어링은 AI에게 말을 잘 거는 법이고, 하네스 엔지니어링은 AI가 안전하게 일하도록 작업장 전체를 설계하는 법입니다.

1. 하네스 엔지니어링이란?

하네스는 원래 어떤 장비나 대상을 안전하게 묶고 제어하는 장치를 뜻합니다. AI 작업에서 하네스는 AI가 어떤 파일을 읽고, 어디까지 수정하고, 어떤 검사를 통과해야 하는지 정하는 운영 틀입니다.

AI 에이전트가 강해질수록 단순 프롬프트만으로는 부족합니다. 작업 범위, 금지 규칙, 테스트, 로그, 배포 확인까지 함께 묶어야 안정적으로 운영할 수 있습니다.

2. 지금 필요한 이유

여러 워드프레스 플러그인, 자동 기사 발행, 모바일 CSS, MariaDB 저장, 메뉴 동기화, AI CLI 설치 글을 함께 운영하면 작은 실수도 큰 문제로 이어질 수 있습니다.

예를 들어 독립 플러그인을 AI가 서로 묶거나, 워드프레스 메뉴를 하드코딩하거나, MariaDB가 아니라 브라우저 DB에 저장하면 나중에 유지보수가 어려워집니다.

3. 나에게 맞는 하네스 정의

지금 운영 환경에 맞는 하네스는 “AI가 마음대로 만드는 것”을 막고, 워드프레스 운영 규칙 안에서 안전하게 수정, 검증, 발행하게 만드는 작업 체계입니다.

핵심은 독립성, 검증, 메뉴 동기화, MariaDB 저장, 기사 품질 관리입니다.

4. 작업 시작 전 규칙

AI에게 작업을 맡기기 전에 아래 규칙을 먼저 적용하면 실수가 줄어듭니다.

작업 전 확인:
1. 이 작업이 어떤 플러그인/글/페이지에 해당하는지 확인한다.
2. 다른 플러그인과 공유하거나 묶지 않는다.
3. 기존 구조를 먼저 읽고, 누락된 기능만 수정한다.
4. 수정 후 PHP/JS/CSS 문법 검사를 한다.
5. 서버 반영 후 실제 페이지 또는 REST로 확인한다.

5. 플러그인 작업용 하네스

워드프레스 플러그인 작업에서는 독립성이 가장 중요합니다. 기능이 비슷해 보여도 DB, 옵션, 숏코드, CSS, JS를 다른 플러그인과 공유하면 안 됩니다.

플러그인 작업 규칙:
- 각 플러그인은 완전 독립이다.
- DB 테이블, 옵션, 숏코드, CSS, JS를 다른 플러그인과 공유하지 않는다.
- 같은 기능처럼 보여도 복사해서 독립 구현한다.
- 워드프레스 메뉴는 하드코딩하지 않고 WP 메뉴 구조를 따른다.
- 브라우저 localStorage 저장은 금지한다.
- 저장 데이터는 MariaDB에 저장한다.

6. 기사 작성용 하네스

자동 기사 발행에서는 공식 문서 기준, 쉬운 한글, 단계별 설치, 계정/API 조건 설명이 중요합니다.

기사 작성 규칙:
- 공식 문서 기준으로 작성한다.
- 한글로 쉽게 설명한다.
- 초등학생도 큰 흐름을 이해할 수 있게 쓴다.
- 설치글은 설치방법부터 시작한다.
- 계정 로그인 방식을 먼저 안내한다.
- API 키는 언제 필요한지 따로 설명한다.
- 링크는 한곳에 몰지 않고 해당 섹션에 넣는다.
- 명령어와 프롬프트는 복사 가능한 코드블록으로 작성한다.
- 지원 모델은 최신 공식 문서 기준으로 확인한다.
- 무료 모델은 제한, 개인정보, 요금 주의사항을 반드시 적는다.

7. CSS와 모바일 검증 하네스

모바일, 라이트모드, 다크모드 문제는 반복해서 생기기 쉽습니다. 그래서 화면 검증 규칙을 고정해 두는 것이 좋습니다.

화면 검증 규칙:
- PC 다크모드 확인
- PC 라이트모드 확인
- 모바일 다크모드 확인
- 모바일 라이트모드 확인
- 긴 링크 줄바꿈 확인
- 코드블록 가로 넘침 확인
- 버튼 터치 영역 확인
- 좌측 패널 접힘/펼침 확인
- 인쇄 화면이 있으면 인쇄 CSS도 확인

8. 완료 보고 하네스

AI가 “완료했습니다”라고만 말하면 부족합니다. 무엇을 수정했고, 어떤 검사를 통과했는지 보고해야 합니다.

완료 보고 형식:
- 수정한 파일:
- 수정한 기능:
- 삭제한 불필요 기능:
- DB 저장 방식:
- 문법 검사 결과:
- 서버 반영 여부:
- 실제 확인 결과:
- 남은 주의사항:

9. 나에게 맞는 AI 역할 분담

코덱스는 실제 파일 수정, 워드프레스 플러그인 수정, PHP/JS/CSS 검사, 서버 업로드, REST 확인에 적합합니다.

Claude Code는 구조 분석, 설계 검토, 긴 문서 정리, 기능 누락 점검에 적합합니다. 바로 수정하기보다 먼저 문제점과 수정 계획을 정리하게 하는 것이 좋습니다.

Antigravity와 opencode는 보조 검토나 CLI 기반 코드 분석에 활용하기 좋습니다. 최종 수정 권한은 한 도구에만 주는 편이 안전합니다.

10. 바로 쓸 수 있는 하네스 프롬프트

워드프레스 플러그인 작업을 맡길 때는 아래 프롬프트를 사용할 수 있습니다.

이 작업은 하네스 규칙을 적용해서 진행해줘.

1. 먼저 기존 구조를 읽고 현재 상태를 요약해줘.
2. 작업 대상 플러그인/글/페이지를 명확히 구분해줘.
3. 다른 플러그인과 절대 공유하거나 묶지 마.
4. 워드프레스 메뉴는 하드코딩하지 말고 WP 메뉴 구조를 따라줘.
5. DB 저장은 MariaDB 기준으로 확인해줘.
6. 모바일, 라이트모드, 다크모드 CSS까지 확인해줘.
7. 수정 전 계획을 말하고, 수정 후 검사 결과를 보고해줘.
8. 문법 검사와 실제 반영 확인까지 해줘.

설치형 기사 작성에는 아래 프롬프트가 잘 맞습니다.

공식 문서 기준으로 한글 설치 가이드를 작성해줘.

조건:
- 설치방법부터 시작
- 초등학생도 이해할 수 있는 난이도
- 계정 로그인 우선 안내
- API 키는 언제 필요한지 별도 설명
- 무료 사용자의 제한 가능성 안내
- 지원 모델과 주의사항 포함
- 링크는 해당 섹션 안에 배치
- 명령어와 프롬프트는 복사 가능한 코드블록으로 작성
- 출처는 공식 문서 중심

정리

하네스 엔지니어링은 AI를 더 똑똑하게 만드는 기술이라기보다, AI가 실수하지 않게 일하는 환경을 만드는 기술입니다.

지금 운영 환경에서는 “독립 플러그인 유지, MariaDB 저장 확인, 워드프레스 메뉴 동기화, 모바일 CSS 검증, 공식 문서 기반 기사 작성”이 가장 중요한 하네스 기준입니다.