AI 문서를 보잉 매뉴얼처럼 쓰게 하는 ASD-STE100 에이전트 스킬

Who Should Read

LLM이 쓰는 README·런북·에러 메시지가 장황하고 뜬구름 같아 고민인 개발자

Core Mechanics

• 항공 매뉴얼 규칙으로 글을 쓰게 한다
  • ASD-STE100은 1983년부터 항공 업계가 쓰는 통제 언어(Simplified Technical English)다.
  • 피곤한 정비사도 지시문을 오독하지 못하게 만든 규칙이다.
  • 이 스킬은 LLM이 그 규율로 쓰게 한다.
• Claude Code·Codex 등 여러 에이전트에서 쓴다
  • Agent Skills 표준을 읽는 에이전트면 된다. Cursor, VS Code Copilot, Gemini CLI 등도 포함된다.
  • 설치는 npx skills add AminBlg/SimpleEnglish 한 줄이다.
• 스킬 없는 에이전트는 시스템 프롬프트에 붙인다
  • prompts/system-prompt.md의 규칙 블록을 시스템 프롬프트, AGENTS.md, .cursorrules에 붙이면 된다.
  • 토큰이 빠듯하면 60토큰짜리 버전도 있다.
• 규칙은 '측정 가능한 명세'다
  • 지시문은 최대 20단어, 설명은 25단어로 제한한다.
  • 조건을 명령 앞에 둔다.
  • should/would/may/might 같은 모호한 표현을 빼고, 한 단어는 한 의미로만 쓴다.
  • '명확하게 써라'는 의견이고 '20단어 이하'는 명세라고 README는 말한다.

Community Reactions

• 채팅 답변의 눈에 띄는 결함이 줄었다
  • 8개 질문 2회, 총 16개 답변 기준 em-dash·볼드·헤더·불릿 합계가 스킬 없음 218에서 2.0.1 적용 시 11로 줄었다(95%↓).
  • 이 수치는 5문장 상한이 있던 2.0.1 실행분이며 2.1.0 이후 실행은 아직 없다.
  • 블라인드 심사에서 2.0.1이 2.0.0보다 16쌍 중 14쌍에서 선호됐다.
• 문서 린터 위반이 줄었다
  • sqlpipe 문서 작성 8개 과제를 STE 린터로 채점했을 때 100단어당 위반이 스킬 없음 4.09에서 2.0.1 0.91로 줄었다(78%↓).
  • 셀당 1회 실행이고 한 번에 약 0.5가 움직이므로 순위가 아닌 '동등 이상'으로 읽으라고 README가 적는다.
• 측정의 한계를 스스로 밝힌다
  • 심사자가 Claude 모델이라 모델 계열 편향이 있을 수 있다고 한다.
  • 린터 수치는 규칙 준수를 측정할 뿐 독자가 보는 품질은 아니라고 2026-09-02 감사에서 확인됐다.

How to Apply

• 프롬프트 한 줄 먼저 시험하기
  • 지금 쓰는 문서 생성 프롬프트에 'Rewrite this using ASD-STE100 simplified technical English'를 붙이고 결과를 비교하라.
  • 같은 입력을 스킬 적용본과도 비교하라.
• npx로 스킬 설치하기
  • 프로젝트에서 npx skills add AminBlg/SimpleEnglish를 실행하라.
  • 이어서 'rewrite this with simple-english'로 README 한 편을 고쳐 보라.
• 스킬 없는 환경엔 규칙 블록 붙이기
  • Cursor 등에서는 prompts/system-prompt.md의 규칙 블록을 AGENTS.md나 .cursorrules에 붙여라.
  • 토큰이 빠듯하면 60토큰 버전을 써라.
• 문서 규칙을 수치로 지정하기
  • 팀 프롬프트에 '지시문 20단어 이하, 조건을 명령 앞에'처럼 검사 가능한 규칙을 써라.
  • 결과 문서의 문장 길이를 직접 세어 확인하라.

Try It

# Claude나 ChatGPT 대화창에 그대로 붙여넣기 (원문 스킬 규칙의 간이 버전)

다음 글을 아래 규칙으로 다시 써라.
- 지시문은 20단어 이하, 설명은 25단어 이하.
- 조건을 명령 앞에 쓴다.
- 능동태와 단순 시제를 쓴다.
- should, would, may, might를 쓰지 않는다.
- 한 개념에는 한 단어만 쓴다. check, verify, confirm을 섞지 않는다.
- 관사와 that을 생략하지 않는다.
- 'crucial', 'robust' 같은 장식어를 쓰지 않는다. 사실만 쓴다.
- 굵은 글씨 머리말을 쓰지 않는다.

{{다시 쓸 문서}}

이어서 해 볼 것: 같은 문서를 규칙 없이 'ASD-STE100으로 써줘' 한 줄만 주고 결과를 비교해 보라.

Terminology

관련 논문

• AI는 도구다, 잘 쓰려면 기술이 필요하다

  Hickey의 'AI는 도구가 아니다'에 맞서, LLM도 쓰는 사람의 기술이 결과를 가른다고 반박

• 딥리서치 에이전트의 Reflective Prompt Optimization: 토픽 분리·멀티 시드로 본 진짜 성능 향상과 프롬프트 과적합

  GEPA로 프롬프트를 최적화했더니 held-out 인용 보상 0.702→0.781

• GPT-6와 Intelligent UI: 채팅 안에서 시각·인터랙티브 응답 만들기

  OpenAI가 GPT-6로 채팅 응답에 UI를 넣는다는데 원문이 없어 댓글 반응만 확인된다

• Base 모델도 첫 토큰 단서(cue) 하나로 추론한다: 학습 데이터가 만든 연상

  응답 첫 두 토큰만 고정했더니 Olmo-3-7B의 MATH-500 정답률이 42%에서 78%로 올랐다

• Jev식 Typed Decision Model에서는 정의보다 라벨이 이긴다

  옵션 이름을 A, B로 바꿨더니 정확도가 +0.1511 올랐다

• 프롬프트는 얼마나 필요한가? Few-shot 예시를 블랙박스로 최소화하는 DD-FSM

  Delta debugging으로 few-shot 예시를 평균 65.3% 줄여도 출력은 그대로

• 언어모델은 "불안정한(Insecure)" 보고자다: 결함을 숨기는 LLM 리포트

  "Be honest" 한 줄을 붙였더니 GPT-5.5의 부정 결과 공개가 2/200에서 190/200으로 늘었다

Related Resources

• https://github.com/AminBlg/SimpleEnglish
• https://vale.sh
• https://github.com/TAJD/economist-style-guide-plugin
• https://github.com/computerreinvention/trie
• https://www.asd-ste100.org/assets/files/ASD-STE100_ISSUE9.pdf
• https://en.wikipedia.org/wiki/Simplified_Technical_English