refactor: update project structure and naming conventions for casts, replace agent references with cast terminology, and configure environment settings

Author: qjrm1430

.env.example

@@ -4,8 +4,8 @@
 
 # Langsmith Project Tracking
 # LangSmith is a tool for monitoring and debugging 
-LANGSMITH_PROJECT=pseudo-entertainment-company  # Project name to be used by LangSmith.
-LANGSMITH_API_KEY=lsv2....  # LangSmith API key (must be replaced with real key)
+LANGSMITH_PROJECT=act...  # Project name to be used by LangSmith.
+LANGSMITH_API_KEY=lsv2...  # LangSmith API key (must be replaced with real key)
 
 # Depending on the configuration you choose, you will need the following environment variables.
 

.github/ISSUE_TEMPLATE/backlog.md

@@ -1,11 +1,12 @@
 ---
 name: Backlog
 about: 백로그 산정/추가 시 사용
-title: "[#Team Name] Feature Name"
+title: "[#Crew Name] Feature Name"
 labels: enhancement
 assignees: ''
 
 ---
+
 <!--
 해당 백로그에 대한 브랜치를 만들어주세요.
 백로그 이름은 "feat/[해당 기능에 대한 이름]"으로 만들어주세요.
@@ -25,4 +26,4 @@ assignees: ''
 완료된 사항은 꼭 체크해놓기
 <!--* "최소" 기능을 기준으로 백로그를 구분하기
 * 기능을 구현하기 위한 작업을 순차(단계)적으로 작성해놓기
-* 해당 팀의 Github Project랑 연동시켜놓기-->
+* 해당 팀의 Github Project랑 연동시켜놓기-->

.github/ISSUE_TEMPLATE/bug-report.md

@@ -35,4 +35,4 @@ assignees: ''
  - 에러가 발생한 라이브러리/프레임워크 버전: [e.g. torchvision>0.16]
 
 **비고**
-<!--추가 설명이 필요한 경우 해당 란에 작성해주세요.-->
+<!--추가 설명이 필요한 경우 해당 란에 작성해주세요.-->

.github/ISSUE_TEMPLATE/error-report.md

@@ -40,4 +40,4 @@ assignees: ''
  - Version [e.g. 22]
 
 **비고**
-<!--추가 설명이 필요한 경우 해당 란에 작성해주세요.-->
+<!--추가 설명이 필요한 경우 해당 란에 작성해주세요.-->

.github/pull_request_template.md

@@ -39,4 +39,4 @@ PR의 변경 사항을 구체적으로 설명해주세요.
 <!--
 이 PR과 관련된 이슈나 기존 PR이 있다면 번호를 언급하고, 필요 시 close할 이슈도 명시해주세요.
 예: 관련 이슈 - #33, close #27
--->
+-->

.github/workflows/lint.yml

@@ -0,0 +1,24 @@
+name: Ruff Lint
+
+on: [push, pull_request]
+
+jobs:
+  ruff:
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Dependencies and Lint with Ruff
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          export PATH="$HOME/.local/bin:$PATH"
+          uv venv
+          uv pip install -r pyproject.toml
+          uv pip install ruff
+          uv run ruff check .

.github/workflows/ruff.yml

@@ -1,40 +1,11 @@
-exclude: '(^|/)(\.venv|venv|node_modules|__pycache__|migrations|static|templates|\.git|\.github|\.langgraph_api|media)(/|$)|\.(env(\.example)?|gitignore)$|LICENSE|README\.md|langgraph\.json|uv\.lock'
+exclude: '(^|/)(\.venv|venv|node_modules|__pycache__|migrations|static|templates|\.git|\.github|\.langgraph_api|media)(/|$)|^tests(/|$)|^unit_tests(/|$)|\.(env(\.example)?|gitignore)$|LICENSE|README\.md|langgraph\.json|uv\.lock'
 
 repos:
