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

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

2. 3계층 아키텍처

3. 권장 프로젝트 구조

my-task-agent/
├── .cursorrules
├── main.py
├── tools/
│   └── linear_mcp.py
└── README.md

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

# 역할
당신은 프로덕션급 시스템에 집중하는 시니어 파이썬 엔지니어입니다.

# 규칙
- 디버깅을 위해 절대 print()를 사용하지 마세요
- 항상 함수에 타입 힌트를 추가하세요
- 3개 이상의 파일을 수정할 경우 계획을 제안하세요

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

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

5. 동적 기술 예제 (MCP)

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DevTools")

@mcp.tool()
def create_linear_ticket(title: str, priority: str = "low") -> str:
    ticket_id = f"LIN-{hash(title) % 10000}"
    return f"Created ticket {ticket_id} with priority={priority}"

if __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/