~ / rigs / nevenincs / vaultspec-rag

nevenincs/vaultspec-rag

Semantic search for your vault and code, through the CLI or MCP. Inference runs on your GPU.

↗ GitHub ★ 2 MIT updated 15d ago project Claude CodeCodexGemini CLI
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~12.6k tokens
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
1/5
No YOLO mode · details
Quality 20/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ claude mcp add vaultspec-core -- uv run --no-sync python -m vaultspec_core.mcp_server.app
$ claude mcp add vaultspec-rag -- uv run --no-sync python -m vaultspec_rag.server
$ npx degit nevenincs/vaultspec-rag/.claude ./rig-vaultspec-rag  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ claude mcp add vaultspec-core -- uv run --no-sync python -m vaultspec_core.mcp_server.app
$ claude mcp add vaultspec-rag -- uv run --no-sync python -m vaultspec_rag.server
$ npx degit nevenincs/vaultspec-rag/.agents/skills/start-vaultspec-rag .claude/skills/start-vaultspec-rag
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-adr .claude/skills/vaultspec-adr
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-code-research .claude/skills/vaultspec-code-research
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-code-review .claude/skills/vaultspec-code-review
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-curate .claude/skills/vaultspec-curate
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-documentation .claude/skills/vaultspec-documentation
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-execute .claude/skills/vaultspec-execute
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-projectmanager .claude/skills/vaultspec-projectmanager
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-rag-discovery .claude/skills/vaultspec-rag-discovery
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-research .claude/skills/vaultspec-research
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-team .claude/skills/vaultspec-team
$ npx degit nevenincs/vaultspec-rag/.agents/skills/vaultspec-write .claude/skills/vaultspec-write
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-adr-researcher.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-adr-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-code-reviewer.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-docs-curator.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-docs-curator.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-high-executor.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-high-executor.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-low-executor.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-low-executor.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-project-coordinator.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-project-coordinator.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-reference-auditor.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-reference-auditor.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-researcher.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-standard-executor.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-standard-executor.md
$ curl -fsSL --create-dirs -o .claude/agents/vaultspec-writer.md https://raw.githubusercontent.com/nevenincs/vaultspec-rag/main/.claude/agents/vaultspec-writer.md

This rig commits no guardrails. Here is the community baseline instead — the deny/ask rules most often found across all 16.2k rigs:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(**/.env)",
      "Read(~/.ssh/**)",
      "Bash(git push --force:*)",
      "Read(**/*.pem)",
      "Read(.env)",
      "Read(~/.aws/**)",
      "Read(**/*.key)",
      "Read(**/.env.*)",
      "Bash(git push --force*)",
      "Bash(rm -rf:*)",
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(sudo:*)",
      "Bash(rm -rf /)",
      "Bash(git push -f:*)",
      "Read(.env.*)",
      "Bash(git reset --hard*)",
      "Bash(rm -rf /*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(git push *)",
      "Bash(gh pr merge *)",
      "Bash(git commit:*)",
      "Bash(rm *)",
      "Bash(gh pr merge:*)",
      "Bash(gh pr create *)",
      "Bash(git reset --hard:*)",
      "Bash(npm publish:*)",
      "Bash(git rebase *)"
    ]
  }
}

MCP servers (2)

serversourceest. tokens
python · "vaultspec-core" pypi 2.5k
python · "vaultspec-rag" pypi 2.5k

Skills (12)

Subagents (10)

vaultspec-adr-researcher
model: claude-opus-5
Draft a new or changed costly decision from sufficient evidence after
vaultspec-code-reviewer
model: claude-opus-5
Review planned work as an integrated whole against its scope and governing
vaultspec-docs-curator
model: claude-sonnet-5
Reconcile an assigned ADR corpus against decisions, code, and supporting
vaultspec-high-executor
model: claude-opus-5
Implement complex, high-reasoning steps: core refactors, architecture,
vaultspec-low-executor
model: claude-haiku-4-5
Implement clear-cut, low-risk steps: small edits, docs, simple logic.
vaultspec-project-coordinator
model: claude-sonnet-5
Aggregate context and sequence work for explicitly requested coordination
vaultspec-reference-auditor
model: claude-sonnet-5
Audit a codebase to produce a Reference of features, patterns, and best
vaultspec-researcher
model: claude-sonnet-5
Gather, analyze, and synthesize information on a question. Use for general
vaultspec-standard-executor
model: claude-sonnet-5
Implement typical feature work and well-defined steps. Use for standard
vaultspec-writer
model: claude-opus-5
Digest research and ADRs into a grounded, auditable implementation plan.

Similar rigs

copied ✓