codex-rule-maker 0.1.0__tar.gz → 0.2.0__tar.gz

{codex_rule_maker-0.1.0 → codex_rule_maker-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-rule-maker
-Version: 0.1.0
+Version: 0.2.0
 Summary: CLI tool that generates a .codex folder with AI developer rules and project reference documents.
 Author: codex-rule-maker
 Project-URL: Homepage, https://github.com/Sharon77770/codex_rule_maker
@@ -28,9 +28,7 @@ Requires-Dist: twine<7,>=5; extra == "dev"
 
 # codex-rule-maker
 
-`codex-rule-maker`는 프로젝트 루트에 `.codex` 폴더를 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 참고 문서 템플릿을 생성합니다.
-
-이 도구는 `output_ex/.codex` 예시의 철학을 참고했습니다. 예시를 그대로 복사하지 않고, 규칙 문서와 참고 문서를 분리한 범용 템플릿으로 일반화했습니다.
+`codex-rule-maker`는 프로젝트 루트에 `.codex` 규칙 폴더와 `docs/` 프로젝트 문서 템플릿을 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 문서 구조를 생성합니다.
 
 ## 설치
 
@@ -49,36 +47,7 @@ pip install -e .
 codex-init --help
 ```
 
-PyPI 배포 후에는 다음 명령으로 설치할 수 있습니다.
-
-```bash
-pip install codex-rule-maker
-codex-init --help
-```
-
-## PyPI 배포
-
-배포 전 패키지를 빌드하고 검사합니다.
-
-```bash
-pip install -e ".[dev]"
-python -m build
-python -m twine check dist/*
-```
-
-PyPI API token을 발급한 뒤 업로드합니다.
-
-```bash
-python -m twine upload dist/*
-```
-
-테스트 PyPI에 먼저 올리고 싶다면 다음 명령을 사용합니다.
-
-```bash
-python -m twine upload --repository testpypi dist/*
-```
-
-업로드가 끝나면 새 환경에서 설치를 확인합니다.
+PyPI 설치:
 
 ```bash
 pip install codex-rule-maker
@@ -168,10 +137,11 @@ codex-init --force --overwrite
 ## 예시 실행 흐름
 
 ```text
-프로젝트 이름 [sample]: pfm-lab
-프로젝트 설명: 자연어 기반 PFM 시뮬레이션 플랫폼
+프로젝트 이름 [sample]: 마리오
+프로젝트 설명: 2D 플렛포머 게임
 지원 프로필:
 - fastapi
+- python
 - springboot
 - react
 - nextjs
@@ -188,8 +158,8 @@ DB 종류 [mysql]: mysql
 
 생성 설정 확인
 
-프로젝트 이름: pfm-lab
-설명: 자연어 기반 PFM 시뮬레이션 플랫폼
+프로젝트 이름: 마리오
+설명: 2D 플랫포머 게임
 스택: fastapi,react
 DB: mysql
 인증: yes
@@ -216,33 +186,44 @@ DB: mysql
 | `--interactive` | 대화형 입력 사용 및 최종 확인 표시 | 비활성 |
 | `--force` | 기존 `.codex`가 있으면 백업 후 재생성 | 비활성 |
 | `--overwrite` | `--force`와 함께 기존 `.codex` 삭제 후 재생성 | 비활성 |
-| `--target-dir` | `.codex`를 생성할 대상 디렉토리 | 현재 디렉토리 |
+| `--target-dir` | `.codex`와 `docs/`를 생성할 대상 디렉토리 | 현재 디렉토리 |
 
 ## 생성 구조
 
 ```text
 .codex/
-├── AI_RULE_DEVELOPER/
+├── ai_rule_developer/
 │   ├── GLOBAL_RULES.md
 │   ├── ARCHITECTURE_RULES.md
 │   ├── CODE_STYLE_RULES.md
 │   ├── API_DESIGN_RULES.md
 │   ├── DOCUMENT_RULE.md
-│   ├── TEST_RULES.md
-│   └── FRAMEWORK_RULES.md
-├── REF_DOCS/
-│   ├── PROJECT_OVERVIEW.md
-│   ├── FEATURE_SPEC.md
-│   ├── API_SPEC.md
-│   └── DB_SPEC.md
+│   ├── DOMAIN_MODEL_RULES.md
+│   ├── EXTERNAL_INTEGRATION_RULES.md
+│   └── SERVICE_LAYER_RULES.md
+├── ref_docs/
 └── codex_start_prompt.txt
+
+docs/
+├── architecture/
+│   ├── directory.md
+│   ├── architecture.md
+│   ├── component.md
+│   ├── state.md
+│   └── flow.md
+├── api/
+│   ├── endpoints.md
+│   └── specification.md
+└── database/
+    └── schema.md
 ```
 
-`AI_RULE_DEVELOPER`는 코딩할 때 지켜야 하는 규칙입니다. `REF_DOCS`는 개발 시 참고할 프로젝트 명세입니다. `codex_start_prompt.txt`는 Codex가 작업 시작 전에 `.codex` 문서를 먼저 읽고 규칙 우선순위를 적용하도록 지시합니다.
+`ai_rule_developer`는 코딩할 때 지켜야 하는 규칙입니다. `ref_docs`는 외부 아키텍처 문서, PRD, 리서치, 벤더 문서처럼 사용자가 임의로 추가하는 참고자료 공간이므로 디렉토리만 생성합니다. 프로젝트 자체 명세는 루트 `docs/` 아래에 생성되며, 기존 `docs/` 파일이 있으면 덮어쓰지 않습니다. `codex_start_prompt.txt`는 Codex가 작업 시작 전에 `.codex` 문서를 먼저 읽고 규칙 우선순위를 적용하도록 지시합니다.
 
 ## 지원 프레임워크 프로필
 
 - `fastapi`: controller/service/repository/schema/entity 계층 분리
+- `python`: 일반 Python package/module/service/adapter/CLI 경계 분리
 - `springboot`: controller/service/repository/entity/dto 계층 분리
 - `react`: component/page/hook/service/store 분리
 - `nextjs`: App Router, Server Component와 Client Component 구분
@@ -253,6 +234,7 @@ DB: mysql
 
 ```bash
 codex-init --stack fastapi,react
+codex-init --stack python
 codex-init --stack fullstack-fastapi-react
 codex-init --stack nextjs
 ```
@@ -265,6 +247,7 @@ codex-init --stack nextjs
 - `--auth yes`는 인증/권한 규칙을 포함합니다.
 - `--external-api yes`는 외부 연동 계층 분리 규칙을 포함합니다.
 - `--db mysql`처럼 DB를 지정하면 DB, Repository, Schema 관련 규칙을 포함합니다.
+- 프로젝트 명세 템플릿은 `.codex/ref_docs`가 아니라 `docs/architecture`, `docs/api`, `docs/database`에 생성됩니다.
 
 ## 테스트
 
@@ -272,16 +255,3 @@ codex-init --stack nextjs
 pip install -e ".[dev]"
 pytest
 ```
-
-검증 범위:
-
-- 기본 생성 성공
-- 옵션만으로 생성 가능
-- 누락 값 prompt 보완
-- 잘못된 stack/docs/language 검증
-- FastAPI 프로필 생성
-- React 프로필 생성
-- Fullstack FastAPI React 프로필 생성
-- 기존 `.codex`가 있을 때 prompt 중단
-- `--force`가 있으면 기존 `.codex` 백업 후 재생성
-- `--force --overwrite`가 있으면 기존 `.codex` 삭제 후 재생성

{codex_rule_maker-0.1.0 → codex_rule_maker-0.2.0}/README.md

@@ -1,8 +1,6 @@
 # codex-rule-maker
 
-`codex-rule-maker`는 프로젝트 루트에 `.codex` 폴더를 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 참고 문서 템플릿을 생성합니다.
-
-이 도구는 `output_ex/.codex` 예시의 철학을 참고했습니다. 예시를 그대로 복사하지 않고, 규칙 문서와 참고 문서를 분리한 범용 템플릿으로 일반화했습니다.
+`codex-rule-maker`는 프로젝트 루트에 `.codex` 규칙 폴더와 `docs/` 프로젝트 문서 템플릿을 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 문서 구조를 생성합니다.
 
 ## 설치
 
@@ -21,36 +19,7 @@ pip install -e .
 codex-init --help
 ```
 
-PyPI 배포 후에는 다음 명령으로 설치할 수 있습니다.
-
-```bash
-pip install codex-rule-maker
-codex-init --help
-```
-
-## PyPI 배포
-
-배포 전 패키지를 빌드하고 검사합니다.
-
-```bash
-pip install -e ".[dev]"
-python -m build
-python -m twine check dist/*
-```
-
-PyPI API token을 발급한 뒤 업로드합니다.
-
-```bash
-python -m twine upload dist/*
-```
-
-테스트 PyPI에 먼저 올리고 싶다면 다음 명령을 사용합니다.
-
-```bash
-python -m twine upload --repository testpypi dist/*
-```
-
-업로드가 끝나면 새 환경에서 설치를 확인합니다.
+PyPI 설치:
 
 ```bash
 pip install codex-rule-maker
@@ -140,10 +109,11 @@ codex-init --force --overwrite
 ## 예시 실행 흐름
 
 ```text
-프로젝트 이름 [sample]: pfm-lab
-프로젝트 설명: 자연어 기반 PFM 시뮬레이션 플랫폼
+프로젝트 이름 [sample]: 마리오
+프로젝트 설명: 2D 플렛포머 게임
 지원 프로필:
 - fastapi
+- python
 - springboot
 - react
 - nextjs
@@ -160,8 +130,8 @@ DB 종류 [mysql]: mysql
 
 생성 설정 확인
 
-프로젝트 이름: pfm-lab
-설명: 자연어 기반 PFM 시뮬레이션 플랫폼
+프로젝트 이름: 마리오
+설명: 2D 플랫포머 게임
 스택: fastapi,react
 DB: mysql
 인증: yes
@@ -188,33 +158,44 @@ DB: mysql
 | `--interactive` | 대화형 입력 사용 및 최종 확인 표시 | 비활성 |
 | `--force` | 기존 `.codex`가 있으면 백업 후 재생성 | 비활성 |
 | `--overwrite` | `--force`와 함께 기존 `.codex` 삭제 후 재생성 | 비활성 |
-| `--target-dir` | `.codex`를 생성할 대상 디렉토리 | 현재 디렉토리 |
+| `--target-dir` | `.codex`와 `docs/`를 생성할 대상 디렉토리 | 현재 디렉토리 |
 
 ## 생성 구조
 
 ```text
 .codex/
-├── AI_RULE_DEVELOPER/
+├── ai_rule_developer/
 │   ├── GLOBAL_RULES.md
 │   ├── ARCHITECTURE_RULES.md
 │   ├── CODE_STYLE_RULES.md
 │   ├── API_DESIGN_RULES.md
 │   ├── DOCUMENT_RULE.md
-│   ├── TEST_RULES.md
-│   └── FRAMEWORK_RULES.md
-├── REF_DOCS/
-│   ├── PROJECT_OVERVIEW.md
-│   ├── FEATURE_SPEC.md
-│   ├── API_SPEC.md
-│   └── DB_SPEC.md
+│   ├── DOMAIN_MODEL_RULES.md
+│   ├── EXTERNAL_INTEGRATION_RULES.md
+│   └── SERVICE_LAYER_RULES.md
+├── ref_docs/
 └── codex_start_prompt.txt
+
+docs/
+├── architecture/
+│   ├── directory.md
+│   ├── architecture.md
+│   ├── component.md
+│   ├── state.md
+│   └── flow.md
+├── api/
+│   ├── endpoints.md
+│   └── specification.md
+└── database/
+    └── schema.md
 ```
 
-`AI_RULE_DEVELOPER`는 코딩할 때 지켜야 하는 규칙입니다. `REF_DOCS`는 개발 시 참고할 프로젝트 명세입니다. `codex_start_prompt.txt`는 Codex가 작업 시작 전에 `.codex` 문서를 먼저 읽고 규칙 우선순위를 적용하도록 지시합니다.
+`ai_rule_developer`는 코딩할 때 지켜야 하는 규칙입니다. `ref_docs`는 외부 아키텍처 문서, PRD, 리서치, 벤더 문서처럼 사용자가 임의로 추가하는 참고자료 공간이므로 디렉토리만 생성합니다. 프로젝트 자체 명세는 루트 `docs/` 아래에 생성되며, 기존 `docs/` 파일이 있으면 덮어쓰지 않습니다. `codex_start_prompt.txt`는 Codex가 작업 시작 전에 `.codex` 문서를 먼저 읽고 규칙 우선순위를 적용하도록 지시합니다.
 
 ## 지원 프레임워크 프로필
 
 - `fastapi`: controller/service/repository/schema/entity 계층 분리
+- `python`: 일반 Python package/module/service/adapter/CLI 경계 분리
 - `springboot`: controller/service/repository/entity/dto 계층 분리
 - `react`: component/page/hook/service/store 분리
 - `nextjs`: App Router, Server Component와 Client Component 구분
@@ -225,6 +206,7 @@ DB: mysql
 
 ```bash
 codex-init --stack fastapi,react
+codex-init --stack python
 codex-init --stack fullstack-fastapi-react
 codex-init --stack nextjs
 ```
@@ -237,6 +219,7 @@ codex-init --stack nextjs
 - `--auth yes`는 인증/권한 규칙을 포함합니다.
 - `--external-api yes`는 외부 연동 계층 분리 규칙을 포함합니다.
 - `--db mysql`처럼 DB를 지정하면 DB, Repository, Schema 관련 규칙을 포함합니다.
+- 프로젝트 명세 템플릿은 `.codex/ref_docs`가 아니라 `docs/architecture`, `docs/api`, `docs/database`에 생성됩니다.
 
 ## 테스트
 
@@ -244,16 +227,3 @@ codex-init --stack nextjs
 pip install -e ".[dev]"
 pytest
 ```
-
-검증 범위:
-
-- 기본 생성 성공
-- 옵션만으로 생성 가능
-- 누락 값 prompt 보완
-- 잘못된 stack/docs/language 검증
-- FastAPI 프로필 생성
-- React 프로필 생성
-- Fullstack FastAPI React 프로필 생성
-- 기존 `.codex`가 있을 때 prompt 중단
-- `--force`가 있으면 기존 `.codex` 백업 후 재생성
-- `--force --overwrite`가 있으면 기존 `.codex` 삭제 후 재생성

{codex_rule_maker-0.1.0 → codex_rule_maker-0.2.0}/codex_builder/builder.py

@@ -47,10 +47,15 @@ class CodexBuilder:
             backup_dir = self._replace_existing_codex(codex_dir, backup_existing=backup_existing)
 
         try:
+            for relative_dir in self._renderer.render_directories(config):
+                (root / relative_dir).mkdir(parents=True, exist_ok=True)
+
             written_files: list[Path] = []
             for relative_path, content in rendered_files.items():
                 destination = root / relative_path
                 destination.parent.mkdir(parents=True, exist_ok=True)
+                if destination.exists() and relative_path.parts[0] != CODEX_DIR_NAME:
+                    continue
                 destination.write_text(content.rstrip() + "\n", encoding="utf-8")
                 written_files.append(destination)
         except OSError as exc:

{codex_rule_maker-0.1.0 → codex_rule_maker-0.2.0}/codex_builder/constants.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 CODEX_DIR_NAME = ".codex"
-AI_RULE_DIR_NAME = "AI_RULE_DEVELOPER"
-REF_DOCS_DIR_NAME = "REF_DOCS"
+AI_RULE_DIR_NAME = "ai_rule_developer"
+REF_DOCS_DIR_NAME = "ref_docs"
+DOCS_DIR_NAME = "docs"
 START_PROMPT_FILE_NAME = "codex_start_prompt.txt"
 
 RULE_FILE_NAMES = (
@@ -13,15 +14,20 @@ RULE_FILE_NAMES = (
     "CODE_STYLE_RULES.md",
     "API_DESIGN_RULES.md",
     "DOCUMENT_RULE.md",
-    "TEST_RULES.md",
-    "FRAMEWORK_RULES.md",
+    "DOMAIN_MODEL_RULES.md",
+    "EXTERNAL_INTEGRATION_RULES.md",
+    "SERVICE_LAYER_RULES.md",
 )
 
-REF_DOC_FILE_NAMES = (
-    "PROJECT_OVERVIEW.md",
-    "FEATURE_SPEC.md",
-    "API_SPEC.md",
-    "DB_SPEC.md",
+DOC_FILE_NAMES = (
+    "architecture/directory.md",
+    "architecture/architecture.md",
+    "architecture/component.md",
+    "architecture/state.md",
+    "architecture/flow.md",
+    "api/endpoints.md",
+    "api/specification.md",
+    "database/schema.md",
 )
 
 DEFAULT_LANGUAGE = "ko"

{codex_rule_maker-0.1.0 → codex_rule_maker-0.2.0}/codex_builder/profiles.py

@@ -43,6 +43,63 @@ class FrameworkProfile:
         return self.test_rules_en if language == "en" else self.test_rules_ko
 
 
+PYTHON_PROFILE = FrameworkProfile(
+    key="python",
+    display_name="Python",
+    philosophy_ko="일반 Python 프로젝트는 프레임워크 전제 없이 package/module, service, adapter, CLI 경계를 명확히 분리한다.",
+    philosophy_en="General Python projects should separate package/module, service, adapter, and CLI boundaries without assuming a framework.",
+    architecture_ko=(
+        "패키지는 기능 또는 도메인 책임 기준으로 나누고 임시 script 모음처럼 방치하지 않는다.",
+        "CLI 또는 실행 진입점은 입력 파싱과 출력 변환만 담당하고 실제 판단은 service/application 계층에 위임한다.",
+        "핵심 도메인 함수와 클래스는 파일 시스템, 네트워크, 환경 변수, process args에 직접 의존하지 않게 한다.",
+        "파일, DB, 외부 API, subprocess 연동은 adapter 또는 infrastructure 모듈 뒤에 둔다.",
+        "권장 흐름: Entrypoint/CLI -> Application Service -> Domain/Adapter -> External System.",
+    ),
+    architecture_en=(
+        "Split packages by feature or domain responsibility instead of leaving them as loose script collections.",
+        "CLI or runtime entrypoints should only parse input and map output, then delegate decisions to service/application layers.",
+        "Keep core domain functions and classes independent from filesystem, network, environment variables, and process args.",
+        "Put filesystem, database, external API, and subprocess integrations behind adapter or infrastructure modules.",
+        "Recommended flow: Entrypoint/CLI -> Application Service -> Domain/Adapter -> External System.",
+    ),
+    framework_rules_ko=(
+        "import 시점에 파일 생성, 네트워크 호출, 프로세스 실행 같은 부수효과가 발생하지 않게 한다.",
+        "실행 가능한 모듈은 `main()` 진입점을 제공하고 직접 실행 코드는 `if __name__ == \"__main__\"` 아래에 둔다.",
+        "표준 라이브러리로 충분한 문제에 불필요한 dependency를 추가하지 않는다.",
+        "공개 함수와 클래스에는 의미 있는 타입 힌트를 유지하고, 입력/출력 모델은 명확한 자료 구조로 표현한다.",
+        "순수 계산 로직과 I/O 로직을 분리해 테스트와 재사용이 가능하게 한다.",
+    ),
+    framework_rules_en=(
+        "Avoid import-time side effects such as file creation, network calls, or process execution.",
+        "Runnable modules should expose a `main()` entrypoint and keep direct execution under `if __name__ == \"__main__\"`.",
+        "Do not add dependencies when the standard library is enough for the problem.",
+        "Keep meaningful type hints on public functions and classes, and represent input/output models with explicit data structures.",
+        "Separate pure computation from I/O so logic stays testable and reusable.",
+    ),
+    api_rules_ko=(
+        "공개 함수, 클래스, CLI 옵션은 외부 계약으로 보고 이름과 반환 형식을 안정적으로 관리한다.",
+        "외부 입력은 진입점에서 검증하고 내부 모델로 변환한 뒤 service 계층에 전달한다.",
+        "예외는 호출자가 처리할 수 있는 명확한 타입 또는 메시지로 표현한다.",
+    ),
+    api_rules_en=(
+        "Treat public functions, classes, and CLI options as external contracts with stable names and return shapes.",
+        "Validate external input at the entrypoint and convert it into internal models before passing it to services.",
+        "Represent errors with clear exception types or messages that callers can handle.",
+    ),
+    test_rules_ko=(
+        "순수 로직 테스트와 파일/네트워크/환경 변수 I/O 테스트를 분리한다.",
+        "`tmp_path`, monkeypatch, test double을 사용해 파일 시스템과 외부 의존성을 격리한다.",
+        "CLI 인자, 설정 파싱, 오류 경로는 회귀 테스트로 고정한다.",
+    ),
+    test_rules_en=(
+        "Separate tests for pure logic from tests that cover filesystem, network, or environment I/O.",
+        "Use `tmp_path`, monkeypatching, and test doubles to isolate filesystem and external dependencies.",
+        "Lock down CLI arguments, configuration parsing, and error paths with regression tests.",
+    ),
+    directories=("src/<package_name>", "src/<package_name>/services", "src/<package_name>/adapters", "tests", "scripts"),
+)
+
+
 FASTAPI_PROFILE = FrameworkProfile(
     key="fastapi",
     display_name="FastAPI",
@@ -325,50 +382,50 @@ FULLSTACK_FASTAPI_REACT_PROFILE = FrameworkProfile(
     architecture_ko=(
         "backend는 Controller -> Service -> Repository -> DB 흐름을 따른다.",
         "frontend는 Page -> Hook/Store -> Service -> API 흐름을 따른다.",
-        "API_SPEC.md는 백엔드 response schema와 프론트엔드 service 타입의 공통 계약이다.",
+        "docs/api/specification.md는 백엔드 response schema와 프론트엔드 service 타입의 공통 계약이다.",
         "백엔드 Entity를 프론트엔드 타입으로 직접 취급하지 않는다.",
         "인증, 오류, pagination, enum 값은 양쪽 구현과 문서를 함께 갱신한다.",
     ),
     architecture_en=(
         "Backend follows Controller -> Service -> Repository -> DB.",
         "Frontend follows Page -> Hook/Store -> Service -> API.",
-        "API_SPEC.md is the shared contract between backend response schemas and frontend service types.",
+        "docs/api/specification.md is the shared contract between backend response schemas and frontend service types.",
         "Do not treat backend entities as frontend types directly.",
         "Update auth, errors, pagination, and enum values in both implementations and docs.",
     ),
     framework_rules_ko=(
         "backend와 frontend 디렉토리 경계를 분명히 유지한다.",
-        "API 변경은 backend schema, frontend service/type, REF_DOCS/API_SPEC.md를 함께 수정한다.",
+        "API 변경은 backend schema, frontend service/type, docs/api/specification.md를 함께 수정한다.",
         "React 컴포넌트는 백엔드 엔드포인트를 직접 호출하지 않고 service 계층을 통한다.",
         "FastAPI service는 프론트엔드 화면 구조를 알지 못해야 한다.",
         "CORS, 인증 토큰, 오류 응답 형식은 공통 정책으로 문서화한다.",
     ),
     framework_rules_en=(
         "Keep backend and frontend directory boundaries clear.",
-        "API changes must update backend schemas, frontend services/types, and REF_DOCS/API_SPEC.md together.",
+        "API changes must update backend schemas, frontend services/types, and docs/api/specification.md together.",
         "React components call backend endpoints through the service layer, not directly.",
         "FastAPI services must not know frontend screen structure.",
         "Document CORS, auth tokens, and error response format as shared policies.",
     ),
     api_rules_ko=(
-        "OpenAPI 또는 명시적 API_SPEC.md를 기준 계약으로 유지한다.",
+        "OpenAPI 또는 명시적 docs/api/specification.md를 기준 계약으로 유지한다.",
         "Request/Response 필드명은 백엔드와 프론트엔드에서 동일하게 관리한다.",
         "인증이 필요한 API는 권한 요구사항과 실패 응답을 반드시 문서화한다.",
     ),
     api_rules_en=(
-        "Keep OpenAPI or explicit API_SPEC.md as the source contract.",
+        "Keep OpenAPI or explicit docs/api/specification.md as the source contract.",
         "Maintain identical request/response field names across backend and frontend.",
         "Document authorization requirements and failure responses for protected APIs.",
     ),
     test_rules_ko=(
         "백엔드 API 테스트와 프론트엔드 service 테스트가 같은 계약을 검증하게 한다.",
         "주요 사용자 흐름은 E2E 또는 통합 테스트 대상으로 둔다.",
-        "API mock은 실제 API_SPEC.md와 불일치하지 않게 관리한다.",
+        "API mock은 실제 docs/api/specification.md와 불일치하지 않게 관리한다.",
     ),
     test_rules_en=(
         "Backend API tests and frontend service tests should verify the same contract.",
         "Cover major user flows with E2E or integration tests.",
-        "Keep API mocks aligned with API_SPEC.md.",
+        "Keep API mocks aligned with docs/api/specification.md.",
     ),
     directories=("backend/app/controllers", "backend/app/services", "backend/app/repositories", "frontend/src/pages", "frontend/src/components", "frontend/src/services", "frontend/src/stores"),
 )
@@ -377,6 +434,7 @@ PROFILES: dict[str, FrameworkProfile] = {
     profile.key: profile
     for profile in (
         FASTAPI_PROFILE,
+        PYTHON_PROFILE,
         SPRINGBOOT_PROFILE,
         REACT_PROFILE,
         NEXTJS_PROFILE,
@@ -386,6 +444,11 @@ PROFILES: dict[str, FrameworkProfile] = {
 }
 
 PROFILE_ALIASES: dict[str, str] = {
+    "py": "python",
+    "python3": "python",
+    "plain-python": "python",
+    "vanilla-python": "python",
+    "general-python": "python",
     "fast-api": "fastapi",
     "spring": "springboot",
     "spring-boot": "springboot",