Python CLI AGENTS.md 만들기
Python CLI 프로젝트는 패키징, 검증 명령, 안전한 자동화 동작을 충분히 설명하지 못한 채 모호한 저장소 지침으로 끝나는 경우가 많습니다.
이 프리셋은 생성 결과를 구체적이고 타입 친화적으로 유지하면서, 현대적인 `uv` 워크플로에도 잘 맞게 조정되어 있습니다.
작지만 핵심적인 AGENTS.md로 명령 정확성과 로컬 전용 동작을 지키고 싶을 때 적합합니다.
대표 명령
- 설치:
uv sync - 개발:
uv run python -m your_package - 린트:
uv run ruff check . - 타입체크:
uv run pyright - 빌드:
uv run python -m build - 테스트:
uv run pytest
대표 금지 사항
- 웹 백엔드, auth, hosted sync 기능을 추가하지 않습니다.
- 핵심 흐름에 숨겨진 네트워크 접근을 넣지 않습니다.
- 결정적 builder를 AI 생성으로 대체하지 않습니다.
왜 이 프리셋에는 맞춤 가이드가 필요한가
Python CLI 저장소는 범용 앱 플랫폼 규칙보다 명령, 패키징, subprocess 안전성에 대한 또렷한 가이드가 더 효과적입니다.