6장: 컨텍스트 정렬과 포맷 최적화

interface ContextBlock {
  content: string;
  priority: "critical" | "high" | "medium" | "low";
  type: "system" | "code" | "reference" | "task";
}
 
function orderContextBlocks(blocks: ContextBlock[]): ContextBlock[] {
  const critical = blocks.filter(b => b.priority === "critical");
  const high = blocks.filter(b => b.priority === "high");
  const medium = blocks.filter(b => b.priority === "medium");
  const low = blocks.filter(b => b.priority === "low");
  
  return [
    ...critical,     // 시작: 핵심 규칙, 시스템 프롬프트
    ...low,          // 중간 시작: 낮은 우선순위
    ...medium,       // 중간: 참조 코드
    ...high,         // 끝 근처: 중요 컨텍스트
    // 사용자 요청은 항상 맨 마지막
  ];
}

<context>
  <project-rules>
    <rule priority="critical">TypeScript strict mode, no 'any' type</rule>
    <rule priority="critical">Function declarations for components</rule>
    <rule priority="high">Use cn() for className composition</rule>
  </project-rules>
  
  <current-file path="src/auth/middleware.ts">
    <code language="typescript">
      export function verifyToken(req: Request): Promise&lt;User&gt; {
        // ...
      }
    </code>
  </current-file>
  
  <related-files>
    <file path="src/auth/types.ts" summary="User, Role, AuthConfig types" />
    <file path="src/auth/jwt.ts" summary="JWT sign/verify utilities" />
  </related-files>
</context>

## Project Rules
 
- **[CRITICAL]** TypeScript strict mode, no 'any' type
- **[CRITICAL]** Function declarations for components
- **[HIGH]** Use cn() for className composition
 
## Current File: src/auth/middleware.ts
 
export function verifyToken(req: Request): Promise<User> {
  // ...
}
 
## Related Files
 
| File | Summary |
|---|---|
| src/auth/types.ts | User, Role, AuthConfig types |
| src/auth/jwt.ts | JWT sign/verify utilities |

{
  "projectRules": [
    { "rule": "TypeScript strict mode, no any", "priority": "critical" },
    { "rule": "Function declarations for components", "priority": "critical" },
    { "rule": "Use cn() for className", "priority": "high" }
  ],
  "currentFile": {
    "path": "src/auth/middleware.ts",
    "code": "export function verifyToken(req: Request): Promise<User> { ... }"
  },
  "relatedFiles": [
    { "path": "src/auth/types.ts", "summary": "User, Role, AuthConfig types" },
    { "path": "src/auth/jwt.ts", "summary": "JWT sign/verify utilities" }
  ]
}

## 설명
 
UserService는 사용자 CRUD를 담당합니다. findById는 캐시를 먼저 확인하고,
없으면 DB에서 조회합니다. create는 이메일 중복을 검사합니다.
 
## 코드
 
class UserService {
  async findById(id: string): Promise<User | null> { ... }
  async create(data: CreateUserDTO): Promise<User> { ... }
}

## UserService
 
사용자 CRUD를 담당하는 서비스입니다.
 
### findById
 
캐시를 먼저 확인하고, 없으면 DB에서 조회합니다.
 
async findById(id: string): Promise<User | null> { ... }
 
### create
 
이메일 중복을 검사한 후 사용자를 생성합니다.
 
async create(data: CreateUserDTO): Promise<User> { ... }

<context>
  <task-type>code-modification</task-type>
  
  <project-context>
    <!-- CLAUDE.md 핵심 규칙 -->
  </project-context>
  
  <target-file path="...">
    <!-- 수정 대상 전체 코드 -->
  </target-file>
  
  <dependencies>
    <!-- 의존하는 타입/인터페이스 (압축) -->
  </dependencies>
  
  <related-tests path="...">
    <!-- 관련 테스트 코드 -->
  </related-tests>
  
  <similar-implementations>
    <!-- 프로젝트 내 유사한 구현 예시 -->
  </similar-implementations>
  
  <user-request>
    <!-- 사용자의 구체적 요청 -->
  </user-request>
</context>

<context>
  <task-type>bug-fix</task-type>
  
  <error-info>
    <error-message><!-- 에러 메시지 --></error-message>
    <stack-trace><!-- 스택 트레이스 --></stack-trace>
    <reproduction-steps><!-- 재현 단계 --></reproduction-steps>
  </error-info>
  
  <suspected-files>
    <!-- 에러와 관련된 파일들 (전체 코드) -->
  </suspected-files>
  
  <call-chain>
    <!-- 에러 발생 경로의 호출 체인 -->
  </call-chain>
  
  <recent-changes>
    <!-- 최근 변경사항 (git diff) -->
  </recent-changes>
</context>