§03–04 · 학습 챕터

03. Folder 3 layers

_shared · _templates · tasks

멀티에이전트 작업은 세 층으로 나뉩니다. 규칙 → 양식 → 실행. 비유하면: 회사 규정집, 빈 양식, 실제로 채운 프로젝트 폴더입니다.

정본: STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)

챕터 이동chapter-nav

이전·다음 챕터로 이동합니다. 본문은 아래 학습 블록 카드에서 펼칩니다.

02. Install · validate / 설치 · init.py · 검증

홈

Harness MultiAgent 2.1

04 작업 lifecycle

01. Harness Orchestrator 02. Install · validate 03. Folder 3 layers 04. Task lifecycle 05. Workers · MCP 06. Approval · envelope 07. Four flavors 08. RUNBOOK 09. KNOT · wiki 10. KNOT · install 11. KNOT · bridge LAB · Phase · Run

전체 학습 블록 카드learn-blocks

학습 블록

Three layers overview

3층 한눈에

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · multi-agent-system/ # MULTIAGENT_ROOT

문서 코드 본문현재 실습

학습 블록

Shared layer

_shared 규칙층

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · 일반 작업이 아니라 _shared/*를 바꿀 때만:

문서 코드 본문 실습

학습 블록

Templates layer

_templates 양식층

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · 템플릿은 복사 후 채우기만 합니다. tasks/ 안에서 직접 구조를 발명하지 마세요.

문서 코드 본문 실습

학습 블록

Tasks layer

tasks 실행층

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · tasks/<task-name>/

문서 코드 본문 실습

학습 블록

Character limits

한도와 이유

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · wc -m tasks/my-feature/context.md # 한글 자수

문서 코드 본문 실습

학습 블록

MULTIAGENT_ROOT

워크스페이스와 루트

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · MultiAgentSystem/ # git repo (LAB)

문서 코드 본문 실습

학습 블록

Common mistakes

자주 하는 실수

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · 자주 하는 실수

문서 코드 본문 실습

학습 블록

Checklist

체크리스트

STRUCTURE-DESIGN.md · 매뉴얼 04장 · _templates/task-folder.md · 체크리스트

문서 코드 본문 실습

선택 블록 본문block-detail

Three layers overview

3층 한눈에

층	폴더	역할 (한글)	수정 빈도
규칙	`_shared/`	모든 작업에 공통 — 라우팅·승인·호출 경로	거의 없음 (generator)
양식	`_templates/`	새 작업 폴더 만들 때 복사하는 빈 서식	거의 없음
실행	`tasks/<task>/`	지금 하고 있는 일 — 파일 = 메모리	매일 append

정본 발췌 (STRUCTURE-DESIGN.md)

multi-agent-system/                    # MULTIAGENT_ROOT
├── AGENTS.md                          # 운영 규칙 전문
├── _shared/                           # ── 규칙층 ──
├── _templates/                        # ── 양식층 ──
└── tasks/                             # ── 실행층 ──
    └── <task-name>/
        ├── task.md · context.md · log.md
        └── workers/<worker>/
            ├── brief.md
            └── result.md