chore: share Gemini guidance with all agents

Author: ma2za

.gemini/.env.example

@@ -0,0 +1,3 @@
+GOOGLE_GENAI_USE_VERTEXAI=true
+GOOGLE_CLOUD_PROJECT=your-project-id
+GOOGLE_CLOUD_LOCATION=us-central1

.gemini/commands/release/prepare.toml

@@ -0,0 +1,20 @@
+description = "Prepare a versioned release candidate without publishing it"
+
+prompt = """
+Prepare python-substack release {{args}} end to end, stopping before commit,
+tag, push, GitHub release creation, PyPI publication, or announcement.
+
+Read GEMINI.md, docs/releasing.md, CHANGELOG.md, pyproject.toml,
+substack/__init__.py, the relevant Git history, and the current worktree first.
+Require one explicit semantic version argument and refuse to reuse an existing
+version or tag. Preserve unrelated worktree changes.
+
+Implement any remaining release preparation that is supported by the actual
+changes: synchronize the version in pyproject.toml and substack/__init__.py,
+add the top CHANGELOG.md entry, and create docs/releases/<version>.md. Do not
+invent features or claims. Run the offline validation and package checks from
+docs/releasing.md that are safe in the current worktree. Do not run live tests.
+
+Finish with the changed files, exact validation results, unresolved blockers,
+and the maintainer actions still required before publication.
+"""

.gemini/commands/release/verify.toml

@@ -0,0 +1,17 @@
+description = "Verify a release candidate without publishing it"
+
+prompt = """
+Verify the current python-substack release candidate against GEMINI.md and
+docs/releasing.md. Inspect the worktree and version-bearing files first.
+Confirm pyproject.toml, substack/__init__.py, CHANGELOG.md, and the release page
+agree, and confirm the target version does not already have a Git tag.
+
+Run all safe offline tests, collection checks, Poetry validation, build,
+distribution metadata checks, and base plus MCP wheel smoke checks that are
+possible in this environment. Do not run live Substack tests, publish, tag,
+push, create a GitHub release, or modify release content merely to make a check
+pass.
+
+Report failures first, then successful checks and the exact remaining manual or
+CI-gated release steps.
+"""

.gemini/policies/git-override.toml

@@ -0,0 +1,6 @@
+[[rule]]
+toolName = "run_shell_command"
+commandPrefix = ["git", "gh"]
+decision = "allow"
+priority = 500
+modes = ["default", "autoEdit"]

.gitignore

@@ -111,7 +111,12 @@ env.bak/
 venv.bak/
 
 # Gemini CLI and Testing artifacts
-.gemini/
+.gemini/*
+!.gemini/.env.example
+!.gemini/commands/
+!.gemini/commands/**
+!.gemini/policies/
+!.gemini/policies/**
 tmp_pytest/
 
 # Spyder project settings

AGENTS.md

@@ -0,0 +1,17 @@
+# Shared agent instructions
+
+`GEMINI.md` is the authoritative project memory for every agent working in
+this repository. Read it completely before inspecting, changing, or running
+the project, and follow it for the entire task.
+
+Repository workflows and policies under `.gemini/` are shared agent settings,
+not Gemini-only guidance. Read the relevant files before performing the
+corresponding operation. If an agent does not support the Gemini slash-command
+syntax, follow the command prompt manually:
+
+- `.gemini/commands/release/prepare.toml` defines release preparation.
+- `.gemini/commands/release/verify.toml` defines release verification.
+- `.gemini/policies/git-override.toml` records repository Git tool policy.
+
+Tool policies never override the user's request, the host's permissions, or
+higher-priority safety instructions.