본문으로 건너뛰기

편집 원칙: 자동 검사 규칙과 오류 수정

글을 쓰는 기준, 자동 검사로 지키는 편집 규칙, 오류를 고치고 기록하는 방식을 실제 코드 기준으로 정리했어요.

자동으로 지키는 편집 규칙

아래 규칙은 사이트 코드에 함께 들어 있는 자동 검사로 확인해요. 단위 테스트는 내용을 바꿀 때 실행하고, 검색 정보와 라이선스 검사는 사이트를 빌드할 때마다 실행돼요. 규칙을 어긴 글이 있으면 검사가 실패하고, 글을 고쳐야 통과해요. 검사마다 적용되는 페이지 묶음이 달라서, 규칙을 누르면 어디에서 무엇을 확인하는지와 그 이유를 볼 수 있어요.

표현과 말투

  • 궁합과 유형을 단정하지 않아요
    무엇을 확인하나요
    에니어그램·애착유형·사랑의 언어 궁합 페이지, 에니어그램 날개와 홀랜드 코드 페이지, 유형 설명 페이지(MBTI 제외), 친구 궁합 카드, 띠 궁합·별자리·혈액형 페이지에 ‘운명’, ‘무조건’, ‘반드시’, ‘천생연분’, ‘최악’ 같은 말이 들어가면 검사가 실패해요. 이 가운데 궁합·조합·유형 페이지의 자주 묻는 질문에는 결과가 정해진 것이 아니라 사람과 노력에 따라 달라진다는 답이 몇 개 이상 들어 있어야 해요.
    왜 지키나요
    유형이나 궁합은 경향을 보여 줄 뿐, 관계가 어떻게 될지 정하지 못해요. 단정하는 말은 결과를 실제보다 무겁게 만들어요.
  • 사주·운세 글로 겁주지 않아요
    무엇을 확인하나요
    일주·일간·사주 용어, 띠 궁합, 별자리, 2027년 운세 페이지에 ‘흉하다’, ‘액운’, ‘저주’, ‘단명’, ‘큰 병’, ‘부적’ 같은 말이 있으면 검사가 실패해요. 혈액형 페이지에는 건강·질병·체질과 엮는 말도 쓸 수 없어요.
    왜 지키나요
    재미로 보거나 전통으로 읽는 풀이가 불안을 키우거나 건강을 예언하는 말이 되면 안 되기 때문이에요.
  • 성격 설명에 진단명을 붙이지 않아요
    무엇을 확인하나요
    에니어그램·애착유형·사랑의 언어 궁합 페이지, 에니어그램 날개와 홀랜드 코드 페이지, 유형 설명 페이지(MBTI 제외), 에니어그램 결과에 ‘우울증’, ‘공황’, ‘장애’, ‘나르시시스트’, ‘사이코패스’ 같은 진단명이나 임상 용어가 들어가면 검사가 실패해요.
    왜 지키나요
    성격 유형은 진단 도구가 아니어서, 설명이 진단처럼 읽히면 오해를 낳기 때문이에요.
  • 성별로 역할을 나누지 않아요
    무엇을 확인하나요
    에니어그램·애착유형·사랑의 언어 궁합 페이지, 에니어그램 날개와 홀랜드 코드 페이지, 유형 설명 페이지(MBTI 제외), 일주·일간·사주 용어·띠 궁합·별자리·혈액형 페이지에 ‘여자는’, ‘남자는’, ‘남편’, ‘아내’처럼 성별이나 성별 역할을 전제한 말이 있으면 검사가 실패해요. 테토·에겐 유형 페이지는 성별 표현을 고정관념을 짚는 부분에서만 쓰고, 모든 페이지에 이 이름이 성별과 상관없이 누구에게나 쓰일 수 있다는 문장을 넣으며, 궁합은 성별이 아니라 성향으로만 설명해요. 프랑스어 문구 가운데 사랑의 언어·자존감 결과와 MBTI 한 줄 설명은 읽는 사람의 성별을 가정하지 않는지 확인해요.
    왜 지키나요
    성향은 성별과 따로 움직이고, 성별 고정관념은 결과를 읽는 사람을 좁은 틀에 가두기 때문이에요.
  • 자주 묻는 질문에는 첫 문장에서 답해요
    무엇을 확인하나요
    허브 페이지, 띠 궁합 같은 사주 페이지, 혈액형, 에니어그램 궁합, 테토·에겐 유형 페이지 등 일부 묶음에서는 자주 묻는 질문의 답이 첫 문장만 읽어도 답이 되어야 해요. 첫 문장이 ‘위의 표에서 볼 수 있어요’처럼 다른 곳으로 넘기기만 하거나 너무 짧으면 검사가 실패해요.
    왜 지키나요
    검색 결과에는 답 부분만 따로 보일 때가 많아서, 질문 바로 다음 문장이 답이어야 쓸모가 있기 때문이에요.

