generated from john/python-template
23 lines
1.4 KiB
Markdown
23 lines
1.4 KiB
Markdown
---
|
|
name: Review Python Architecture
|
|
description: Run an evidence-based architectural code review using the Python Architect Reviewer agent and python-code-reviewer skill.
|
|
agent: 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. |