transcription/.github/prompts/review-python-architecture.prompt.md

name, description, agent

name	description	agent
Review Python Architecture	Run an evidence-based architectural code review using the Python Architect Reviewer agent and python-code-reviewer skill.	Python Architect Reviewer

Instructions

Execute a comprehensive, evidence-based code review of the target codebase.

Target Scope

• Review Target: the repository root, unless the invoker names a narrower path; review that path instead.
• Source Root: src/
• Docs Root: docs/
• Focus Areas: FastAPI endpoints, NiceGUI components, SQLModel persistence, asyncio workers, Pydantic V2 models, and OpenRouter provider adapters.

Execution Rules

1. Map repository layout, dependency manifests, and configuration files from the project root before inspecting modules.
2. Read real code modules under src/ (or the specified target path); cite exact file paths and line ranges for every finding.
3. Validate issues by running uv run ruff check ., uv run ty check, and uv run pytest -q -m "not external". Nothing is on PATH in this uv project, so bare ruff/ty/pytest will fail.
4. Check for duplication, divergent implementations, and extractable helpers.
5. Format the entire review following the standardized 10-section template defined in the python-code-reviewer skill.
6. Write the final report to ./docs/reviews/<YYYY-MM-DD>-code-review.md, using today's date. This path is defined by the skill; do not write the report anywhere else.