ralph-vault — скилл

---
name: ralph-vault
description: >-
  Create and maintain a project-agnostic deepwiki knowledge vault — a tiered,
  progressive-disclosure documentation base for one or many code
  repos/subdirectories, designed as the knowledge source for ralph-loop agents.
  Use when the user wants to initialize a vault, document or refresh repos, add
  or remove a repo or subdirectory from the vault, validate the vault, check what
  is missing or stale, or generate a ralph-loop plan to (re)build it. Triggers
  include create/init a vault, document this repo, update the vault, add a repo
  to the vault, validate the vault, vault status, knowledge base for ralph.
---

# Ralph Vault

Lifecycle tool for a **knowledge vault**: a tiered deepwiki that documents the intent, interfaces and structure of one or more code repositories, kept faithful and current so agents (especially ralph loops) have a reliable knowledge source. Project-agnostic — the documented repos live in a per-vault config registry, nothing is hardcoded.

## How it is split

- **Deterministic work → `scripts/gv.py`** (a single stdlib CLI): scaffolding, the repo registry, status, validation, and emitting ralph plan files. Run it directly; it needs no context loaded.
- **Content generation → FIXED prompts in `assets/prompts/`** driven by an agent / ralph loop: writing the actual documentation from source.

Run `gv.py` from the project that owns the vault. Default vault path is `vault/`; override with `--vault <path>`.

## Action router

Load the matching reference file **only** for the action at hand (progressive disclosure). Do not preload all of them.

| Intent | Action | Load |
|---|---|---|
| Create the vault structure + config if missing | **init** | `references/init.md` |
| Register a repo or subdirectory to document | **add** | `references/add.md` |
| Remove a repo/subdir (optionally purge docs) | **delete** | `references/delete.md` |
| Document or refresh repos (incomplete/stale) | **update** | `references/update.md` |
| Generate typed edges between repos | **relations** | `references/relations.md` |
| Catalogue external infra + providers (reverse index) | **dependencies** | `references/dependencies.md` |
| Research public docs for one external provider before filling technology notes | **external-provider-research** | `references/external-provider-research.md` |
| Promote components/libraries reused by ≥ 2 repos | **components** | `references/components.md` |
| Frontmatter / wikilink / budget gate | **validate** | `references/validate.md` |
| Report what is missing / incomplete / stale | **check** | `references/check.md` |
| Emit `plan/plan.md` + tasks for a ralph loop | **plan** | `references/plan.md` |
| Wire git/CI gates so the vault can't drift | **ci** | `references/ci.md` |

Shared contracts (load when authoring or validating content, not for routine CLI calls):