task

Task

plan의 태스크를 사용자와의 실행 합의를 거쳐 구현한다.

task는 합의 후 구현한다. 합의 없이 구현하지 않는다.

Step 0 — 컨텍스트 로드

1. 작업 대상 프로젝트의 .loom/index.md를 읽어 도메인 전체 지도를 파악한다.
2. aeira search -s {프로젝트의 .loom 경로} "{입력 키워드}" 로 관련 문서를 식별한다.
3. 식별된 문서에서 aeira graph neighbors -s {프로젝트의 .loom 경로} "{node}" 로 연결 문서를 탐색한다 (outgoing: 연관 concept과 flow, incoming: 참조 decision).
4. 탐색된 concept, flow, decision을 읽는다.
5. 대상 plan 파일을 읽어 태스크 목록과 의존관계를 파악한다.

사용자가 특정 태스크를 지정한 경우 해당 태스크에 집중한다. 지정하지 않은 경우, plan의 의존관계와 진행 상태를 기반으로 다음 태스크를 제안한다.

Step 1 — 룰 카탈로그 로드

.loom/rules/index.md를 읽어 어떤 룰과 컨벤션이 있는지 카탈로그를 인지한다.

rule은 이 프로젝트에서 항상 지켜져야 하는 강제적 합의, convention은 강하게 권장되지만 대체 가능한 형태이다. 인덱스를 통해 항목 목록과 각 항목의 호출 상황을 파악한다. 본문은 활용 시점에 필요한 항목을 골라낸 뒤 로드한다.

Step 2 — 방향성 합의

대상 태스크를 실제 구현으로 전환하기 위한 방향성 초안을 제시한다.

초안의 형태

• 구체적 코드가 아닌 수도코드 수준으로 제시한다.
• concept의 책임과 flow의 단계가 실제 데이터 흐름으로 어떻게 표현되는지를 보인다.
• 이 태스크가 전체 그림에서 어디에 해당하며, 어떤 목적을 달성하는지를 설명한다.

논의

사용자와의 논의를 통해 방향성을 구체화한다.

논의 중 결정이 발생하면 즉시 .loom/decisions/에 기록한다. 기록 기준은 decision concept을 따른다. 템플릿: ../../templates/decision.md. 파일 이름: {NNNN}-{결정-제목}.md (순번으로 시간순 보존).

concept과 index의 갱신은 task의 책임이 아니다 — review에서 구현 결과를 바탕으로 처리한다.

shape로의 라우팅

다음 신호가 발견되면 사용자에게 shape로 돌아갈지 물어본다:

• 드러나지 않았던 암묵지가 발견되어 태스크의 전제가 흔들릴 때
• concept의 방향성에 큰 변경이 필요할 때 (세밀한 조정이 아닌 구조적 재설계)

합의 완료의 신호

사용자가 방향성에 동의하고, 구현 수준의 이야기(파일 구조, 구체적 코드)로 넘어가려 할 때.

Step 3 — 코드 초안

방향성 합의를 바탕으로 코드 초안을 제시한다.

초안 제시 방식

사용자의 기호에 따라 실제 파일 작성 또는 대화 내 코드 블록으로 제시한다. 기존 코드의 컨벤션(네이밍 규칙, 모듈 구성 방식, 스캐폴딩)을 따르되, 사용자의 선호를 우선한다.

룰 카탈로그 활용

코드 초안 작성 시, 인지한 룰 카탈로그를 도구 선택 절차로 활용한다:

1. 지금 수행하려는 행동을 의식적으로 명시한다
2. 카탈로그에서 그 행동에 적용될 가능성 있는 항목을 골라낸다
3. 골라낸 항목의 본문 파일을 로드해 적용 방식을 파악한다
4. 본문에 따라 코드를 작성한다

반복

사용자의 피드백을 통해 구현을 구체화해 나간다. 피드백 과정에서 발생하는 결정은 decision concept의 기준에 해당하면 즉시 기록한다.

Step 4 — 구현 완료

구현이 완료되면 plan에서 해당 태스크를 완료 처리한다.

그래프 갱신

.loom/ 내 문서를 생성하거나 수정한 후 aeira sync -s {프로젝트의 .loom 경로} 를 실행한다.

Summary

태스크 구현 완료 시 다음 형식으로 정리한다:

## Task Summary
- 태스크: [수행한 태스크 요약]
- 방향성: [합의된 접근 방식 한 줄]
- 산출물: [생성/수정된 파일 목록]
- Decisions: [기록된 decision 파일 목록, 없으면 생략]
- Plan 상태: [완료 처리된 항목]