What is SQLiteCpp copilot-instructions.md?

A project-specific coding guide for SQLiteCpp, a C++ wrapper around the SQLite database engine. It defines coding rules, API patterns, supported language versions, and steps for adding methods or classes.

Use it when adding SQLiteCpp methods or classes, changing public headers, handling errors or threads, and updating tests or the changelog.

It gives an agent the project’s rules before it changes code, reducing inconsistent APIs, portability problems, missing documentation, and untested changes.

SQLiteCpp copilot-instructions.md — Instructions file by SRombauts

Install

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.

agentmods

npx agentmods add instructions/srombauts/sqlitecpp/copilot-instructions

Clone the repo

git clone --depth 1 https://github.com/SRombauts/SQLiteCpp

Made for: GitHub Copilot.

Per session 2,165 This file is loaded in full into every session.

When invoked 2,165 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What 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.02165	$0.02165
Opus 5	$0.01082	$0.01082
Sonnet 5	$0.00433	$0.00433
Haiku 4.5	$0.00216	$0.00216

Measured yesterday against content hash 0497d0aa7c6f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

SQLiteCpp copilot-instructions.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 yesterday.

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.

.github/copilot-instructions.md · 236 lines

How it starts

The opening of the file, as written. The whole thing — 236 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SQLiteCpp LLM Coding Guide

Non-Negotiables (MUST Follow)

RAII only. Acquire in constructors, release in destructors.
NEVER throw in destructors. Use SQLITECPP_ASSERT() instead.
Errors: use SQLite::Exception for throwing APIs; tryExec(), tryExecuteStep(), tryReset() return SQLite codes.
C++11 only in core library. C++14 only in VariadicBind.h and ExecuteMany.h.
Public API headers must NOT include sqlite3.h. Use SQLite::OPEN_* flags from Database.h.
Export public API with SQLITECPP_API from SQLiteCppExport.h.
Threading: one Database/Statement/Column per thread.
Public API must have Doxygen: @brief, @param, @return, @throw.
Tests required for new functionality in tests/.
Portability: Windows, Linux, macOS.
Style: ASCII only, 4 spaces, Allman braces, max 120 chars, LF line endings, final newline, #pragma once.

Workflow (Common Tasks)

Add a Method

Declare in include/SQLiteCpp/<Class>.h with Doxygen.
Implement in src/<Class>.cpp.
Add tests in tests/<Class>_test.cpp.
Update CHANGELOG.md.

Add a Class

Create include/SQLiteCpp/NewClass.h and src/NewClass.cpp.
Add to CMakeLists.txt (SQLITECPP_SRC and SQLITECPP_INC).
Add to meson.build.
Include in SQLiteCpp.h if public API.
Create tests/NewClass_test.cpp.
Add test to CMakeLists.txt and meson.build.

Git Workflow (GitHub Issues)

When to create a new branch:

User explicitly mentions working on a task, issue, or feature (e.g., "work on issue #123", "implement feature X")
User references a GitHub issue number

Before starting work:

Run git status to check current branch.
If on master or wrong branch, create a task-specific branch from master.

Branch naming: <issue>-<type>-<short-description> or <type>-<short-description>

123-fix-short-description for bug fixes
123-feature-short-description for new features
fix-short-description or feature-short-description when there is no issue/ticket number (issue ID is optional; do not use 000-)

Read the full file on GitHub · 236 lines

Changes

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.

yesterday First seen · 236 lines · 2,165 tokens per session scan A 0497d0aa7c6f

Subscribe to this mod's changes

SQLiteCpp copilot-instructions.md is an instructions file published in the GitHub repository SRombauts/SQLiteCpp (2,781 stars, last pushed 6d ago), licensed MIT. It adds 2,165 tokens to every session, about $0.0108 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.

Backend and APIs Git and workflow Testing

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.

openai/codex · 5,182 tokens

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).

microsoft/vscode · 6,785 tokens

SQLiteCpp copilot-instructions.md