Skip to content

chore: 🔧 root-level AGENTS.md, Python 3.11 support and prek - #33

Merged
Panadestein merged 4 commits into
mainfrom
docs/agents-md
Sep 3, 2026
Merged

chore: 🔧 root-level AGENTS.md, Python 3.11 support and prek#33
Panadestein merged 4 commits into
mainfrom
docs/agents-md

Conversation

@Panadestein

@Panadestein Panadestein commented Sep 3, 2026

Copy link
Copy Markdown
Member

🤖 AI text below 🤖

Closes #26.

Agent guide

The guide only lived in .github/copilot-instructions.md, so harnesses that look for AGENTS.md found nothing.

  • AGENTS.md at the root is now the single source; .github/copilot-instructions.md -> ../AGENTS.md and CLAUDE.md -> AGENTS.md are symlinks, as in monoprop.
  • Content rewritten around this repository (backend dispatch, purity, filterwarnings = ["error"], markers, quimb layouts, commit conventions) instead of generic Python advice.

Python 3.11

Restored as the floor, since it is still required across the company: requires-python, the ruff target-version, the pyright pythonVersion, sonar.python.version and the CI matrix. No 3.12-only syntax was in use, and the fast suite passes on both 3.11 and 3.14.

prek

pre-commit -> prek: prek.toml replaces .pre-commit-config.yaml (built-in hooks where available, ruff-check instead of the legacy ruff alias), lint.yml uses j178/prek-action, and the ruff bump in update-ruff.yml was rewritten for the TOML syntax. Docs and the dev container script follow.

Existing clones need prek install --force --prepare-hooks once, to drop the stale pre-commit shim; noted in CONTRIBUTING.md.

uv run prek run --all-files passes.

Symlink .github/copilot-instructions.md and CLAUDE.md to it so every
harness picks up the same guide, and rewrite the content around this
repository instead of generic Python advice.

Closes #26

Assisted-by: copilot-cli:claude-opus-5
Naming conventions and the reason N803/N806 are off, a pointer to the
developer guide, and the reminder that a skipped lint is a red PR.

Assisted-by: copilot-cli:claude-opus-5
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Test Results

  4 files  ±0    4 suites  ±0   1m 46s ⏱️ -11s
 37 tests ±0   36 ✅ ±0  1 💤 ±0  0 ❌ ±0 
128 runs  ±0  126 ✅ ±0  2 💤 ±0  0 ❌ ±0 

Results for commit 744a91b. ± Comparison against base commit 9dad224.

♻️ This comment has been updated with latest results.

Comment thread .github/copilot-instructions.md
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
3.11 is still required across the company, so lower requires-python, the
ruff and pyright targets, the sonar version list and the CI matrix floor
back to it. The test suite passes unchanged; no 3.12-only syntax was in
use.

Replace pre-commit with prek: prek.toml instead of
.pre-commit-config.yaml, j178/prek-action in lint.yml, and the ruff bump
in update-ruff.yml rewritten for the TOML syntax.

Assisted-by: copilot-cli:claude-opus-5
@Panadestein Panadestein changed the title docs: 📝 move agent guide to a root-level AGENTS.md chore: 🔧 root-level AGENTS.md, Python 3.11 support and prek Sep 3, 2026
robertodr
robertodr previously approved these changes Sep 3, 2026
@robertodr
robertodr enabled auto-merge (squash) September 3, 2026 08:04
The ruleset requires the "Test src_method" context, but the matrix only
reports per-combination names, so the check stayed pending forever and
blocked every merge. Aggregate the matrix in a job carrying that name.

Assisted-by: copilot-cli:claude-opus-5
@sonarqubecloud

sonarqubecloud Bot commented Sep 3, 2026

Copy link
Copy Markdown

@Panadestein
Panadestein disabled auto-merge September 3, 2026 08:53
@Panadestein
Panadestein merged commit a527582 into main Sep 3, 2026
12 checks passed
@Panadestein
Panadestein deleted the docs/agents-md branch September 3, 2026 08:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add root-level AGENTS.md symlinked to .github/copilot-instructions.md

2 participants