root-at-skic
887ca973a0
- services/graph.mjs builds the union graph (elements, connections, decision and registry nodes) from the loaded model - queries: text, type:, diagram:, decision:, uses:, near:, from: to:, unused, shared, -shared; walks follow connections only - task model:graph with --query and --links; three suite checks; SKILL.md task row and gotcha
40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
# archify-vscode-ext
|
|
|
|
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, you can buy me a coffee: https://buymeacoffee.com/root.at.skic
|