インストール
npx -y skills add ChanMeng666/archlang --yes向いている人
- 最も向いているのは二通りの人：エージェントに平面図のソースを代筆させてからコンパイルしたい人（公式の位置づけは「
.archソースを書く、または AI エージェントに書かせる」）、そしてlintと幾何検証でソースを確認しながらSVG・DXF・PDF形式の平面図を素早く欲しい人。 - 図面チェックをスクリプトに組み込みたい人にも向く：
describeとvalidateはどちらも--json出力に対応し、ソースの状態をプログラムから判定しやすい。 - 平面図をコードとして管理する道具だ：ソースファイルはプレーンテキストで、レイアウト記述は再現・比較でき、エージェントへの修正依頼も容易。コンパイル成果物はベクターまたは文書形式の図面ファイルになる。
- 利用の前提：公式コマンドはすべて
npmパッケージをnpx経由で実行するため、手元でnpxが使える必要がある。主なインストール経路はcoding agent向けのskillsで、MCPクライアントに接続しなくてもターミナルで CLI サブコマンドを直接実行できる。 - 向かない人・不明点：証拠にはビジュアル編集やドラッグ＆ドロップ作図の機能がなく、WYSIWYG で図を描きたい人には向かない。
.archの文法サンプルは証拠に現れず、最初のソースファイルは自分で書くかエージェントに書かせる必要がある。正式なエンジニアリング図面としての精度・規格適合性、対応 OS、ライセンスはいずれも証拠に記載がない。
3分で初回の試行
主経路は一つだけ：skills インストールの四ステップ。
- 前提：ターミナルで
npxが使えること。公式コマンド自体にはキーやアカウント引数がなく、事前に資格情報を用意する必要はない。他の環境設定が必要かは証拠に記載がない。 - インストール：
npx -y skills add ChanMeng666/archlang --yesを実行し、このリポジトリのskillsを自分のcoding agentに導入する。 - 低コストの初回試行：
npx -y @chanmeng666/archlang contextを実行する。公式の位置づけは「1回の呼び出しで ArchLang 言語全体を渡す」で、エージェントは言語知識を事前ロードしなくてよい。成功のシグナル：ターミナルに言語説明が出力される。このコマンドがネットワークにアクセスするかなど読み書きの詳細は証拠に記載がない。 - 最初の成果物を得る：
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パッケージ。両者の関係や、片方だけを導入できるかは証拠に記載がない。 - ライセンス、対応プラットフォーム、ネットワーク挙動、データの境界は証拠に現れない。「説明が見つからない」ことはリスクがないことを意味せず、本稿は独自のセキュリティ結論を出さない。