From ab53c239bff99f8d9486ae8270fafa62ee093e3b Mon Sep 17 00:00:00 2001 From: John Lancaster <32917998+jsl12@users.noreply.github.com> Date: Sun, 21 Jun 2026 22:55:58 -0500 Subject: [PATCH] rename --- ...lding.instructions.md => pytesting.instructions.md} | 8 +++++--- .github/instructions/zensical-docs.instructions.md | 4 ++++ .github/prompts/plan-step1.prompt.md | 2 +- docs/architecture.md | 2 +- docs/contracts/skill_contract.md | 2 +- docs/mcp_layout.md | 2 +- docs/prompts/fill-pytest-scaffold/PROMPT.md | 10 +++++----- docs/skills/{pytest-scaffolding => pytesting}/SKILL.md | 6 +++--- .../references/asyncio-testing.md | 0 .../references/fastapi-testing.md | 0 .../references/naming-and-organization.md | 0 .../references/pytest-docs.md | 0 .../references/sqlalchemy-testing.md | 0 docs/testing.md | 4 ++-- tests/registry/models/test_skill_tag_conventions.py | 2 +- tests/web/test_mcp_skills.py | 8 ++++---- zensical.toml | 6 +++--- 17 files changed, 31 insertions(+), 25 deletions(-) rename .github/instructions/{pytest-scaffolding.instructions.md => pytesting.instructions.md} (58%) rename docs/skills/{pytest-scaffolding => pytesting}/SKILL.md (98%) rename docs/skills/{pytest-scaffolding => pytesting}/references/asyncio-testing.md (100%) rename docs/skills/{pytest-scaffolding => pytesting}/references/fastapi-testing.md (100%) rename docs/skills/{pytest-scaffolding => pytesting}/references/naming-and-organization.md (100%) rename docs/skills/{pytest-scaffolding => pytesting}/references/pytest-docs.md (100%) rename docs/skills/{pytest-scaffolding => pytesting}/references/sqlalchemy-testing.md (100%) diff --git a/.github/instructions/pytest-scaffolding.instructions.md b/.github/instructions/pytesting.instructions.md similarity index 58% rename from .github/instructions/pytest-scaffolding.instructions.md rename to .github/instructions/pytesting.instructions.md index b81461b..4cb38d4 100644 --- a/.github/instructions/pytest-scaffolding.instructions.md +++ b/.github/instructions/pytesting.instructions.md @@ -1,16 +1,18 @@ --- name: Pytest Scaffolding Guidance -description: Route tests edits to the Personal MCP pytest-scaffolding resource. +description: Route tests edits to the Personal MCP pytesting resource. applyTo: 'tests/**' --- -When editing files under `tests/`, use `resource://skills/pytest-scaffolding/document` as the primary guidance source for test scaffolding and pytest authoring decisions. +When editing files under `tests/`, use `resource://skills/pytesting/document` as the primary guidance source for test scaffolding and pytest authoring decisions. Execution pattern: -1. Load `resource://skills/pytest-scaffolding/document` first. +1. Load `resource://skills/pytesting/document` first. 2. Apply only the portions relevant to the file being edited. 3. Keep tests focused, deterministic, and aligned with repository conventions. 4. Include source-document links for any feature-level recommendation. If task intent is ambiguous, ask one clarifying question before editing. + +Be sure to also refer to the [testing page](../../docs/testing.md) page for design detail diff --git a/.github/instructions/zensical-docs.instructions.md b/.github/instructions/zensical-docs.instructions.md index f74e173..1ba1fa4 100644 --- a/.github/instructions/zensical-docs.instructions.md +++ b/.github/instructions/zensical-docs.instructions.md @@ -7,3 +7,7 @@ applyTo: '**/*.md' When editing Markdown files in this repository, use the Zensical docs resource `resource://skills/zensical-docs/document` for relevant documentation authoring guidance. Prefer Zensical-native documentation conventions when they cover the need cleanly, while preserving expected MkDocs compatibility unless the Zensical guidance intentionally diverges. + +Always check to make sure the entries in `/home/john/Documents/prompts/zensical.toml` are up to date with any changes. + +Also ensure that top-level pages specify icons in their front matter diff --git a/.github/prompts/plan-step1.prompt.md b/.github/prompts/plan-step1.prompt.md index 202efb1..6efe885 100644 --- a/.github/prompts/plan-step1.prompt.md +++ b/.github/prompts/plan-step1.prompt.md @@ -61,7 +61,7 @@ Example valid ids: - `fastapi-uv-docker` - `zensical-docs` -- `pytest-scaffolding` +- `pytesting` Example invalid ids: diff --git a/docs/architecture.md b/docs/architecture.md index e1c3a8d..74f7f33 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -252,7 +252,7 @@ Allowed exception: Existing markdown reference sets are valid examples of authored source material for this architecture: -1. docs/skills/pytest-scaffolding/references/pytest-docs.md +1. docs/skills/pytesting/references/pytest-docs.md 2. docs/skills/python-logging-dictconfig/references/python-logging-docs.md 3. docs/skills/fastapi-uv-docker/references/fastapi-best-practices.md diff --git a/docs/contracts/skill_contract.md b/docs/contracts/skill_contract.md index e883145..28d81fd 100644 --- a/docs/contracts/skill_contract.md +++ b/docs/contracts/skill_contract.md @@ -60,7 +60,7 @@ Valid examples: 1. `fastapi-uv-docker` 2. `zensical-docs` -3. `pytest-scaffolding` +3. `pytesting` Invalid examples: diff --git a/docs/mcp_layout.md b/docs/mcp_layout.md index 2f8ffff..8958372 100644 --- a/docs/mcp_layout.md +++ b/docs/mcp_layout.md @@ -193,7 +193,7 @@ This keeps docs publication explicit and predictable. Existing reference docs remain valid content inputs in this pattern: -1. docs/skills/pytest-scaffolding/references/pytest-docs.md +1. docs/skills/pytesting/references/pytest-docs.md 2. docs/skills/python-logging-dictconfig/references/python-logging-docs.md 3. docs/skills/fastapi-uv-docker/references/fastapi-best-practices.md diff --git a/docs/prompts/fill-pytest-scaffold/PROMPT.md b/docs/prompts/fill-pytest-scaffold/PROMPT.md index c9b5dc8..12568c2 100644 --- a/docs/prompts/fill-pytest-scaffold/PROMPT.md +++ b/docs/prompts/fill-pytest-scaffold/PROMPT.md @@ -47,11 +47,11 @@ Use this prompt after test scaffolding exists and method names/docstrings are al Load these in order and use only what matches the task: -1. Core defaults: [pytest scaffolding skill](../../skills/pytest-scaffolding/SKILL.md) -2. Naming/hierarchy preservation: [naming and organization](../../skills/pytest-scaffolding/references/naming-and-organization.md) -3. Baseline pytest fixtures/markers: [pytest docs notes](../../skills/pytest-scaffolding/references/pytest-docs.md) -4. FastAPI-specific behavior (only when needed): [fastapi testing](../../skills/pytest-scaffolding/references/fastapi-testing.md) -5. SQLAlchemy-specific behavior (only when needed): [sqlalchemy testing](../../skills/pytest-scaffolding/references/sqlalchemy-testing.md) +1. Core defaults: [pytest scaffolding skill](../../skills/pytesting/SKILL.md) +2. Naming/hierarchy preservation: [naming and organization](../../skills/pytesting/references/naming-and-organization.md) +3. Baseline pytest fixtures/markers: [pytest docs notes](../../skills/pytesting/references/pytest-docs.md) +4. FastAPI-specific behavior (only when needed): [fastapi testing](../../skills/pytesting/references/fastapi-testing.md) +5. SQLAlchemy-specific behavior (only when needed): [sqlalchemy testing](../../skills/pytesting/references/sqlalchemy-testing.md) ## Workflow diff --git a/docs/skills/pytest-scaffolding/SKILL.md b/docs/skills/pytesting/SKILL.md similarity index 98% rename from docs/skills/pytest-scaffolding/SKILL.md rename to docs/skills/pytesting/SKILL.md index 375cfb0..3ab56ba 100644 --- a/docs/skills/pytest-scaffolding/SKILL.md +++ b/docs/skills/pytesting/SKILL.md @@ -1,8 +1,8 @@ --- -name: pytest-scaffolding +name: pytesting description: "Reference hub for pytest suite structure, naming, markers, and stack-specific testing patterns. Optimized for progressive discovery so naming and hierarchy guidance are loaded first when shaping or reorganizing tests." x-personal-mcp: - id: pytest-scaffolding + id: pytesting version: 1.0.0 tags: - pytest @@ -13,7 +13,7 @@ x-personal-mcp: - anyio - deterministic capabilities: - - resource://skills/pytest-scaffolding/document + - resource://skills/pytesting/document --- # Pytest Scaffolding diff --git a/docs/skills/pytest-scaffolding/references/asyncio-testing.md b/docs/skills/pytesting/references/asyncio-testing.md similarity index 100% rename from docs/skills/pytest-scaffolding/references/asyncio-testing.md rename to docs/skills/pytesting/references/asyncio-testing.md diff --git a/docs/skills/pytest-scaffolding/references/fastapi-testing.md b/docs/skills/pytesting/references/fastapi-testing.md similarity index 100% rename from docs/skills/pytest-scaffolding/references/fastapi-testing.md rename to docs/skills/pytesting/references/fastapi-testing.md diff --git a/docs/skills/pytest-scaffolding/references/naming-and-organization.md b/docs/skills/pytesting/references/naming-and-organization.md similarity index 100% rename from docs/skills/pytest-scaffolding/references/naming-and-organization.md rename to docs/skills/pytesting/references/naming-and-organization.md diff --git a/docs/skills/pytest-scaffolding/references/pytest-docs.md b/docs/skills/pytesting/references/pytest-docs.md similarity index 100% rename from docs/skills/pytest-scaffolding/references/pytest-docs.md rename to docs/skills/pytesting/references/pytest-docs.md diff --git a/docs/skills/pytest-scaffolding/references/sqlalchemy-testing.md b/docs/skills/pytesting/references/sqlalchemy-testing.md similarity index 100% rename from docs/skills/pytest-scaffolding/references/sqlalchemy-testing.md rename to docs/skills/pytesting/references/sqlalchemy-testing.md diff --git a/docs/testing.md b/docs/testing.md index 1177b78..050396e 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -7,8 +7,8 @@ icon: lucide/flask-conical This page describes the current test layout and execution model for this repository. Primary guidance sources: -- [Pytest scaffolding skill](./skills/pytest-scaffolding/SKILL.md) -- [Pytest docs reference](./skills/pytest-scaffolding/references/pytest-docs.md) +- [Pytest scaffolding skill](./skills/pytesting/SKILL.md) +- [Pytest docs reference](./skills/pytesting/references/pytest-docs.md) - [FastAPI + uv + Docker skill](./skills/fastapi-uv-docker/SKILL.md) ## Goals diff --git a/tests/registry/models/test_skill_tag_conventions.py b/tests/registry/models/test_skill_tag_conventions.py index 8659522..b2bbde4 100644 --- a/tests/registry/models/test_skill_tag_conventions.py +++ b/tests/registry/models/test_skill_tag_conventions.py @@ -21,7 +21,7 @@ REQUIRED_LIBRARY_TAGS_BY_SKILL = { "new-skill": {"mcp", "fastmcp"}, "nicegui": {"nicegui", "fastapi"}, "nicegui-ui-customization": {"nicegui", "fastapi"}, - "pytest-scaffolding": {"pytest", "testing", "fastapi", "asyncio", "anyio"}, + "pytesting": {"pytest", "testing", "fastapi", "asyncio", "anyio"}, "python-logging-dictconfig": {"python", "logging"}, "python-typing": {"python", "typing"}, "ruff-linting-formating": {"ruff", "python"}, diff --git a/tests/web/test_mcp_skills.py b/tests/web/test_mcp_skills.py index 4f608b7..08a2ee0 100644 --- a/tests/web/test_mcp_skills.py +++ b/tests/web/test_mcp_skills.py @@ -33,22 +33,22 @@ TOOL_NAME_PARAMETERS = tuple( SEARCH_QUERY_PARAMETERS = ( pytest.param( "pytest", - {"pytest-scaffolding"}, + {"pytesting"}, id="query-pytest", ), pytest.param( "asyncio", - {"pytest-scaffolding", "fastapi-async-sqlalchemy-modernization"}, + {"pytesting", "fastapi-async-sqlalchemy-modernization"}, id="query-asyncio", ), pytest.param( "fastapi testing", - {"pytest-scaffolding"}, + {"pytesting"}, id="query-fastapi-testing", ), pytest.param( "asyncio fastapi testing deterministic pytest", - {"pytest-scaffolding"}, + {"pytesting"}, id="query-composite-async-fastapi-testing-deterministic-pytest", ), ) diff --git a/zensical.toml b/zensical.toml index d13b6a4..ecb4241 100644 --- a/zensical.toml +++ b/zensical.toml @@ -108,9 +108,9 @@ nav = [ { "Quality" = "skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md" }, ] }, { "Pytest" = [ - { "Overview" = "skills/pytest-scaffolding/SKILL.md" }, - { "Docs" = "skills/pytest-scaffolding/references/pytest-docs.md" }, - { "AsyncIO" = "skills/pytest-scaffolding/references/asyncio-testing.md" }, + { "Overview" = "skills/pytesting/SKILL.md" }, + { "Docs" = "skills/pytesting/references/pytest-docs.md" }, + { "AsyncIO" = "skills/pytesting/references/asyncio-testing.md" }, ] }, { "MCP Details" = [ { "Overview" = "skills/mcp-details/SKILL.md" },