# Vault Loop

> Design recurring knowledge-base update loops for Obsidian-style vaults, project wikis, second-brain folders, and research notebooks. Use when setting up automated source ingestion, daily reflection, meeting-note processing, health checks, state cursors, runbooks, scheduler prompts, or validation gates for a maintained knowledge system.

- **Type:** Skill
- **Install:** `agentstack add skill-jessepwj-vault-loop-vault-loop`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jessepwj](https://agentstack.voostack.com/s/jessepwj)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jessepwj](https://github.com/jessepwj)
- **Source:** https://github.com/jessepwj/vault-loop/tree/main/skill/vault-loop

## Install

```sh
agentstack add skill-jessepwj-vault-loop-vault-loop
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Vault Loop

Use this skill to create a recurring maintenance loop for a knowledge base.

The goal is not to copy a private automation setup. The goal is to create a small, durable loop with state, runbooks, validation, and recovery rules.

## Workflow

1. Restore context from the user's local agent instructions and shortest recent cache, if they exist.
2. Ask only for missing source scope, privacy boundary, runtime, and first lane.
3. Define a lane with `lane_id`, purpose, source, frequency, state file, run artifacts, writeback targets, validation gate, failure behavior, and notification behavior.
4. Create or update a runbook and state file.
5. Draft a self-contained scheduler prompt.
6. Verify that validation and state advancement rules are explicit.
7. Report active, paused, proposed, and blocked lanes.

## Required Rules

- Use compensation windows: `last_success_at - overlap_minutes -> trigger_start`.
- Do not advance `last_success_at` after partial coverage, missing validation, health errors, or unresolved pending queues.
- Keep raw sources immutable when the vault has a raw layer.
- Write durable knowledge to object pages, not only dated run logs.
- Separate knowledge update lanes from notifications and outbound actions.
- Ask before scanning broad personal files, chats, drives, browser history, or cloud accounts.
- Do not send private knowledge into public posts, messages, issues, or tasks without explicit permission.

## Artifact Shape

Every recurring lane should have:

- a state file with `last_success_at`, `overlap_minutes`, `pending`, `last_run`, and `known_blockers`;
- a runbook with workflow, recovery steps, and completion rules;
- dated plan/run/review artifacts;
- a validation checklist or deterministic validation script;
- a scheduler prompt that another agent can run without hidden context.

## Completion Gate

Only mark a lane setup complete when:

- source scope is explicit;
- privacy boundary is explicit;
- state cursor exists;
- runbook explains blocked recovery;
- scheduler prompt includes startup, source collection, writeback, validation, health, and state advancement rules;
- validation has been run or the remaining blocker is named.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jessepwj](https://github.com/jessepwj)
- **Source:** [jessepwj/vault-loop](https://github.com/jessepwj/vault-loop)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jessepwj-vault-loop-vault-loop
- Seller: https://agentstack.voostack.com/s/jessepwj
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.