🏗️ QA 봇에서 작업 에이전트까지: 아키텍처 가이드

1. 핵심 전환: QA 봇 → 작업 에이전트

2. 3계층 아키텍처

3. 권장 프로젝트 구조

내 작업 에이전트/
├──.cursorrules
├── main.py
├── 도구/
│ └── linear_mcp.py
└── README.md

4. 정적 컨텍스트 예:.cursorrules

# 역할
귀하는 생산 등급 시스템에 주력하는 수석 Python 엔지니어입니다.

# 규칙
- 디버깅을 위해 절대로 print()를 사용하지 마세요.
- 항상 유형 힌트 기능
- 3개 이상의 파일을 터치하는 경우 계획 제안

# 행동
- 간결하게 작성하세요
- 필요한 경우 명확한 질문을 하세요.

참조: https://github.com/PatrickJS/awesome-cursorrules

5. 다이나믹 스킬 예시(MCP)

mcp.server.fastmcp에서 FastMCP 가져오기

mcp = FastMCP("DevTools")

@mcp.tool()
def create_linear_ticket(title: str, 우선순위: str = "low") -> str:
    ticket_id = f"LIN-{hash(title) % 10000}"
    f"우선순위가 {priority}인 생성된 티켓 {ticket_id}"을 반환합니다.

__name__ == "__main__"인 경우:
    mcp.run()

참조: https://github.com/modelcontextprotocol/python-sdk

6. 결정적 후크 예

def compliance_check_hook(state):
    user_input = state["messages"][-1].content.lower()
    if "password" in user_input or "api_key" in user_input:
        return {"error": "보안 위반이 감지되었습니다"}
    return agent_node(state)

참고: https://langchain-ai.github.io/langgraph/