ArchLang 평면도 DSL과 컴파일러: 누구에게 맞나, 3분 첫 사용과 사용 경계

누구에게 맞나

• 두 부류에 가장 적합하다. 하나는 에이전트에게 평면도 소스를 대신 작성하게 한 뒤 컴파일하고 싶은 사람으로, 공식 포지션 자체가 '.arch 소스를 직접 쓰거나 AI 에이전트에게 맡겨 쓰는 것'이다. 다른 하나는 lint와 기하 검증으로 소스를 점검하면서 SVG, DXF 또는 PDF 형식의 평면도를 빠르게 얻고 싶은 사람이다.
• 도면 검사를 스크립트에 넣고 싶은 사람에게도 적합하다. describe와 validate는 둘 다 --json 출력을 지원해 소스 상태를 프로그램에서 판단하기 쉽다.
• 평면도를 코드처럼 유지하는 도구다. 소스 파일은 일반 텍스트이고, 레이아웃 기술은 재현하고 비교할 수 있으며, 에이전트에게 수정을 맡기기도 쉽다. 컴파일 결과물은 벡터 또는 문서 형식의 도면 파일이다.
• 사용 전제: 공식 명령은 모두 npx로 npm 패키지를 실행하므로 로컬에서 npx를 실행할 수 있어야 한다. 주 설치 경로는 coding agent용 skills이며, MCP 클라이언트에 연결하지 않아도 터미널에서 CLI 하위 명령을 직접 실행할 수 있다.
• 맞지 않는 경우와 미확인 사항: 증거에는 시각 편집이나 드래그 앤 드롭으로 그리는 기능이 없어, 화면에서 보이는 대로 그림을 그리고 싶은 사람에게는 맞지 않는다. .arch 문법 샘플은 증거에 나타나지 않아 첫 소스 파일은 직접 쓰거나 에이전트에게 맡겨야 한다. 정식 엔지니어링 도면으로서의 정밀도와 규격 적합성, 지원 운영체제와 라이선스는 증거에 언급이 없다.

3분 만에 첫 시험

주 경로는 하나뿐이다: skills 설치, 네 단계로 끝난다.

1. 전제: 터미널에서 npx를 사용할 수 있어야 한다. 공식 명령 자체에는 키나 계정 인자가 없어 자격 증명을 미리 준비할 필요가 없다. 다른 환경 설정이 더 필요한지는 증거에 언급이 없다.
2. 설치: npx -y skills add ChanMeng666/archlang --yes를 실행해 이 저장소의 skills를 자신의 coding agent에 설치한다.
3. 저비용 첫 시험: npx -y @chanmeng666/archlang context를 실행한다. 공식 포지션은 '한 번의 호출로 ArchLang 언어 전체를 전달한다'이며, 에이전트는 언어 지식을 미리 불러올 필요가 없다. 성공 신호: 터미널에 언어 설명이 출력된다. 이 명령이 네트워크에 접근하는지 등 나머지 읽기·쓰기 세부 사항은 증거에 언급이 없다.
4. 첫 결과물 얻기: plan.arch를 준비한 뒤 npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json을 실행한다. 성공 신호는 로컬에 plan.svg가 생성되고 JSON 상태가 출력되는 것이다. compile은 로컬 파일을 쓰니 주의한다. 로컬 쓰기이지 읽기 전용 작업이 아니므로 소스 내용을 확인한 뒤 실행하는 것이 좋다.

부가 설명(또 하나의 공식 경로이며 주 경로와 나란히 놓이지 않는다): MCP 클라이언트는 claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp를 실행할 수 있다. npx로 별개의 npm 패키지 @chanmeng666/archlang-mcp를 구동해 archlang이라는 이름의 서버를 등록한다. 등록 후 그 서버가 어떤 MCP 도구를 노출하는지는 증거에 언급이 없다.

사용 사례

사례 하나: 먼저 확인하고 컴파일하기. 상황: 손에 plan.arch가 있고 도면을 내기 전에 내용이 믿을 만한지 확인하고 싶다. 방법: 먼저 describe plan.arch --json으로 구조 설명을 살펴보고, 이어 validate plan.arch --strict --json으로 엄격한 검증을 수행한다. 두 명령은 compile과 같은 명령 접두어를 쓴다. 검증 결과에 따라 소스를 고친 뒤 다시 컴파일하는 것이 공식이 제시하는 워크플로, 곧 수정 후 재컴파일 그대로다. 기대 결과: JSON 형식의 설명과 검증 결과, 그리고 도면으로 컴파일되기 전에 기하 문제가 드러나는 것. 두 명령 모두 --json을 붙여 스크립트에서 컴파일 전 사전 점검으로 쓰기 좋다. 검증 출력의 구체적인 필드 구조는 증거에 없다.

사례 둘: 에이전트에게 도면을 맡기기. 상황: .arch 문법에 익숙하지 않아 소스 작성을 에이전트에게 맡기고 싶다. 방법: 먼저 npx -y @chanmeng666/archlang context를 실행해 언어 전체를 한 번에 에이전트에게 건넨다. 공식은 이렇게 하면 언어 지식을 미리 불러오지 않아도 된다고 명시했다. 이어 에이전트가 .arch 소스를 만들어 내고, 마지막에 compile 명령으로 도면을 만든다. 소스는 에이전트가 만들지만 컴파일과 검증은 여전히 로컬 명령이 담당한다. 기대 결과: 소스와 첫 plan.svg. 프로젝트 포지션은 SVG, DXF, PDF 출력을 지지하지만, 증거에 그대로 복사해 쓸 수 있는 컴파일 명령은 SVG 한 예뿐이며 DXF와 PDF의 정확한 출력 인자는 확인되지 않았다. 스스로 유추해서는 안 된다.

사용 경계

• 읽기·쓰기 성격: compile은 plan.arch를 읽고 -o에 따라 로컬에 plan.svg를 쓰는, 분명한 로컬 쓰기다. describe, validate, context는 공식적으로 읽기 전용 도구로 표기되지 않았고, context는 언어 설명을 출력한다는 언급만 있으며 나머지 읽기·쓰기 세부 사항은 증거에 언급이 없다.
• 자격 증명과 설정: 위 공식 명령 어디에도 키나 토큰 같은 인자가 없고 이름이나 이메일 같은 필수 입력도 나타나지 않는다. 추가 환경 설정 요구가 있는지는 증거에 언급이 없다.
• 경로 구분: 이 글의 첫 시험은 CLI 하위 명령과 skills 설치에 기반한다. MCP 클라이언트 안의 에이전트가 호출하게 하려면 등록 명령을 따로 실행해야 하며, 두 경로는 설치 내용과 전제가 다르다.
• 부작용과 확인 지점: compile은 로컬 파일을 쓰므로 실행 전에 출력 경로를 확인한다. 공식에 되돌리기 경로에 대한 설명이 없어 '되돌릴 수 있다'고 부르면 안 된다. skills 설치가 정확히 어디에 무엇을 쓰는지는 증거에 언급이 없다.
• 두 산출물은 서로 독립적이다: skills 설치는 에이전트용 스킬 패키지를 대상으로 하고, claude mcp add가 등록하는 것은 다른 npm 패키지다. 두 관계와 한쪽만 설치할 수 있는지는 증거에 언급이 없다.
• 라이선스, 지원 플랫폼, 네트워크 동작과 데이터 경계는 증거에 나타나지 않는다. '설명을 찾지 못했다'는 위험이 없다는 뜻이 아니며, 이 글은 독자적인 보안 결론을 내리지 않는다.