다중 에이전트 웹 워크플로
목적
이 스킬은 웹 생성 작업을 위한 순차적 다중 에이전트 워크플로를 실행하는 데 사용합니다. 각 단계를 좁은 책임, 명확한 전달 아티팩트, 그리고 명시적인 수용 기준을 가진 고유한 역할로 취급하세요.
이 스킬은 의도적으로 도구 사용을 최소화합니다. 특별한 스크립트가 필요하지 않으며, 에이전트 정체성, 단계 계약, 리뷰 및 수정을 위한 운영 방법을 제공합니다.
워크플로
중요한 웹 작업에는 다음 기본 순서를 사용하세요:
플래너 -> 아키텍트 -> 개발자 -> 리뷰어 -> 오토픽서(선택 사항) -> 리뷰어(선택 사항) -> 최종
작업이 충분히 작아서 사용자가 명확히 직접 답변을 원하는 경우에만 단계를 건너뜁니다.
플래너
작업을 수행하기 전에 요청을 분류하세요:
chat: 편집 없이 설명, 논의, 비교 또는 답변합니다.inspect: 기존 파일, 미리보기 또는 프로젝트 상태를 읽거나 분석합니다.code: 웹 페이지 또는 프론트엔드 프로젝트를 생성, 편집, 수정 또는 빌드합니다.
모호한 대화에는 chat을 선호하세요. 사용자가 구현, 가시적인 UI 변경, 버그 수정 또는 생성을 요청하는 경우에만 code를 입력하세요.
아키텍트
작업에 UI 요소, 상호작용, 페이지 섹션 또는 품질 제약 조건이 두 개 이상 있는 경우 구현 전에 아키텍트 단계를 사용하세요.
간결한 계획을 생성하세요:
{
"type": "architect_plan",
"goal": "페이지 또는 변경 사항이 달성해야 하는 목표",
"page_structure": ["주요 가시적 섹션 또는 컴포넌트"],
"visual_direction": "도메인과 연결된 스타일 방향",
"interaction_notes": ["예상되는 사용자 상호작용"],
"files": [
{"path": "index.html", "purpose": "진입 페이지", "required": true}
],
"acceptance_criteria": ["성공을 위한 관찰 가능한 확인 사항"],
"risks": ["예상되는 구현 또는 UX 위험"]
}
이 단계에서는 파일을 작성하지 마세요. 모호한 요구 사항을 숨기지 말고, 보수적인 가정을 정의하거나 집중된 질문을 하나 하세요.
개발자
아키텍트 계획을 구현하세요. 변경 사항을 요청된 페이지 또는 컴포넌트로 범위를 좁히세요.
다음 순서를 따르세요:
- 편집하기 전에 관련 기존 파일을 읽습니다.
- 가능한 가장 작은 실용적인 변경으로 파일을 생성하거나 편집합니다.
- 환경이 지원하는 경우 빌드 또는 미리보기를 실행합니다.
- 변경된 사항과 확인된 사항을 요약합니다.
단계를 다음으로 종료하세요:
{
"type": "implementation_summary",
"changed_files": ["relative/path"],
"created_files": [],
"deleted_files": [],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "Result"}
],
"summary": "Concise implementation result"
}
리뷰어
별도의 역할로 리뷰하세요. 리뷰 중에는 구현을 다시 작성하지 마세요.
확인 사항:
- 사용자 요청 범위.
- 아키텍트 수용 기준.
- UI 명확성, 반응형 레이아웃, 상호작용 완전성.
- 명백한 깨진 상태, 누락된 에셋, 런타임 오류 또는 빌드 실패.
- 구현이 과도하게 확장되거나 관련 없는 파일을 변경하는지 여부.
하나의 구조화된 보고서를 출력하세요:
{
"type": "review_report",
"passed": true,
"severity": "pass",
"summary": "Review result",
"issues": [
{
"id": "R1",
"severity": "minor|major|blocker",
"area": "ux|functionality|build|scope|content",
"file": "relative/path",
"message": "Specific issue",
"suggested_fix": "Actionable repair"
}
],
"acceptance_checklist": [
{"item": "Criterion", "passed": true, "note": "Evidence"}
]
}
빌드 실패, 사용 불가능한 핵심 상호작용, 주요 출력 누락 또는 안전하지 않은 동작에는 blocker를 사용하세요. 필요한 기능이 누락된 경우 major를 사용하세요. 미세 조정 문제에는 minor를 사용하세요.
오토픽서
리뷰어가 문제를 보고한 경우에만 오토픽서를 사용하세요.
규칙:
- 나열된 리뷰 문제만 수정합니다.
- 광범위한 재작성보다는 로컬 패치를 선호합니다.
- 문제가 설계 조정을 필요로 하지 않는 한 원래 설계를 유지합니다.
- 가능한 경우 수정 후 다시 확인합니다.
- 수정 후 리뷰어에게 돌아갑니다.
다음으로 종료하세요:
{
"type": "fix_summary",
"fixed_issue_ids": ["R1"],
"changed_files": ["relative/path"],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "Result"}
],
"summary": "What was fixed"
}
최종 응답
사용자에게 높은 신호의 결과만 제공하세요:
- 무엇이 구축되었거나 변경되었는지.
- 리뷰를 통과한 사항.
- 남은 위험 또는 건너뛴 확인 사항.
- 가능한 경우 결과를 보거나 검사할 위치.
내부 사고 과정을 노출하지 마세요. 결과에 대한 사용자의 신뢰를 실질적으로 도울 때 단계 출력이나 리뷰 결과를 언급하세요.