AI 코딩 도우미에게 NME 알려 주기

AI 코딩 도우미에게 다음 문장 하나를 전달하세요.

NME 코드를 작성하기 전에 이 문서를 읽고 따르세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

먼저 `nme --version`으로 지원되는 베타(현재 `0.0.1-beta.160`)를 확인하세요. 그다음 요청한 프로그램을 .nme 파일로 작성하세요. 초보자에게는 문장형을 우선하고,
더 분명할 때만 초급 문법이나 고급 Python을 섞으며, nme 검사로 확인하세요.

사용자의 프로젝트에 도우미 전용 파일을 만들 필요가 없습니다.

#목적에 맞는 시작 문장 고르기

맨 위의 문장 하나는 새 프로그램을 작성하는 용도입니다. 다른 목적은 아래에서 맞는 짧은 시작 문장을 같은 링크와 함께 붙이세요. 각 시작 문장은 그 자체로 완결되며 항상 AI를 이 문서로 안내합니다.

#NME 코드 작성

원하는 프로그램이 이미 있고 계속 다듬을 .nme 파일이 필요할 때 사용하세요.

이 NME 문서를 읽고 따르세요. 제가 요청하는 프로그램을 .nme 파일로 작성하고 nme 검사로 확인해 주세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

Read and follow this NME handoff, then write the program I ask for as a .nme file and verify it with nme check:
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.md

#NME 배우기

문장형부터 시작해서 NME를 단계별로 배울 때 사용하세요.

이 NME 문서를 읽고, 문장형부터 시작해서 NME를 단계별로 가르쳐 주세요. 키워드 질문에는 문법 레퍼런스를 사용하세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

Read this NME handoff, then teach me NME step by step starting with sentence syntax, and use the language reference for keyword questions:
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.md

#NME 선생님 역할

내 코드를 줄마다 설명받고 작은 다음 단계 하나를 얻고 싶을 때 사용하세요.

당신은 나의 NME 선생님입니다. 이 문서와 문법 레퍼런스를 읽고, 제 코드를 줄마다 설명하고 작은 다음 단계 하나를 제안해 주세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

You are my NME teacher. Read this handoff and the language reference, then explain my code line by line and suggest one small next step:
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.md

#기존 코드 설명/변환

Python이나 NME 코드를 붙여 넣고 설명이나 뜻이 같은 변환을 받고 싶을 때 사용하세요.

이 NME 문서를 읽고, 제가 붙여 넣는 코드를 줄마다 설명하거나, 제가 요청하면 뜻이 같게 더 쉬운 NME로 변환해 주세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

Read this NME handoff, then explain the code I paste line by line, or convert it to easier NME with the same meaning when I ask:
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.md

#프로젝트 디버깅

프로그램이 실패하거나 이상하게 동작할 때 사용하세요.

이 NME 문서를 읽고, 제 .nme 프로그램의 버그를 찾아 주세요: 원인을 설명하고 가장 작은 수정을 제안하며 nme 검사로 확인하라고 알려 주세요.
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.ko.md

Read this NME handoff, then find the bug in my .nme program: explain the cause, suggest the smallest fix, and ask me to run nme check to verify:
https://raw.githubusercontent.com/needmoretruth/needmoreeasy/beta/docs/ai-assistants.md

#이 페이지를 읽는 도우미가 따라야 할 규칙

NME에는 줄마다 섞을 수 있는 세 단계가 있습니다.

1. 문장형: 코드용 특수문자가 거의 없으며 처음 배우는 사람에게 기본으로 사용
2. 초급: 짧고 정확하며 임의의 Python 표현식이 필요할 때 사용
3. 고급: 올바른 Python과 완전히 같고 변경되지 않음

한국어와 영어는 별도 모드가 아니라 뜻이 같은 표현입니다.

이름을 물어봐 이름이 뭐예요?
show Hello 이름!
3 times 반복해서 Welcome 말해줘
이름이 뭐예요?
안녕하세요 이름!

#먼저 문장형으로 작성

안녕하세요 말해줘
Hello world show
오늘도 반가워요!
Hello everyone!

이름을 물어봐
name ask
Hello name show

이름이 뭐예요?
What is your name?
안녕하세요 이름!

