uv-python-repo-template AGENTS.md

Project instructions for a small Python repository starter template built around uv, a Python package and environment manager.

In plain words
What is it for?
Starting Python projects, following the repository workflow, validating scripts, and preparing changes for development or release.
Why use it?
They define the project’s reading order, branch and release practices, checks, deployment safeguards, and rules for keeping the template simple.

Instructions file for CodexOpenCode

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/jarlor/uv-python-repo-template/agents-md
Clone the repo
git clone --depth 1 https://github.com/jarlor/uv-python-repo-template

Made for: Codex, OpenCode.

Per session 296 This file is loaded in full into every session.
When invoked 296 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.

ModelPer sessionOnce invoked
Fable 5 $0.00296 $0.00296
Opus 5 $0.00148 $0.00148
Sonnet 5 $0.00059 $0.00059
Haiku 4.5 $0.00030 $0.00030

Measured 2d ago against content hash a5b18a992ee9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

uv-python-repo-template 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.

AGENTS.md · 40 lines

What it actually says

Agent Guide

This repository is a vibecoding starter template. Keep it small, explicit, and easy for an AI coding agent to operate from a clean clone.

First Read

  • README.md for the project promise and common commands.
  • docs/en/quickstart.md for setup.
  • docs/en/git-workflow.md for branch, PR, release, and backmerge rules.
  • docs/en/ci-cd.md for workflow variables and deployment profiles.

Default Workflow

  • Work from short-lived branches.
  • Target dev for normal changes.
  • Target main only for release PRs or hotfixes.
  • Use Conventional Commit titles and commit messages.
  • Do not introduce a test branch; test/staging are environments.

Quality Bar

Run before handing work back:

uv run poe check

If workflow or deploy scripts changed, also run:

bash -n scripts/cicd/*.sh scripts/init.sh scripts/pre-push.sh scripts/tag.sh

Template Rules

  • Keep deployment opt-in. Do not make new clones require test or production hosts.
  • Keep release automation opt-in. RELEASE_ENABLED=true requires a working RELEASE_TOKEN.
  • Prefer clear docs over long docs; this template is a starting point, not a product manual.
  • Do not commit local environment files, generated caches, IDE files, or secrets.
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.

  1. 2d ago First seen · 40 lines · 296 tokens per session scan A a5b18a992ee9

Subscribe to this mod's changes

uv-python-repo-template AGENTS.md is an instructions file published in the GitHub repository jarlor/uv-python-repo-template (5 stars, last pushed 4mo ago), licensed MIT. It adds 296 tokens to every session, about $0.0015 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-31.