페이지마다 다른 글

  • 페이지끼리 문장을 돌려 쓰지 않아요
    무엇을 확인하나요
    에니어그램·애착·사랑의 언어 궁합, 에니어그램 날개, 홀랜드 코드, 유형 설명, 일주, 테토·에겐 페이지는 같은 묶음의 다른 페이지와 한국어 기준 22~30자 이상 똑같이 이어지는 구절이 있으면 검사가 실패해요. 유형 번호나 이름만 바꾼 문장도 같은 문장으로 봐요. MBTI 궁합 페이지는 다른 궁합 페이지와 같은 문장을 쓸 수 없어요. ‘케미’, ‘시너지’ 같은 상투어는 몇 페이지에서만 쓸 수 있게 횟수를 제한해요.
    왜 지키나요
    페이지 수만 늘린 복사 글이 아니라, 조합과 유형마다 그에 맞는 설명을 읽을 수 있어야 하기 때문이에요.
  • 가이드는 충분히 깊게, 한 말투로 써요
    무엇을 확인하나요
    가이드 글은 6~8개 섹션에 한국어 2,300자 이상이어야 하고, 검색 결과용 설명은 80~150자로 맞춰요. 한국어 본문에 ‘~습니다’, ‘~입니다’ 말투가 섞이면 검사가 실패해요.
    왜 지키나요
    짧은 요약이 아니라 끝까지 읽을 만한 설명을 드리고, 사이트 전체가 한 목소리로 읽히게 하려는 거예요.

사실과 숫자

  • 안내하는 숫자는 실제 계산과 같아요
    무엇을 확인하나요
    방법론 페이지에 적은 점수 구간·기준점·문항 구성과, 홈과 검사 소개 페이지에 적은 문항 수를 실제 채점 코드와 문항 목록에서 다시 계산해 비교해요. 하나라도 다르면 검사가 실패해요.
    왜 지키나요
    채점을 바꾸고 설명을 그대로 두면, 사이트가 스스로 틀린 정보를 말하게 되기 때문이에요.
  • 글 속 사실은 계산 결과에 묶어 둬요
    무엇을 확인하나요
    가이드에 나오는 사주 예시 명식과 지장간, 삼재 띠 표, MBTI 유형마다 흔히 꼽히는 궁합 같은 내용은 사이트의 계산 코드와 유형 데이터가 내는 값과 비교해요. 에니어그램 궁합 페이지에 적은 스트레스·성장 방향도 유형 데이터와 맞는지 확인해요.
    왜 지키나요
    계산 규칙을 고쳤는데 글이 옛 값을 말하는 일이 없게 하려는 거예요.
  • 도움받을 곳의 번호를 한곳에서 관리해요
    무엇을 확인하나요
    이별·애착 가이드에 적은 위기 상담 번호와, 유형 페이지 안전 안내와 해당 가이드에 적은 폭력 피해 상담 번호는 사이트의 번호 목록과 같아야 해요. 목록의 번호가 바뀌면 그 번호를 적은 글을 고칠 때까지 검사가 실패해요. 번아웃 가이드에는 지역 위기 상담 번호와 ‘자가점검으로는 진단할 수 없다’는 안내가 꼭 들어가요.
    왜 지키나요
    번호가 한 곳에서만 바뀌고 다른 글에 옛 번호가 남으면, 가장 급한 순간에 틀린 정보를 주게 되기 때문이에요.
  • 가이드가 바뀌면 수정일을 새로 적게 해요
    무엇을 확인하나요
    가이드의 제목, 설명, 본문처럼 독자에게 보이는 글이 바뀌면 검사가 실패하고, 그 글의 수정일을 새로 적으라고 안내해요. 링크 대상만 바꾼 것은 내용 변경으로 보지 않아요.
    왜 지키나요
    글에 적힌 날짜를 보고 얼마나 최근 내용인지 판단할 수 있어야 하기 때문이에요.