3번 다시 만나요
3 times See you again

만약에 점수가 10보다 크면 성공 말해줘
if score is greater than 10 then show You won
점수가 5보다 크면 높아요 말해줘
색이 빨강과 같으면 맞아요 말해줘

정답은 1부터 10까지 랜덤정수
추측을 숫자로 물어봐 숫자를 맞혀 보세요

가장 쉬운 출력은 오늘도 반가워요!처럼 분명한 여러 단어 문장을 동작 단어 없이 쓰는 것입니다. 한 단어만 있는 줄은 Python 이름일 수 있어 말해줘나 보여줘를 붙여야 출력됩니다. repaet, shwoe 같은 오타는 뜻이 하나로 정해질 때만 자동으로 고칩니다. 그리거, 같먄 같은 논리·조건 연결어 오타도 같은 제한으로 복구합니다.

문장 출력에서 앞서 입력받거나 저장한 이름은 실제 값으로 바뀝니다. 내 이름은 뭐예요?처럼 평범한 질문을 쓰면 이름에 답이 자동으로 저장됩니다. 마지막 ?는 생략할 수 있고, 따옴표 없는 질문에는 끝 공백이 자동으로 붙습니다. How old are you?, 몇 살이에요? 같은 나이 질문은 각각 age, 나이에 자동으로 저장됩니다.

가장 쉬운 시작을 위해, 처음에는 들여쓰기 대신 끝/end로 블록을 닫으세요.

동안 점수 < 3
점수 말해줘
점수에 1 더해
끝

같은 블록에서 멈춰/break, 그리고/and, 또는/or, 아니면 만약에/elif, 아니면/else를 사용할 수 있습니다. 네 칸 들여쓰기와 일반 Python도 계속 유효합니다. NME 조건 전체는 만약 (준비 그리고 점수 > 2)처럼 콜론 없는 만약이나 동안 헤더에서 괄호로 감쌀 수 있으며, when(ready and score > 2) 같은 올바른 Python 호출은 계속 Python으로 남습니다. 한국어 비교 끝말도 괄호 안에 둘 수 있고 연결어보다 앞에 놓을 수 있습니다. 예를 들어 만약 (점수가 2보다 크면 그리고 준비)처럼 씁니다. 같은 규칙이 한국어 while 끝말에도 적용되므로 동안 (횟수가 2보다 작을 동안 그리고 준비)처럼 쓸 수 있습니다. 같은 괄호 안에서 연결어 표기를 섞을 수도 있어 만약 (점수가 2보다 크면 and 준비)처럼 적을 수 있습니다. 한국어 NME 동작어도 올바른 Python 식별자일 수 있습니다. 만약이 바인딩되어 있다면 만약 (준비)는 Python 호출 형태이므로 바이트 단위로 그대로 두어야 합니다. NME 블록을 뜻한다면 만약 준비라면처럼 문장형 끝말을 쓰거나 만약 ((준비 그리고 참))처럼 NME 연결어를 넣으세요.

#정확해야 하면 초급 문법 사용

말해 <Python 표현식>
say <Python expression>
물어봐 이름, <Python 질문>
ask name, <Python prompt>
횟수번:
count times:
3번:
첫 줄 말해줘
끝
만약 <Python 조건>:
when <Python condition>:
동안 <조건> ... 끝
while <condition> ... end
멈춰 / break
아니면 만약에 <조건> / else if <condition>
아니면 / else
랜덤 사용 최신
use random

횟수번:은 횟수라는 변수에 적힌 숫자만큼 반복해요 (변수에 숫자가 있어야 해요). count times:는 변수 count로 같은 뜻이에요.

사용자가 제한된 네이티브 백엔드를 요청하면 불리언 이름은 정수와 구별되는 타입으로 지원됩니다. True/False를 대입하고 참·거짓 if/while 조건에 이름을 쓰고 지원되는 조건은 단락 평가 and/or로 묶으며 show는 True 또는 False를 출력하세요. 네이티브 코드에서는 불리언 산술이나 더해/빼 값 변경을 쓰지 말고, 사용자가 네이티브 코어 진단을 원하지 않는 한 CPython으로 안내하세요. 네이티브 if/while/분기 본문에서는 then/그러면 뒤에 한 줄 NME say/show/말해 또는 break를 쓸 수 있고, 문장형 반복에서는 한 줄 여기서 멈춰 본문도 쓸 수 있습니다. Python 인라인 본문과 인라인 값 변경은 네이티브 부분집합 밖입니다. 전체 경계는 네이티브 코어 레퍼런스에 있습니다.

