# archify-vscode-ext

[![Buy me a coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://buymeacoffee.com/root.at.skic)

Agent Skill for Archify diagrams and models as read by the [Archify Diagram Viewer](https://marketplace.visualstudio.com/items?itemName=root-at-skic.archify-vscode-ext) VS Code extension: how to write `.archify` diagrams (architecture, workflow, sequence, dataflow, lifecycle), how to put them together as a model (`main.archify`, shared elements in `*.archify-registry` files, `ref:` components, `diagram:` links, C4-style folders), and tasks that validate, list, scaffold, resolve and render them. The Archify validator and renderer (MIT, by tt-a1i) are bundled under `scripts/vendor`, so nothing else needs to be installed.

## Install and update

One command, any agent (Claude Code, Codex, Copilot, Cline, …):

```bash
npx skills add https://gitea.lego-cloud.eu/vscode-extensions-skills/archify-vscode-ext.git --global --agent claude-code,codex,github-copilot,cline
npx skills update --global
```

In Claude Code, the same skill is also a plugin of the `root-at-skic` marketplace. Every commit on `main` is a new version, so an update always brings the latest; switch on auto-update for the marketplace and it arrives on its own:

```
/plugin marketplace add https://gitea.lego-cloud.eu/vscode-extensions-skills/marketplace.git
/plugin install archify-vscode-ext@root-at-skic
```

Or clone the repository into your agent's skills folder (`~/.claude/skills`, `~/.agents/skills`) and `git pull` to update. Pick one route per machine: a skill installed twice is offered to the agent twice. The bundled Archify version is printed by every `task model:validate` run (`archify: 3.0.1`), so a stale copy is easy to spot.

Quick start:

```bash
cd scripts
task model:scaffold -- --dir="/path/to/online-shop" --id="online-shop" --name="Online Shop" --c4
task model:validate -- --dir="/path/to/online-shop"
task model:graph    -- --dir="/path/to/online-shop" --query="from:web to:db"
task diagram:render  -- --file="/path/to/online-shop/0200-containers/online-shop.archify" --out="/tmp/containers.html"
```

See [SKILL.md](SKILL.md) for the workflow, the task table and the gotchas. `examples/` holds three complete models that validate (C4 - Standard Web App, C4 - E-Shop, C4 - Event-Based Integration); `task model:scaffold -- --dir="…" --example="c4-e-shop"` copies one.

Requires Node.js 18+, bash and [go-task](https://taskfile.dev). The skill targets the Archify Diagram Viewer extension; a diagram that validates here opens the same way in VS Code.

## Support

If this saves you time, a coffee keeps it going:

[![Buy me a coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://buymeacoffee.com/root.at.skic)