What is Seshat-BI CLAUDE.md?

Repository-specific working instructions for Seshat BI, a business-analytics service that prepares data for Power BI. They describe the project’s data layers, naming rules, secrets handling, and database and Power BI conventions.

Use them when changing Seshat BI data pipelines, SQL migrations, Power BI project files, or retail analytics models.

They help coding agents make changes that fit this repository and avoid exposing credentials, breaking its data model, or ignoring required project rules.

How Kemetra/Seshat-BI configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to Kemetra/Seshat-BI. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/Kemetra/Seshat-BI/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/Kemetra/Seshat-BI

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/kemetra/seshat-bi/claude-md.svg)](https://agentmods.dev/instructions/kemetra/seshat-bi/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/kemetra/seshat-bi/claude-md"><img src="https://agentmods.dev/badge/instructions/kemetra/seshat-bi/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 835 This file is loaded in full into every session.

When invoked 835 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.1	$0.00835	$0.00835
Opus 5	$0.00417	$0.00417
Sonnet 5	$0.00167	$0.00167
Haiku 4.5	$0.00084	$0.00084

Measured 4d ago against content hash 325acb39895c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

Seshat-BI CLAUDE.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 4d 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.

CLAUDE.md · 62 lines

How it starts

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

CLAUDE.md — Seshat BI

Repo-specific rules. Global rules in ~/.claude/CLAUDE.md still apply.

What this repo is

A standalone analytics service — NOT bound by the Retail Tower OS orchestrator / contract-boundary rules. Power BI primary; DigitalOcean Postgres source. Data flows bronze → silver → gold; Power BI reads the gold schema only.

For new retail mart work, start from a filled worked example under docs/worked-examples/ and follow the medallion playbook.

Hard rules

Secrets: credentials only in .env (git-ignored). Never write real values into tracked files. Power BI uses parameters, not baked-in connection strings.
PBIP .gitignore baseline is exact: **/.pbi/localSettings.json and **/.pbi/cache.abf. Never ignore definition/ folders — that's the model.
PBIP is a preview feature (as of 2025-12); enable it in Power BI Desktop.
Windows 260-char path limit — keep PBIP project/table names short.
Line endings: core.autocrlf=true; rely on .gitattributes. Edit PBIP text externally only as UTF-8 without BOM.

Conventions

SQL: snake_case; schemas bronze/silver/gold; vw_/fct_/dim_ prefixes; numbered idempotent migrations. DAX: PascalCase measures in display folders. Full detail in docs/conventions.md.

Scope discipline (YAGNI)

No live DB provisioning, no automated ingestion code, no orchestrator integration unless explicitly requested. Add the seam, not the implementation.

No active Spec Kit implementation plan.

Seshat BI kit router (v0.2.0) -- generated from .seshat/kit-source.yaml; do not edit here.

Orient first: What readiness stage am I serving? State lives in readiness-status.yaml (per TABLE, recomputed) (recomputed; this file stores none).

Verbs the agent drives:

retail-orchestrate -- conductor -- sequence the medallion verbs, self-heal against the gate
first-hour-compass -- first-arrival worked-example offer + single-source seam list + single-table orientation card
retail-onboard-table -- Source->Mapping front door; owns the Stage-1 read-only DB-backed profile (grain candidates, column types)
retail-discover-portfolio -- metadata-only portfolio discovery -> governed domain/scope proposals -> selected-table onboarding -> interview handoff
business-knowledge-interview -- after DB discovery, interview the owner into the Decision Store (batch low-risk, explicit critical); records decisions, never self-grants approval
source-mapping -- the mapping gate -- produces source-map.yaml
kpi-contract-builder -- drive the shipped kpi_contracts engine: assess answerability, list the decisions to approve, preview with per-field provenance, then draft/finalize -- never self-grants approval
retail-build-warehouse -- author silver/gold SQL; stop before executing
retail-validate -- live checks; needs db extra + DSN, else [PENDING LIVE PROFILE]
retail-govern -- static check (seshat check)

Read the full file on GitHub · 62 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.

4d ago First seen · 62 lines · 835 tokens per session scan A 325acb39895c

Subscribe to this mod's changes

Seshat-BI CLAUDE.md is an instructions file published in the GitHub repository Kemetra/Seshat-BI (2 stars, last pushed 5d ago), licensed Apache-2.0. It adds 835 tokens to every session, about $0.0042 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-09-03.

Analytics and metrics Claude Code Data and AI ai-agents analytics-engineering business-intelligence data-engineering data-governance

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

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,153 tokens

vscode buildNext.instructions.md

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

Seshat-BI: Instructions file for Claude Code