# 🎯 Taskr의 실제 작동 방식

## 3.5 Dynamic Guidance - AI가 경로를 이탈하지 않게 하기

### 해결하는 문제

대화가 길어질 때 AI가 가끔 방향을 잃는 것을 보신 적 있나요? 처음에는 체계적이다가도 점차 규칙이나 모범 사례를 잊어버리곤 합니다. Dynamic Guidance(동적 가이드)가 이를 해결합니다!

### 작동 방식

AI가 Taskr 도구를 사용할 때마다 응답에는 세 가지 부분이 포함됩니다:

```json
{
  "data": {
    // 실제 결과 (태스크 생성됨, 노트 저장됨 등)
  },
  "rules": [
    // 지금 이 순간 관련 있는 Markdown 규칙들
    "- 한 번에 하나의 태스크만 작업할 것",
    "- 다음 단계로 넘어가기 전에 태스크를 완료로 표시할 것",
    "- 중요한 발견 사항은 노트를 생성할 것"
  ],
  "actions": [
    // 제안되는 다음 단계
    "작업을 계속하려면 get_task를 호출하세요",
    "주요 성과를 달성했다면 PROGRESS 노트를 생성하세요"
  ]
}
```

### 컨텍스트 기반 적응

가이드는 AI가 무엇을 하고 있는지에 따라 달라집니다:

- **작업 시작 중?** → 태스크 선택에 관한 규칙
- **노트 생성 중?** → 노트 유형 및 품질에 관한 규칙
- **태스크 생성 중?** → 조직 및 구조에 관한 규칙
- **상태 업데이트 중?** → 완료 기준에 관한 규칙

### 실제 예시

**`get_task` 호출 시:**
- 가이드에 "process-task-list" 규칙 포함
- 순차적으로 작업하도록 AI에게 상기시킴
- 발견 사항에 대해 노트를 작성하도록 제안

**`create_note` 호출 시:**
- 가이드에 노트 유형 정의 포함
- 태스크 첨부에 대해 상기시킴
- 특정 콘텐츠에 특정 유형을 사용하도록 제안

### 스마트 액션

규칙 외에도 Taskr는 응답과 함께 **actions(액션)**를 보냅니다. 이는 AI가 방금 수행한 작업에 맞춤화된 실용적인 다음 단계들입니다:

- **워크플로우 액션** — "1단계 완료, 이제 관련 태스크 리스트를 상세히 분석하세요"와 같은 단계별 가이드
- **힌트 액션** — "변경 사항을 확인하려면 `get_task_hierarchy`를 사용하세요" 또는 "이 마일스톤에 대해 PROGRESS 노트를 생성하세요"와 같은 도구 호출 제안

이러한 액션들은 컨텍스트에 따라 동적으로 변합니다. 태스크를 완료하면 힌트는 다음 태스크를 가져오라고 제안합니다. 태스크를 생성하면 계층 구조를 확인하라고 제안합니다. 마치 매 회전마다 경로를 재계산하는 GPS와 같습니다.

### 이것이 중요한 이유

**Dynamic Guidance가 없을 때:**
- 대화가 50회 이상 넘어가면 AI가 프로젝트 컨벤션을 잊어버립니다.
- 잘못된 노트 유형을 만들기 시작합니다.
- 동시에 여러 태스크를 작업할 수도 있습니다.
- 워크플로우 요구 사항을 놓치게 됩니다.

**Dynamic Guidance가 있을 때:**
- 모든 응답이 모범 사례를 강화합니다.
- 수백 개의 태스크를 수행하는 동안 AI가 일관성을 유지합니다.
- 프로젝트 표준이 자동으로 유지됩니다.
- 긴 세션에서도 "방향 상실"이 발생하지 않습니다.

---

## 정리 - 종합하기

이 모든 조각들이 하나의 시스템으로 작동하는 방식은 다음과 같습니다:

1. **Projects**는 서로 다른 빌드를 격리합니다 (레시피 앱 vs 운동 추적기).
2. **Task Lists**는 기능을 집중적인 작업 스트림으로 구성합니다.
3. **Tasks**는 작업을 계층적이고 추적 가능한 조각으로 나눕니다.
4. **Notes**는 작업 중에 발생하는 지식과 결정을 캡처합니다.
5. **Dynamic Guidance**는 AI가 모범 사례를 따르도록 유지합니다.

놀라운 점은 AI가 MCP 프로토콜을 통해 이 모든 것을 자동으로 처리한다는 것입니다. 여러분은 단지 "레시피 앱 만들어줘"라고 말하고 마법이 일어나는 것을 지켜보기만 하면 됩니다!

각 컴포넌트는 견고한 PostgreSQL 데이터베이스 설계, TypeScript 서비스, React UI 컴포넌트로 뒷받침되지만—여러분은 그런 걱정을 하실 필요가 없습니다. 그냥 잘 작동하니까요! 🚀

---

## 다음 단계

이제 Taskr의 작동 방식을 이해하셨으니:
1. **[구축 시작하기](/docs/ko/getting-started/1-1.md)** - 이 지식을 활용해 보세요!