VASMC

🌍 English | 🇨🇳 中文

---

🌍 English

Decentralized Markdown prompt compiler for LLM skills and documents for AI tools.

VASMC treats Markdown prompts, skills, and documentation as source code. You maintain .vasm.md files, declare imports and output intent, then run vasmc build to produce clean .md outputs plus a structured .vasmc/build-report.yaml for the current AI editor to review, translate, trim, or block.

Quick Start

npm install -g @vasm/cli
vasmc init
vasmc build

Minimal source:

---
vasm:
  alias: release-reviewer
  intent: "Review release notes against source changes."
  compile:
    format: executable
    targetLangs: ["en"]
---

# Release Reviewer

[Rules](./fragments/release-rules.vasm.md "@import:inline")

Build result:

• Clean Markdown output for the target AI.
• .vasmc/build-report.yaml with deterministic report actions such as verify, integration_guidance, translate, refresh_translation, tree_shake, policy_review, policy_gate, and project_review.
• Source file rule: generated .md files are review evidence, while fixes normally go back to .vasm.md source files.

Documentation

Document	Purpose
Usage Guide	Full source-to-output guide with practical examples.
AI Workflow	How an AI editor should execute build report actions.
Protocol Reference	Manifest, imports, build config, report actions, policy diagnostics, and content signals.
CLI Help	Command reference for vasmc and vasm-console.
Design	Design philosophy and compiler model.

Packages

Package	Command	Role
@vasm/core	none	Shared deterministic compiler core.
@vasm/cli	vasmc	AI build, dependency management, and structured report actions.
@vasm/console	vasm-console	Human-facing optional external-model console tools.

Release

This repository uses Changesets. Run npm run release:check before publishing. The unified release entrypoint is:

npm run release
npm run release -- --only npm
npm run release -- --only gitlab,npm
npm run release -- --skip github
npm run release -- --dry-run

The default targets are npmjs, GitHub, and GitLab. Use --only to select targets, or --skip to exclude targets from the default set. The script creates the aggregate v<version> tag and package tags, then publishes npm packages, pushes tags, and creates GitHub/GitLab releases according to the selected targets.

---

🇨🇳 中文

面向 LLM skill、prompt 和 AI 文档的去中心化 Markdown prompt 编译器。

VASMC 把 Markdown prompt、skill 和文档当作 source code 维护。你编辑 .vasm.md，声明 import 和输出用途，然后运行 vasmc build 生成纯净 .md 产物，并生成 .vasmc/build-report.yaml，交给当前 AI 编辑器继续校验、翻译、精简或阻断。

快速开始

npm install -g @vasm/cli
vasmc init
vasmc build

最小 source：

---
vasm:
  alias: release-reviewer
  intent: "Review release notes against source changes."
  compile:
    format: executable
    targetLangs: ["en"]
---

# Release Reviewer

[Rules](./fragments/release-rules.vasm.md "@import:inline")

构建后得到：

• 给目标 AI 直接读取的纯净 Markdown 产物。
• .vasmc/build-report.yaml，包含 verify、integration_guidance、translate、refresh_translation、tree_shake、policy_review、policy_gate、project_review 等结构化 actions。
• 源文件优先：生成的 .md 是审查证据，修复通常回到 .vasm.md source。

文档入口

文档	用途
使用手册	带完整 source 到 output 示例的主教程。
AI 工作流	AI 编辑器如何执行 build report actions。
协议参考	Manifest、import、build config、report actions、policy diagnostics 和 content signals。
CLI 帮助	vasmc 与 vasm-console 命令参考。
设计文档	设计哲学与编译器模型。

包边界

包	命令	职责
@vasm/core	无	共享确定性编译核心。
@vasm/cli	vasmc	面向 AI 的 build、依赖管理和结构化 report actions。
@vasm/console	vasm-console	面向人类的可选外部模型控制台工具。

发布

本仓库使用 Changesets。发布前运行 npm run release:check。统一发布入口是：

npm run release
npm run release -- --only npm
npm run release -- --only gitlab,npm
npm run release -- --skip github
npm run release -- --dry-run

默认目标是 npmjs、GitHub 和 GitLab。--only 用于只选择部分目标，--skip 用于从默认目标中排除部分目标；脚本会创建 v<version> 聚合 tag 和 package tags，并按目标发布 npm 包、推送 tag、创建 GitHub/GitLab release。