Vibe Manager
SAMO self-analysis inside VS Code. The rules, reports and dependency maps come
from stylist-samo-analyze; the
extension shows them where you edit.
SAMO is the best practice for VIBE-coding: SOLID · Atomic · Morphological · Orchestration.
Every entity lives at <domain>/<cluster>/<joint>/<family>, one entity per file,
dependencies follow data → const → type → interface → function → class → component → test.
What it does
| Command |
Result |
| SAMO: Check current file (also on save) |
SAMO rules over the file, in the Problems panel, each with its rule, ADR and fix. |
| SAMO: Run full audit |
Indexation dry run, dependency graph and every rule; the sources are never written. |
| SAMO: Show latest report |
Loads report/findings.jsonl of the folder into the Problems panel. |
| SAMO: Explain current entity |
The family of the current file: findings, imports and dependents. |
| SAMO: Library families used by this project |
consumers.json: every stylist-svelte family the project imports, missing ones flagged. |
| SAMO: Projects affected by library changes |
For a library: which configured projects import the families changed in git. |
The extension follows run.json of the report folder, so a samo audit started
by an agent or in a terminal updates the Problems panel of every open window.
Settings
A folder is configured by stylist-samo.config.json (paths relative to the file):
{
"stylist": "../stylist-svelte",
"outDir": ".samo"
}
| Key |
Meaning |
library |
Package audited by samo audit; the folder of the config by default. |
stylist |
The stylist-svelte copy this project imports from. |
sources |
Folders scanned for library imports; src by default. |
consumers |
Projects that import this library, for impact analysis. |
outDir |
Output root: snapshot/, report/, di/, auditor/; .samo by default. |
root, baseline, extends |
Report root, accepted findings, base config. |
vibeManager.checkOnSave turns the save check off.
Build
Yarn 4 (packageManager), node_modules linker.
yarn install
yarn check
yarn build # dist/extension.js and dist/samo.mjs
yarn package # vibe-manager-<version>.vsix
The extension ships two bundled files; the analysis code is the
stylist-samo-analyze package.
Publishing
The extension uses stylist-samo-analyze@^0.1.0 from npm. Before publishing,
check and package the installed dependency:
yarn install --immutable
yarn check
yarn package # vsix: dist, icon, README, CHANGELOG, LICENSE
yarn publish:vsce # needs a marketplace token of the publisher
The build bundles the installed package, so a new samo release reaches the
extension only after yarn up stylist-samo-analyze and a new extension version.
License
GPL-3.0-only: the bundled stylist-samo-analyze is GPL-3.0, so the extension is
too. Versions up to 0.0.4 were MIT.