번역과 이름

  • 네 언어를 빠짐없이 채워요
    무엇을 확인하나요
    화면 문구는 한국어·영어·일본어·프랑스어 파일에 모두 있어야 하고, 일본어·프랑스어 문구가 영어 그대로 남아 있으면 검사가 실패해요. 브랜드명처럼 일부러 같은 말은 예외 목록으로 따로 관리해요. 영어·일본어·프랑스어 글에 한국어가 섞이거나, 프랑스어 화면 문구에서 자주 쓰는 단어의 악상(é, è 등)이 빠져도 실패해요.
    왜 지키나요
    번역이 빠진 자리를 다른 언어로 채워 보여 주면, 그 언어 독자에게는 읽을 수 없는 페이지가 되기 때문이에요.
  • 같은 개념은 같은 이름으로 불러요
    무엇을 확인하나요
    가이드, 유형 페이지, 조합 페이지, 친구 궁합 카드가 애착유형·사랑의 언어·Big Five 요인을 부를 때 화면 메뉴와 같은 이름을 쓰는지 확인해요. 예를 들어 Big Five의 신경성은 한국어로 ‘정서 민감성’이라고 불러요.
    왜 지키나요
    페이지마다 이름이 다르면 같은 결과를 두고 다른 이야기를 하는 것처럼 읽히기 때문이에요.

개인정보와 접근성

  • 우울·불안 점검 결과는 분석 도구에 보내지 않아요
    무엇을 확인하나요
    우울(PHQ-9)·불안(GAD-7) 자가점검은 시작·완료 이벤트를 보내지 않고, 결과 페이지에서는 페이지 조회를 포함해 아무것도 Google Analytics로 보내지 않는지 확인해요. 점검을 시작하는 페이지(문항 포함)는 다른 페이지처럼 페이지 조회가 기록되지만, 주소와 제목에 응답이나 점수는 담기지 않아요. 이 점검 페이지(결과 포함)를 바로 열었을 때 광고를 불러오지 않는지도 확인해요.
    왜 지키나요
    우울·불안 점수는 민감한 건강 정보라서, 방문 통계나 광고와 섞이지 않게 해야 하기 때문이에요.
  • ‘보내지 않아요’는 정말 보내지 않는 것에만 써요
    무엇을 확인하나요
    ‘서버로 보내지 않아요’, ‘어디에도 보내지 않아요’처럼 정보가 밖으로 나가지 않는다고 말하는 문장을 네 언어의 화면 문구에서 모두 찾아, 검토해 둔 문장이거나 순위에 보내지 않는 것(응답과 점수, 우울·불안 같은 마음 상태 점검, 사주, 운세, 관상·손금 사진)에 관한 문장인지 확인해요. 새로 쓰거나 고친 문장이 목록에 없으면 검사가 실패해요.
    왜 지키나요
    익명 유형 순위에 참여하면 결과 유형이 서버로 가기 때문에, 아무것도 보내지 않는다는 말은 정말로 보내지 않는 것에만 써야 하기 때문이에요.
  • 글자와 선택지는 잘 보이는 대비를 지켜요
    무엇을 확인하나요
    자주 쓰는 작은 회색 글씨 색과 결과 정보 칸의 라벨은 배경과 4.5:1 이상, 입력 칸 테두리와 응답 선택 점은 3:1 이상의 명암 대비가 나오는지 색상값으로 계산해요. 입력 칸 테두리는 밝은 화면과 어두운 화면 모두에서 확인해요. 페이지 전체를 훑는 검사가 아니라 이 색들만 확인해요.
    왜 지키나요
    시력이나 화면 밝기와 상관없이 누구나 글을 읽고 답을 고를 수 있어야 하기 때문이에요(웹 접근성 기준 WCAG).

