ArchLang, DSL et compilateur de plans : pour qui, une première prise en main en 3 minutes et les limites d'usage

Pour qui

• Deux profils y gagnent surtout : ceux qui veulent confier la rédaction de la source d'un plan à un agent puis la compiler — le positionnement officiel est « écrire la source .arch, ou la faire écrire par un agent IA » — et ceux qui ont besoin rapidement de plans en SVG, DXF ou PDF, en contrôlant la source avec lint et la validation géométrique.
• L'outil convient aussi à qui insère le contrôle des plans dans des scripts : describe et validate acceptent tous deux la sortie --json, ce qui permet de juger l'état de la source par programme.
• Il entretient les plans comme du code : le fichier source est en texte brut, les descriptions de mise en page sont reproductibles et comparables, faciles à confier à un agent pour modification ; le produit compilé est un fichier de dessin au format vectoriel ou documentaire.
• Prérequis : toutes les commandes officielles exécutent un paquet npm via npx, votre machine doit donc savoir lancer npx ; le chemin d'installation principal vise les skills d'un coding agent, et les sous-commandes CLI se lancent dans le terminal sans raccorder un client MCP.
• À qui cela ne convient pas, et inconnues : les preuves ne montrent ni édition visuelle ni dessin par glisser-déposer, donc rien pour qui veut dessiner en WYSIWYG ; aucun exemple de syntaxe .arch n'apparaît dans les preuves, le premier fichier source s'écrit donc soi-même ou par un agent ; précision et conformité aux normes pour des dessins d'ingénierie officiels, systèmes d'exploitation pris en charge et licence restent sans mention.

Une première prise en main en 3 minutes

Il n'existe qu'un seul chemin principal : l'installation des skills, en quatre étapes.

1. Prérequis : npx fonctionne dans votre terminal ; les commandes officielles ne comportent ni clé ni paramètre de compte, aucun identifiant n'est donc à préparer. D'autres réglages d'environnement sont-ils nécessaires ? Les preuves ne le disent pas.
2. Installation : exécutez npx -y skills add ChanMeng666/archlang --yes pour installer les skills de ce dépôt pour votre coding agent.
3. Premier essai à bas coût : lancez npx -y @chanmeng666/archlang context. Positionné officiellement comme « tout le langage ArchLang en un seul appel », il dispense l'agent de précharger la connaissance du langage. Signal de réussite : le terminal affiche la description du langage. L'accès éventuel au réseau et les autres détails de lecture/écriture ne sont pas précisés par les preuves.
4. Obtenir un premier produit : une fois votre plan.arch prêt, exécutez npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json ; le signal de réussite est la création locale de plan.svg accompagnée d'un état en JSON. Notez que compile écrit un fichier local — une écriture locale, pas une opération en lecture seule — à lancer de préférence après avoir vérifié le contenu de la source.

Remarque secondaire (un autre chemin officiel, qui ne se met pas sur le même rang que le chemin principal) : un client MCP peut exécuter claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp, qui lance via npx le paquet npm distinct @chanmeng666/archlang-mcp et enregistre un serveur nommé archlang ; les outils MCP que ce serveur expose après l'enregistrement ne sont pas précisés par les preuves.

Cas d'usage

Cas un : inspecter avant de compiler. Scénario : vous avez déjà un plan.arch et voulez vous assurer de son contenu avant de produire un dessin. Démarche : lancez d'abord describe plan.arch --json pour lire la description structurelle, puis validate plan.arch --strict --json pour une validation stricte — les deux partagent le même préfixe de commande que compile ; après correction de la source selon les résultats, on recompile : le flux officiel est exactement corriger-puis-recompiler. Résultats attendus : description et validation au format JSON, les problèmes géométriques surgissent avant la mise en dessin. Les deux commandes portent --json et se branchent dans des scripts comme contrôle préalable à la compilation ; la structure exacte des champs de sortie de la validation n'est pas donnée par les preuves.

Cas deux : laisser l'agent écrire le dessin. Scénario : la syntaxe .arch vous est étrangère et vous voulez déléguer la source à un agent. Démarche : lancez d'abord npx -y @chanmeng666/archlang context pour remettre tout le langage à l'agent en une fois — officiellement, aucun préchargement de connaissances n'est requis ; l'agent produit ensuite la source .arch ; enfin la commande compile génère le dessin. La source vient de l'agent, la compilation et la validation restent des commandes locales. Résultats attendus : la source et votre premier plan.svg. Le positionnement du projet prend en charge la sortie SVG, DXF ou PDF, mais la commande de compilation littéralement copiable dans les preuves ne couvre que SVG ; les paramètres de sortie exacts de DXF et PDF ne sont pas confirmés — ne les extrapolez pas vous-même.

Limites d'usage

• Nature lecture/écriture : compile lit plan.arch et écrit localement plan.svg selon -o — une écriture locale explicite ; describe, validate et context ne sont pas officiellement étiquetés outils en lecture seule, context n'est décrit que comme affichant la description du langage, et leurs autres détails restent non précisés.
• Identifiants et configuration : aucune des commandes officielles ci-dessus n'embarque de clé ni de jeton, aucune information obligatoire du type nom ou courriel n'apparaît ; l'existence d'une configuration d'environnement supplémentaire n'est pas précisée.
• Distinction des chemins : la première prise en main de cet article repose sur les sous-commandes CLI et l'installation des skills ; viser des agents au sein d'un client MCP impose d'exécuter séparément la commande d'enregistrement — les deux chemins installent des contenus différents avec des prérequis différents.
• Effets de bord et points de contrôle : compile écrit un fichier local, vérifiez le chemin de sortie avant de lancer ; aucun retour arrière n'est officiellement documenté, il ne faut donc pas le dire « annulable ». Où écrit exactement l'installation des skills n'est pas précisé.
• Les deux artefacts sont indépendants : l'installation des skills vise le paquet de compétences de l'agent ; claude mcp add enregistre un autre paquet npm. Leur relation et la possibilité de n'installer que l'un ne sont pas précisées.
• Licence, plateformes prises en charge, comportement réseau et périmètre des données n'apparaissent pas dans les preuves ; « rien de trouvé » ne veut pas dire « aucun risque », et cet article ne tire aucune conclusion de sécurité indépendante.