Fix AI Agent Jargon with Simplified Technical English

개요

AI 코딩 에이전트가 사용하는 과장되고 모호한 기술 용어를 간소화하기 위해 1970년대 항공우주 표준인 Simplified Technical English(STE)를 적용하는 방법을 설명합니다.

주요 내용

* AI 모델은 인터넷에 방대한 양의 문학 작품이 학습 데이터에 포함되어 있어 권위적으로 들리기 위해 복잡한 어휘와 은유를 사용하는 경향이 있습니다.
* Simplified Technical English(STE)는 1970년대 항공우주 유지보수 매뉴얼 작성을 위해 개발된 국제 표준으로, 복잡한 절차를 명확하고 모호함 없이 전달하도록 설계되었습니다.
* STE는 문법적 복잡성을 줄이고 어휘를 제한하여 단어당 하나의 의미만 갖도록 합니다.
* AI 에이전트에 STE를 적용하면 은유적 표현을 피하고 직접적이고 문자적인 설명에 집중하도록 강제합니다.
* STE를 적용하기 위해 시스템 구성 파일(.claudemd, developer_instructions.md 등)에 스타일 규칙을 직접 삽입하여 AI 에이전트의 출력을 간결하고 구조화된 산문으로 필터링할 수 있습니다.
* STE 규칙의 예시에는 짧은 능동 문장 사용(20단어 미만), 은유 및 과장된 비속어 사용 금지, 문장당 하나의 동사만 사용, 추상 명사 대신 구체 명사 사용 등이 있습니다.
* STE를 적용해도 AI의 복잡한 기술 문제 해결 능력은 저하되지 않으며, 솔루션의 형식과 설명 방식만 변화시킵니다.
* Claude Code의 경우 .claudemd 파일에, Cursor나 VS Code Copilot의 경우 시스템 프롬프트 또는 .cursorrules 파일에 STE 지침을 추가할 수 있습니다.

시사점

Simplified Technical English(STE)를 AI 에이전트에 적용하면 기술 문서의 명확성과 실행 가능성을 크게 향상시켜, AI가 복잡한 정보를 보다 직접적이고 이해하기 쉬운 방식으로 전달하도록 만들어 개발자의 문제 해결 효율성을 높일 수 있습니다.