Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/dev-five-git/vespertide/agents-mdgit clone --depth 1 https://github.com/dev-five-git/vespertideWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.10472 | $0.10472 |
| Opus 5 | $0.05236 | $0.05236 |
| Sonnet 5 | $0.02094 | $0.02094 |
| Haiku 4.5 | $0.01047 | $0.01047 |
Grade A, and why
vespertide AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 606 lines — stays where its author put it; the contents beside it link to each section on GitHub.
VESPERTIDE KNOWLEDGE BASE
Generated: 2026-05-24 Commit: 9103bb3 Branch: refactor Targeting: 0.2.0 (API stability + LSP hot-spot caching)
OVERVIEW
Rust workspace for declarative database schema management. Define schemas in JSON, diff against migration history, generate typed actions and SQL.
STRUCTURE
vespertide/
├── crates/
│ ├── vespertide-core/ # Data structures: TableDef, ColumnDef, MigrationAction; newtype names
│ ├── vespertide-planner/ # Schema diffing, baseline reconstruction, validation
│ ├── vespertide-query/ # SQL generation (Postgres/MySQL/SQLite)
│ ├── vespertide-cli/ # CLI commands: init, diff, sql, revision, export
│ ├── vespertide-exporter/ # ORM codegen: SeaORM, SQLAlchemy, SQLModel, JPA, Prisma
│ ├── vespertide-loader/ # Filesystem loading of models/migrations
│ ├── vespertide-config/ # vespertide.json configuration
│ ├── vespertide-lsp/ # Language server: 13 LSP capabilities + HS-7~11 caching
│ ├── vespertide-macro/ # Compile-time migration macro
│ ├── vespertide-naming/ # Naming convention utilities
│ ├── vespertide-schema-gen/# JSON Schema generation
│ └── vespertide/ # Re-export crate (user-facing API)
├── examples/app/ # Example project with models/migrations (out-of-workspace)
├── tools/lsp-profile/ # LSP synthetic / realistic workload + latency profiler (out-of-workspace)
├── fuzz/ # cargo-fuzz targets (4 targets, see FUZZING section)
├── tests/runtime-sqlite/ # vespertide-macro runtime SQLite tests (out-of-workspace)
├── schemas/ # Generated JSON Schemas for IDE support
├── docs/ # profiling.md, profiling-baseline.json, clippy-allow-audit.md
└── CLAUDE.md # Detailed implementation guidance
WHERE TO LOOK
| Task | Location | Notes |
|---|---|---|
| Core types (TableDef, ColumnDef) | vespertide-core/src/schema/ |
Start with table.rs, column.rs |
| Newtype name wrappers | vespertide-core/src/schema/names.rs |
TableName / ColumnName / IndexName with #[serde(transparent)] |
| Column type system | vespertide-core/src/schema/column.rs |
ColumnType::Simple/Complex variants |
| Migration actions | vespertide-core/src/action/ |
15 action variants (incl. RawSql escape hatch), MigrationPlan struct |
| QueryError variants | vespertide-query/src/error.rs |
InvalidColumnType / SchemaError / BackendError / UnsupportedAction; Other is #[deprecated] |
| Schema diffing | vespertide-planner/src/diff/ |
topological sort for FK deps |
| SQL generation | vespertide-query/src/sql/ |
One file per action type |
| CLI commands | vespertide-cli/src/commands/ |
cmd_* functions |
| ORM export | vespertide-exporter/src/{seaorm,sqlalchemy,sqlmodel,jpa,prisma}/ |
Backend-specific generators |
| Compile-time macro | vespertide-macro/src/lib.rs |
vespertide_migration! proc macro |
| LSP RingCache (HS-7~11) | vespertide-lsp/src/cache.rs |
Generic ring-buffer LRU shared across symbols/diagnostics/drift/semantic-token caches |
| LSP drift cache | vespertide-lsp/src/drift/cache.rs |
HS-10 drift cache implementation |
| LSP profiler | tools/lsp-profile/src/ |
Synthetic + realistic workloads with p50/p95/p99 latency stats |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 606 lines · 10,472 tokens per session scan A ecaf6b4f7ec8
vespertide AGENTS.md is an instructions file published in the GitHub repository dev-five-git/vespertide (23 stars, last pushed 2d ago), licensed Apache-2.0. It adds 10,472 tokens to every session, about $0.0524 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
buildNext
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
spec-kit AGENTS.md
Instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
langchain AGENTS.md
Instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.