#모든 Python을 고급 NME로 사용

쉬운 표현이 뜻을 바꿀 수 있다면 Python 문법을 억지로 번역하지 마세요. 함수, 클래스, import, 컴프리헨션, 비동기 코드, 예외 처리, 설치한 Python 패키지와 모든 올바른 Python 기능은 그대로 둘 수 있습니다.

Python의 문맥 규칙도 그대로 적용됩니다. return과 yield는 함수 안에, await는 async def 안에, break·continue는 반복문 안에 있어야 합니다. 잘못된 최상위·인라인·한 줄 함수/클래스 형태를 nme 검사하면 안정적인 이중 언어 코드 E0102, E0106–E0110이 표시되며 한 줄 함수나 클래스는 바깥 반복문을 물려받지 않습니다. 한 줄 본문 앞에 세미콜론으로 구분한 문장이 있어도 같은 제어 흐름 검사가 적용됩니다. async def에서는 yield from 대신 async for를 사용하세요. async for와 async with도 async def 안에 있어야 하며, 잘못된 위치에는 E0111과 E0112가 표시됩니다. nonlocal은 바깥 함수가 있어야 합니다. 최상위, 최상위 클래스, 중첩되지 않은 함수, 한 줄 본문에서 잘못 쓰면 E0113이 표시됩니다. 바깥 함수 아래의 중첩 함수와 클래스는 그대로 사용할 수 있고, 이름이 실제로 바깥 함수에 있는지는 CPython이 검사합니다. Python 별표 import(from ... import *)는 모듈 수준에서만 쓸 수 있습니다. 한 줄 본문이나 앞선 세미콜론 구분 문장 뒤에 함수·클래스 안에서 사용하면 E0114가 표시되므로 이름을 명시적으로 import하세요. Python은 except* 안의 break, continue, return도 거부하며 NME는 핸들러 안에서 앞선 세미콜론 구분 문장 뒤에 나오는 경우에도 E0115를 표시합니다. 제어 흐름을 핸들러 밖으로 옮기거나 의미가 맞을 때 일반 except 블록을 사용하세요. Python은 리스트·집합·딕셔너리·제너레이터 컴프리헨션 안의 yield를 거부하며 NME는 E0116을 표시합니다. 컴프리헨션을 명시적인 반복문으로 바꾸고, 올바른 제너레이터 람다는 그대로 두세요. async def 밖의 컴프리헨션 안에 있는 async for도 Python이 거부하며 NME는 E0117을 표시합니다. 그 컴프리헨션을 비동기 함수 안으로 옮기고, 올바른 비동기 컴프리헨션은 보존하세요. 비동기 제너레이터에서는 값을 반환할 수 없으며 첫 yield보다 앞의 반환도 NME가 E0118로 표시합니다. 한 줄로 쓴 Python 본문도 함수 본문으로 추적하므로 올바른 인라인 yield, await, 값 없는 return은 그대로 남습니다. 값 없는 return을 사용하고, 중첩 함수의 반환은 그대로 두세요. global과 nonlocal은 같은 범위의 사용이나 대입보다 먼저 적어야 하고 매개변수나 annotation 대상을 이름으로 사용할 수 없습니다. 한 줄 본문을 포함한 이런 충돌은 NME가 E0119/E0120으로 표시하므로 선언을 앞에 적으세요. annotation 식의 이름도 사용으로 계산하며, f-string 검증은 CPython에 맡기고 컴프리헨션의 지역 이름은 구분합니다. lambda: (yield 값) 같은 제너레이터 람다는 올바른 고급 Python이므로 그대로 보존해야 합니다.

올바른 Python이 항상 우선합니다. say("x"), when이라는 변수, 문자열 안의 글, 주석을 NME 문법으로 바꾸면 안 됩니다.