-  - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.6.13
-    hooks:
-      - id: uv-lock
-        files: '^pyproject\.toml$'
-        always_run: true
-
-  - repo: https://github.com/PyCQA/flake8
-    rev: 7.2.0
-    hooks:
-      - id: flake8
-        args:
-          [
-            "--max-line-length=120",
-            "--ignore=E203,E302,W503",
-            "--exclude=.venv,venv,node_modules,__pycache__,migrations,static,templates",
-          ]
-        language_version: python3.13
-        files: '^(?!.*(?:/\.venv/|/venv/|/node_modules/|/__pycache__/|/migrations/|/static/|/templates/)).*\.py$'
-        always_run: true
-
-  - repo: https://github.com/psf/black
-    rev: 25.1.0
-    hooks:
-      - id: black
-        language_version: python3.13
-        # 변경된 Python 파일에만 적용되도록 파일 필터를 지정합니다.
-        files: '\.py$'
-
-  - repo: https://github.com/PyCQA/isort
-    rev: 6.0.1
-    hooks:
-      - id: isort
-        args: ["--profile=black"]
-        language_version: python3.13
-        # 변경된 Python 파일에만 적용되도록 파일 필터를 지정합니다.
-        files: '\.py$'
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.0
+    hooks:
+      - id: ruff
+        types_or: [python, pyi]
+        args: [--fix]
+      - id: ruff-format
+        types_or: [python, pyi]

.pre-commit-config.yaml

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Pseudo Group
+   Copyright 2025 Proact0
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

LICENSE

@@ -1,4 +1,4 @@
-# Company Name
+# Act Name
 
 LangGraph와 LangChain을 활용한 AI 기반 프로젝트 템플릿
 
@@ -18,17 +18,17 @@ LangGraph와 LangChain을 활용한 AI 기반 프로젝트 템플릿
 
 ### 시스템 요구사항
 
-- Python 3.11 이상
+- Python 3.13 이상
 - uv (의존성 관리)
-- Flake8, Black, Isort (PEP8 스타일 포맷팅)
+- Ruff
 
 ### 설치 절차
 
 #### 1. 저장소 클론
 
 ```bash
-$ git clone https://github.com/Pseudo-Group/Company-Name.git
-$ cd Company-Name
+$ git clone https://github.com/Proact0/Act-Name.git
+$ cd Act-Name
 ```
 
 #### 2. uv 설치 (아직 설치되지 않은 경우)
@@ -57,20 +57,20 @@ $ uv sync --all-packages
 $ uv sync --package <PACKAGE NAME>
 ```
 
-> ex) agent_name의 경우
+> ex) cast_name의 경우
 >
 > ```bash
-> $ uv sync --package agent_name
+> $ uv sync --package cast_name
 > ```
 
-- langgraph.json에 노드 수정 (예: agent_name만 설치할 경우)
+- langgraph.json에 노드 수정 (예: cast_name만 설치할 경우)
 
 ```json
 {
   "dependencies": ["."],
   "graphs": {
-    "main": "./agents/workflow.py:main_workflow",
-    "agent_name": "./agents/agent_name/workflow.py:agent_name_workflow"
+    "main": "./casts/workflow.py:main_workflow",
+    "cast_name": "./casts/cast_name/workflow.py:cast_name_workflow"
   },
   "env": ".env"
 }
@@ -79,7 +79,7 @@ $ uv sync --package <PACKAGE NAME>
 #### 5. LangGraph 서버 실행
 
 ```bash
-$ uv run langgraph dev
+$ uvx --from "langgraph-cli[inmem]" --with-editable . langgraph dev
 ```
 
 ### 서버가 실행되면 다음 URL에서 접근할 수 있습니다:
@@ -96,8 +96,8 @@ $ uv run langgraph dev
 
 ### 변수에 따른 값 입력 후 실행
 
-- 각 Agent 별 `State`에 정의된 Attribute에 따라 변수를 입력합니다.
-- `GraphState`는 `agents/{agent_type}/modules/state.py:{state_name}`에서 개별 관리됩니다.
+- 각 cast 별 `State`에 정의된 Attribute에 따라 변수를 입력합니다.
+- `GraphState`는 `casts/{cast_type}/modules/state.py:{state_name}`에서 개별 관리됩니다.
 
 **실행 화면**
 ![](media/LangGraph_Studio_after_invoke.png)