# 🚀 Taskr에 오신 것을 환영합니다 - 당신의 AI를 위한 프로젝트 매니저

## 1.1 Taskr는 무엇인가요?

### 쉬운 설명

AI에게 큰 프로젝트를 도와달라고 요청했을 때, AI가 가끔 무엇을 하고 있었는지 잊어버리거나 도중에 혼란스러워하는 경우를 경험해 보셨나요? **Taskr가 이를 해결해 줍니다.**

Taskr를 **AI 어시스턴트가 자동으로 읽고 업데이트할 수 있는 스마트한 할 일 목록**이라고 생각해 보세요. AI에게 완벽한 기억력과 프로젝트 매니저의 두뇌를 제공하는 것과 같습니다.

### Taskr가 특별한 이유는 무엇인가요?

일반적인 AI는 할 수 없는 Taskr만의 기능은 다음과 같습니다:

**🧠 컨텍스트를 절대 잊지 않습니다**
- 컴퓨터를 끄고 며칠 뒤에 돌아와도 AI는 프로젝트에 대한 모든 것을 기억합니다.
- 어디서 멈췄는지, 다음에 무엇을 해야 할지 정확히 알고 있습니다.
- "잠깐, 우리가 방금 무엇을 작업하고 있었죠?"라고 더 이상 물을 필요가 없습니다.

**📋 스마트한 작업 관리**
- 큰 프로젝트를 자동으로 실행 가능한 작은 단위로 나눕니다.
- 어떤 작업이 다른 작업에 의존하는지 알고 있습니다.
- 올바른 순서로 작업을 진행합니다 (무작위로 건너뛰지 않습니다).

**👥 팀 협업에 최적화**
- 여러 AI 에이전트가 서로 방해하지 않고 동일한 프로젝트에서 작업할 수 있습니다.
- 각 에이전트는 누가 무엇을 하고 있는지 알고 있습니다.
- 한 에이전트가 코딩을 하는 동안 다른 에이전트가 조사나 계획을 담당하기에 완벽합니다.

**📝 완벽한 기록 유지**
- 수행하는 모든 작업을 자동으로 문서화합니다.
- 어떤 파일이 변경되었는지, 어떤 결정이 왜 내려졌는지 확인할 수 있습니다.
- AI가 실제로 무엇을 만들었는지 이해하는 데 매우 유용합니다.

### 실제로 어떻게 작동하나요? (기술적인 내용을 쉽게 설명해 드립니다)

**큰 그림:** Taskr는 여러분과 AI 사이에서 모든 것을 조직화해 주는 다리와 같습니다.

흐름은 다음과 같습니다:

1. **여러분의 AI(Cursor, Claude Desktop, OpenClaw 등)가 간단한 1회성 설정을 통해 Taskr에 연결됩니다.**
2. **AI에게 원하는 작업을 말합니다** ("내 운동 루틴을 기록하는 앱을 만들고 싶어" 또는 "신제품을 위한 경쟁사 조사해줘" 등).
3. **AI가 스마트한 계획을 세웁니다** — 단순한 할 일 목록이 아니라, Taskr에 저장되는 클라우드 기반의 다층 구조 계획입니다.
4. **작업을 진행하면서 AI가 수행한 일과 배운 내용을 Taskr에 업데이트합니다.**
5. **여러분은 실시간으로 진행 상황을** Taskr 확장 프로그램이나 웹사이트를 통해 확인할 수 있습니다.

이 마법은 **MCP (Model Context Protocol)**라는 것을 통해 이루어지지만, 이름은 걱정하지 마세요. 휴대폰 앱이 인터넷과 통신하는 것처럼 AI가 Taskr와 자동으로 대화할 수 있게 해주는 기술이라는 점만 알면 됩니다.

### AI가 갖게 되는 도구들 (12가지 초능력)

Taskr에 연결되면 AI는 이전에는 없던 12가지 특별한 능력을 얻게 됩니다:

**작업 관리를 위해:**
- 해야 할 일을 발견하면 새로운 작업을 생성합니다.
- 작업을 완료하면 상태를 업데이트합니다.
- 더 이상 필요하지 않은 작업을 삭제합니다.
- 자동으로 다음 작업을 가져옵니다 ("다음은 뭐지?"라고 물을 필요가 없습니다).
- 프로젝트 전체 구조를 한눈에 확인합니다.
- 추적하지 못한 이전 작업들을 소급하여 동기화합니다.

**노트 기록을 위해:**
- 작업 중인 내용을 기록합니다.
- 상황이 변하면 노트를 업데이트합니다.
- 오래된 노트를 삭제합니다.
- 모든 프로젝트 문서를 훑어봅니다.
- 필요할 때 특정 노트를 읽습니다.
- 작성한 모든 내용을 검색합니다.

이 도구들을 통해 AI는 스스로를 관리할 수 있습니다. 여러분은 무엇을 만들지 말하기만 하면 되고, 나머지는 AI가 처리합니다!

### 주요 개념 (자주 보게 될 용어들)

시작하기 전에 접하게 될 주요 요소들입니다:

**Projects** 📁
- 만들고 있는 서로 다른 것들을 담는 폴더와 같다고 생각하세요.
- 각 프로젝트는 완전히 분리되어 있습니다 (레시피 앱과 운동 기록 앱이 섞이지 않습니다).
- 각 프로젝트마다 고유한 ID를 받게 됩니다 (`PR_01JGYV...` 형식으로 PR_ 뒤에 26자의 문자가 붙습니다).

**Tasks** ✅
- 수행해야 할 개별 작업들입니다.
- 개요 형식으로 구성됩니다 (1.0, 1.1, 1.2, 2.0 등).
- 각 작업은 setup (준비), analysis (조사), implementation (구축), validation (확인), testing (테스트) 중 하나의 타입을 가집니다.
- 상태(Status)는 대기 중, 작업 중, 완료, 건너뜀 등을 보여줍니다.

**Notes** 📝
- AI가 작업하면서 작성하는 문서입니다.
- 정보에 따라 다른 타입을 가집니다:
  - **FILE_LIST** - 어떤 파일이 생성되거나 변경되었는지
  - **PROGRESS** - 달성한 주요 마일스톤
  - **CONTEXT** - 배경 정보 및 결정 사항
  - **FINDING** - 발견된 문제와 해결 방법
  - **OTHER** - 그 외 나머지

**Guidance** 🎯
- AI가 올바른 방향으로 나아갈 수 있도록 Taskr가 제공하는 스마트한 힌트입니다.
- AI가 하고 있는 작업에 따라 내용이 바뀝니다.
- AI가 혼란에 빠지거나 엉뚱한 길로 가는 것을 방지합니다.

---