커리큘럼을이해하고,질문으로 확장하기

모델·에이전트·하네스

모델(model)은 주어진 입력을 바탕으로 다음 응답과 판단을 만들어내는 핵심 요소예요. 모델이 잘 답하는 것과 내 파일·브라우저에서 일이 제대로 진행되는 것은 같은 문제가 아닙니다.

에이전트(agent)는 목표와 현재 상태를 바탕으로 다음 행동을 선택하고, 필요한 도구를 사용하며, 그 결과를 보고 다음 진행을 판단하는 시스템으로 이해할 수 있어요. 제품과 문헌에 따라 정의 범위는 다르지만, 여기서는 ‘대답 생성’뿐 아니라 ‘행동과 관찰을 이어가는 방식’에 주목합니다. 매 응답마다 도구를 쓰거나 모든 에이전트가 장기 기억을 갖춰야 한다는 뜻은 아니에요.

하네스(harness)는 그 에이전트가 어떤 맥락과 규칙으로, 어떤 도구·권한 안에서 일하고, 결과와 남은 상태를 어떻게 확인하며 이어갈지 정하는 운영 틀이에요. 에이전트를 더 똑똑하게 만드는 모델 선택과, 에이전트가 제대로 일할 조건을 갖추는 일은 함께 봐야 합니다.

요청을 시작하는 방법

1주차에는 기능을 모두 설정하는 것이 아니라, 작은 일을 실제로 맡기고 과정과 결과를 보는 데서 시작했어요. 에이전트(agent)는 질문에 답만 하는 역할을 넘어, 필요한 도구를 써서 페이지를 읽거나 파일을 만드는 일을 합니다. 그렇다고 모든 일을 자동으로 해도 된다는 뜻은 아니에요.

이 주차에서 중요한 것은 ‘AI가 대답했다’와 ‘내가 요청한 일이 실제로 진행됐다’를 구분하는 경험이에요. 요청한 내용, 사용한 자료, 실행 과정, 실제 결과 또는 막힌 곳이 이어져야 합니다.

매번 같은 설명을 다시 한다면 대화 한 번의 조건 중 일부를 지속적인 기준으로 옮길 수 있어요. 10/6 수업에서는 USER.md · SOUL.md · AGENTS.md 세 문서를 모두 작성하고 사용했습니다.

• USER.md — 나는 어떤 사람인가요? 내가 하는 일, 원하는 변화, 선호하는 도움 방식처럼 계속 쓸 정보를 담아요.
• SOUL.md — 어떤 에이전트가 되면 좋을까요? 역할·태도·판단 기준을 정해요. 이름이나 말투뿐 아니라 실제 일하는 성향을 표현합니다.
• AGENTS.md — 일할 때 무엇을 지켜야 하나요? 어떤 자료를 먼저 읽고, 어떤 순서와 형식으로 일하며, 언제 멈춰 물을지 적어요.

세 문서는 서로 영향을 주지만 같은 질문의 답은 아니에요. 모든 문장을 정확히 한 칸에만 넣는 것보다 기준이 서로 모순되지 않고 실제 행동으로 이어지는 것이 중요합니다.

2주차 문서가 ‘누구를 돕고 어떤 기준으로 일할지’를 정했다면, 스킬(skill)은 특정 일을 언제 꺼내서 어떤 순서와 형식으로 할지 적는 설명서예요.

모든 요청을 스킬로 만들 필요는 없어요. 한 번 할 일은 자연어로 충분할 수 있습니다. 같은 자료 확인, 같은 순서, 같은 출력 형식을 계속 설명한다면 그 방법을 다시 쓰는 스킬이 도움이 됩니다.

내장 스킬을 사용해보고, 같은 일을 스킬 없이 시킨 결과와 비교해요. 이어서 앞선 업무의 반복 가능한 단계로 작은 사용자 스킬을 만들고 자연어로 실행합니다. CLI·REPL·MCP는 각각 한 번씩 실제로 사용하고 결과를 확인해요.

다시 같은 설명을 하지 않으려면 필요한 기억이 있어야 하고, 다시 일을 시작하려면 시점과 방법이 있어야 해요. 이 둘을 연결해도 무엇을 해도 되는지까지 자동으로 정해지지는 않습니다.

• 기억(memory): 다음에도 쓸 맥락을 보관합니다. 기억 내용을 검토하고 보관 여부를 정해요.
• 이전 기록(history): 과거의 요청·실행·대화를 살펴보고 이어가는 근거가 됩니다. 과거 기록이 있다는 것과 그 내용이 현재 요청에 정확히 반영됐다는 것은 달라요.
• 루틴(routine): 정해진 때 작업을 시작하거나 기존 대화를 이어갑니다.
• 권한(permission): 읽기·쓰기·실행 등 실제로 허용할 범위를 제품에서 정합니다.

4주차에는 새 과제를 추가로 시작하지 않아요. 앞서 만든 역할·규칙, 사용자 스킬, CLI·REPL·MCP 실행 기록에 기억·루틴·권한을 연결하여 최종 결과를 확인하고 고칩니다.