vellum-boundary-guard

Solid

Check Vellum Assistant architecture and package boundaries. Use when editing imports, moving code, adding endpoints, touching assistant/gateway/client/skill boundaries, or reviewing architecture-sensitive changes.

AI & Automation 648 stars 94 forks Updated today MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
94
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
87
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Vellum Boundary Guard ## Package Import Boundaries Enforce these boundaries: - `assistant/` must not import from `gateway/` via relative paths. - `gateway/` must not import from `assistant/` via relative paths. - `assistant/` and `skills/` must not import from each other directly. - Runtime code must not import from `meta/`. - Shared cross-package logic belongs in `packages/`. For tests that need behavior from another package, mock the boundary instead of importing real handlers. ## HTTP And IPC Boundaries - Public inbound HTTP endpoints belong in `gateway/`. - New CLI-to-assistant interactions should use Unix socket IPC through the existing IPC route pattern. - Events from assistant runtime code should use the assistant event hub rather than new HTTP endpoints when possible. ## Security Ownership Boundaries - Gateway owns trust rules and gateway security files. - CES owns credential files. - The assistant must not read gateway-owned directories directly. - Clients must not read from the user's `~/.vellum` directory. - Secrets must not be stored in workspace files. ## Skill Boundaries First-party skills run as separate processes and should communicate through supported contracts. Do not bypass skill isolation with direct relative imports. ## Review Workflow 1. Search changed imports and new route registrations. 2. Identify any package-crossing dependency. 3. Decide whether the correct home is a package-local module, a shared `packages/` module, IPC, HTTP through...

Details

Author
vellum-ai
Repository
vellum-ai/vellum-assistant
Created
4 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category