chore(tooling): establish testing and project guidance #2

Merged

viacheslavshuka merged 2 commits from chore/testing-and-agent-guidance into main

2026-10-29 20:40:25 +00:00

viacheslavshuka commented

2026-10-29 20:37:51 +00:00

Owner

Establish shared project guidance and a reusable testing skill so agents follow explicit rules for useful assertions, test isolation, Python maintenance, and API contracts. CLAUDE.md links to AGENTS.md so both entry points use the same guidance.

The testing skill keeps its core rules concise and loads focused references for pytest, Hypothesis, async API and PostgreSQL tests, coverage, and mutation testing. The API guidance requires OpenAPI declarations that match runtime behavior and support Schemathesis and generated TypeScript.

Add pytest-asyncio, HTTPX, Testcontainers with PostgreSQL support, and Schemathesis as development dependencies. Configure strict asyncio mode with function-scoped loops. Use compatible-release constraints consistently and add uv.lock for reproducible installation. The changes affect contributor guidance and development tooling.

Validation

Skill structure validation and the documentation wording check passed.
Local documentation links and git diff --check passed.
uv lock --check --offline passed.
The extracted Hypothesis example and temporary tooling smoke checks passed all 13 cases. The smoke checks covered async HTTPX requests through ASGI, Schemathesis response validation, and the current Testcontainers import.

Review guidance

Read AGENTS.md and .agents/skills/testing/SKILL.md first, then the references relevant to their rules. The second commit contains the dependency and asyncio configuration changes, including the generated lockfile.

Establish shared project guidance and a reusable testing skill so agents follow explicit rules for useful assertions, test isolation, Python maintenance, and API contracts. `CLAUDE.md` links to `AGENTS.md` so both entry points use the same guidance. The testing skill keeps its core rules concise and loads focused references for pytest, Hypothesis, async API and PostgreSQL tests, coverage, and mutation testing. The API guidance requires OpenAPI declarations that match runtime behavior and support Schemathesis and generated TypeScript. Add pytest-asyncio, HTTPX, Testcontainers with PostgreSQL support, and Schemathesis as development dependencies. Configure strict asyncio mode with function-scoped loops. Use compatible-release constraints consistently and add `uv.lock` for reproducible installation. The changes affect contributor guidance and development tooling. ## Validation - Skill structure validation and the documentation wording check passed. - Local documentation links and `git diff --check` passed. - `uv lock --check --offline` passed. - The extracted Hypothesis example and temporary tooling smoke checks passed all 13 cases. The smoke checks covered async HTTPX requests through ASGI, Schemathesis response validation, and the current Testcontainers import. ## Review guidance Read `AGENTS.md` and `.agents/skills/testing/SKILL.md` first, then the references relevant to their rules. The second commit contains the dependency and asyncio configuration changes, including the generated lockfile.

viacheslavshuka added 2 commits

2026-10-29 20:37:51 +00:00

docs: define project guidance and testing practices 3fe3eee789

build(testing): add async API and PostgreSQL testing tools be6284024d

viacheslavshuka added the

kind

chore

area/tooling

labels

2026-10-29 20:38:19 +00:00

viacheslavshuka merged commit 1016bb5dc4 into main

2026-10-29 20:40:25 +00:00