#랜덤 모듈

내장 랜덤 어댑터 버전은 0.0.1입니다. 랜덤 사용 최신과 use random latest가 로컬에서 이 버전을 고릅니다. 어느 쪽으로 불러도 다음 두 언어 이름이 모두 생깁니다.

• 랜덤정수 / random_number
• 랜덤선택 / random_pick
• 섞기 / shuffle
• 랜덤버전 / random_version

문장형 랜덤에는 import가 필요 없습니다.

주사위는 1부터 6까지 랜덤정수
색은 빨강 또는 초록 또는 파랑 중에서 랜덤선택

#만들어 내지 말고 검사

파일을 작성하거나 고친 뒤 실행하세요.

nme 버전
nme 검사 program
nme 빌드 program -o program.py

검사와 빌드는 생성된 Python을 선택한 CPython으로 컴파일해 확인하지만 실행하지는 않습니다. nme 도움처럼 한국어 명령을 쓰면 한국어 안내 뒤에 같은 내용의 영어 안내도 나옵니다. nme 네이티브와 nme 설치의 오류도 한국어 우선 한영 형식입니다. nme help와 영어 명령은 영어만 출력합니다.

실행해도 안전하고 사용자가 원하면 nme 실행 program을 사용합니다. 네이티브 결과물을 원하고 Nuitka가 설치됐을 때만 nme 컴파일을 사용합니다.

문서에 나온 NME 동작만 한국어와 영어 별칭을 지원합니다. 고급 문법은 Python이므로 def, for, import, return 같은 Python 키워드는 그대로 사용합니다. 없는 한국어 고급 키워드를 만들어 내지 마세요.

요청한 문장이 여기에 없다면 전체 한국어 문법 레퍼런스나 영어 레퍼런스를 읽으세요. 지원하지 않는 NME 키워드를 만들어 내지 말고 항상 올바른 고급 NME인 Python으로 돌아가세요.

#일반 대화형 AI와 NME 사용하기

ChatGPT, Claude(채팅), Gemini, Grok은 링크로 웹 페이지를 읽을 수 있으므로 같은 짧은 문장 + 링크 하나 설계가 그대로 작동하고 프로젝트에 파일이 필요 없습니다. 이 페이지 맨 위의 문장이나 위의 목적별 시작 문장을 새 채팅에 붙여 넣고, 같은 채팅에서 계속 질문하면 안내 문서가 대화 맥락에 남습니다.

• ChatGPT: 문장과 링크를 채팅에 붙이고 .nme 파일을 요청하세요.
• Claude(채팅, claude.ai): 같은 문장과 링크를 붙이세요. Claude는 답하기 전에 링크에서 페이지를 읽습니다.
• Gemini: 문장과 링크를 붙이고 이어진 질문으로 결과를 다듬으세요.
• Grok: 문장과 링크를 한 메시지에 붙이고 그 대화를 이어 가세요.

이 문서에 없는 표현이 있으면 이 중 아무 AI나 문법 레퍼런스도 읽을 수 있습니다. 이런 대화형 AI는 보통 nme CLI를 직접 실행하지 못하므로, 프로그램을 받은 뒤에는 직접 nme 검사(또는 nme c)를 실행하고 오류를 다시 채팅에 붙여 주세요.

#제품별 링크 전달 방법

• Cursor: URL을 @Link로 붙입니다. Cursor 공식 @Link 안내를 참고하세요.
• Claude Code: 세션을 시작할 때 전달 문장을 붙입니다. Anthropic 공식 메모리 문서의 CLAUDE.md도 선택적으로 쓸 수 있지만 NME에는 필요하지 않습니다.
• Codex: 전달 문장을 작업으로 붙입니다. Codex는 OpenAI 공식 안내에 나온 AGENTS.md 지침도 지원하지만 NME 프로젝트에서 추적할 필요는 없습니다.
• OpenCode: 전달 문장을 붙입니다. 공식 규칙 문서는 사용자가 지속 설정을 원할 때 원격 지침 URL도 지원합니다.

저장소 소유자가 명시적으로 추적하라고 하지 않았다면 도구별 AI 메타데이터는 NME 프로그램 저장소 밖에 두세요.