검색 정보와 라이선스

  • 한국어 제목은 45자 이내로 써요
    무엇을 확인하나요
    검색에 노출하는 한국어 페이지의 제목이 ‘ | mind.io’까지 합쳐 45자를 넘으면 검사가 실패해요.
    왜 지키나요
    검색 결과에서 한국어 제목은 40자 안팎에서 잘리기 때문에, 찾는 말을 앞에 두고 짧게 써야 해요.
  • 검색에 내보내는 페이지는 빌드할 때 점검해요
    무엇을 확인하나요
    사이트맵에 오른 모든 페이지가 미리 그려 둔 본문과 제목(H1), 하나의 대표 주소, 언어판끼리의 연결, 페이지 설명, 공유 카드 이미지를 갖췄는지 사이트를 빌드할 때 확인해요. 하나라도 빠지면 빌드가 멈춰요.
    왜 지키나요
    자바스크립트를 실행하지 않는 검색엔진에도 같은 내용이 보이고, 언어판끼리 올바르게 이어져야 하기 때문이에요.
  • 가져다 쓴 코드의 라이선스를 밝혀요
    무엇을 확인하나요
    사이트에 들어간 오픈소스 패키지와 공개된 라이선스 고지 파일(/third-party-notices.txt)이 서로 맞지 않거나, 허용 목록에 없는 라이선스가 섞이면 빌드가 실패해요. 음력 변환에 쓰는 kor-lunar 표의 MIT 고지가 코드와 고지 파일에 똑같이 들어 있는지도 확인해요.
    왜 지키나요
    남이 만든 코드를 쓸 때 지켜야 할 조건을 지키고, 누구나 출처를 확인할 수 있게 하려는 거예요.

오류를 고치는 방식

오류는 위의 자동 검사와 글을 다시 검토하는 과정에서 찾아 고쳐요. 지금은 사이트에 따로 공개한 연락 수단이 없어요. 연락 수단이 생기면 문의 페이지에 적어 둘게요. 오류가 확인되면 이렇게 고쳐요.

  1. 결과 계산에 영향을 준 수정은 방법론 페이지의 ‘결과에 영향을 준 변경 기록’에 달과 함께 남겨요. 예를 들어 2026년 1월 출시 때부터 Big Five 정서 민감성 문항이 반대로 채점되던 오류는 2026년 10월에 바로잡고 그 기록에 적었어요.
  2. 이미 저장된 결과는 다시 계산할 수 있으면 열 때 고친 계산으로 보여 줘요. Big Five 정서 민감성 점수와 사주 명식이 그렇게 바로잡혀요. 다시 계산할 수 없는 경우에는 저장된 결과를 그대로 두고, 예전 결과를 어떻게 읽으면 되는지를 변경 기록에 적어요.
  3. 같은 오류를 다시 잡아낼 검사를 함께 넣어요. Big Five를 고칠 때는 문항마다 채점 방향을 확인하는 검사를, 2026년 10월 접근성 점검 때는 위의 명암 대비 계산을 추가했어요.
  4. 가이드 글이 바뀌면 위 규칙의 검사가 수정일을 새로 적으라고 알려 줘요. 개인정보처리방침을 바꾸면 내용과 시행일을 함께 고쳐요.

기본적인 작성 기준

mind.io의 설명 문구는 “재미있는 한 줄”보다 “이해를 돕는 문장”에 더 가깝게 쓰는 것을 원칙으로 해요. 바로 읽히는 문장, 실제 사용 장면, 분명한 한계 설명이 기본이에요.

특히 자기이해와 심리 관련 페이지에서는 결과를 자극적인 문구로 포장하기보다, 사용자가 스스로 생각을 이어 갈 수 있는 설명을 남기려 해요. 읽고 나서 판단할 여지를 남기는 것이 더 중요하다고 보기 때문이에요.

과장된 표현을 피하는 이유

성격·심리 관련 콘텐츠는 말투 하나만 바뀌어도 사용자가 받는 인상이 크게 달라져요. 그래서 mind.io는 “당신은 원래 이런 사람이다”처럼 사람을 확정하는 표현을 매우 조심해요.

자신감 있어 보이는 문장이 꼭 더 정확한 것은 아니에요. 오히려 확신을 과하게 보이면 독자가 결과를 현실보다 더 무겁게 받아들일 수 있어서, 필요한 곳에서는 분명하게, 그렇지 않은 곳에서는 신중하게 써요.

번역과 현지화에서 보는 기준

언어를 바꿨을 때 문장의 뜻만 옮겨지고 톤은 사라지면, 같은 페이지라도 전혀 다른 서비스처럼 느껴질 수 있어요. 그래서 mind.io는 직역보다 각 언어에서 자연스럽고 읽기 편한 설명이 되도록 다듬는 쪽을 우선해요.

모든 언어를 똑같은 문장 길이와 구조로 맞추는 것이 목표는 아니에요. 같은 기준과 같은 경계를 지키되, 각 언어 사용자가 읽기에 덜 딱딱하고 더 이해하기 쉬운 표현을 고르려고 해요.