aboutsummaryrefslogtreecommitdiff
path: root/skills/semantic-dependency-audit.json
blob: 83c1f8feff5c0a4ca71ff70368c5caab0ec1810b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "name": "semantic-dependency-audit",
  "description": "How to audit semantic dependencies across VFS, modules, skills, and agents using the Neural VFS index to detect architectural fragility",
  "tags": [
    "\"nvfs\"",
    "\"audit\"",
    "\"architecture\"",
    "\"dependencies\"",
    "\"semantic-index\""
  ],
  "category": "dev",
  "created": "2026-06-25T00:24:42.740Z",
  "updated": "2026-07-03T15:14:32.867Z",
  "content": "---\ndescription: How to audit semantic dependencies across VFS, modules, skills, and agents using the Neural VFS index to detect architectural fragility\ncategory: dev\ntags: [\"nvfs\",\"audit\",\"architecture\",\"dependencies\",\"semantic-index\"]\nupdated: \"2026-07-03T16:45:00.000Z\"\n---\n\n# Semantic Dependency Audit\n\nMap and verify semantic links across the WebX11 system to prevent silent failures.\n\n## Audit Scope\n\n- **VFS → Skills** — Are skills referenced by files still valid?\n- **Skills → Modules** — Do skills reference existing module commands?\n- **Agents → Capabilities** — Are agent capabilities backed by loaded modules?\n- **Modules → URLs** — Are module sources reachable? (`check_updates`)\n\n## Commands\n\n```\n# Build semantic index (run monthly or after major changes)\nnvfs_resolve --reindex\n\n# Query dependencies\nnvfs_resolve \"skill dependencies\"\nnvfs_resolve \"module integrity\"\nnvfs_resolve \"agent capabilities\"\n```\n\n## Fragility Indicators\n\n- Orphan skills (not referenced by any file)\n- Dead module URLs (404 or timeout)\n- Agents with capabilities for unloaded modules\n- Circular dependency chains in `/agents/` scripts\n\n## Remediation\n\n1. **Orphans** — Move to `/.trash/` or document as intentional\n2. **Dead URLs** — Reload from alternate source or deprecate\n3. **Capability gaps** — Grant agent missing capabilities or remove task\n4. **Circular deps** — Refactor into shared utility module"
}