Research Astro/Starlight Workspaces

리서치 Astro/Starlight 워크스페이스 (Research Astro/Starlight Workspaces)

리서치 작업은 제품 도메인으로서 프로젝트 딜리버리와 분리돼 있지만, 별도 에이전트 런타임이 아닙니다. 사용자 요청 하나가 리서치 mono repo 하나, Daytona 워크스페이스 하나, Astro/Starlight 문서 표면 하나를 만들고, 그다음 프로젝트 딜리버리와 같은 Temporal + Studio + Daytona + 메일박스 + GitHub App PR 루프를 탑니다.

컨트랙트 (Contract)

Template: research-team
Agent process kind: project_delivery
Issue sink: research_repo
Repository type: research_monorepo
Team contract: Studio Team Contract가 리서치 역할 순서, 핸드오프 그래프, MCP/skill loadout, write 정책, PR submitter 정책을 소유.
Workspace contract: .fractalops/research/contract.json
Base image: ghcr.io/yamonco/fractalops-research-starlight:latest
Package manager: pnpm
PR submitter: scribe

리서치 런은 project_delivery를 emit하므로 Daytona 워크스페이스 할당, Studio 세션 상태, retry/resume, 태스크 카드, 메일박스 핸드오프, GitHub App PR 제출이 기존 AgentSquad 레일에 남습니다.

흐름 (Flow)

flowchart TB
  u["사용자: /research 에서\n질문 또는 타깃 사이트 제출"] --> inq["inquirer\n3~5개 명료화 질문"]
  inq --> tickets["사용자 답변 -> 리서치 티켓\n(요청 mono repo)"]
  tickets --> cur["curator\nScout/Auditor/Actor/Scribe 배정"]
  cur --> scribe["scribe\nAstro/Starlight를 PR로 갱신"]
  scribe --> tester["tester\nStarlight 프리뷰 + 증거 링크 검증"]
  tester --> committer["committer\n수락된 PR 머지"]
  committer --> closer["closer\nDataHub/wiki 계보 발행 + 티켓 종료"]

사용자가 /research에서 질문 또는 타깃 사이트를 제출.
inquirer가 3~5개 명료화 질문을 만듦.
사용자 답변이 요청 mono repo의 리서치 티켓이 됨.
curator가 scout, auditor, actor, scribe에 작업 배정.
scribe가 Astro/Starlight를 PR로 갱신.
tester가 Astro/Starlight 프리뷰와 증거 링크를 검증.
committer가 수락된 PR 머지.
closer가 DataHub/wiki 계보를 발행하고 티켓을 종료.

경계 (Boundaries)

리서치 repo는 프로젝트 assembly repo가 아닙니다.
리서치 팀은 local-only 러너, local-only repo, 대체 워크스페이스 매니저, 두 번째 오케스트레이션 엔진을 만들면 안 됩니다.
한 리서치 요청은 한 Daytona 워크스페이스에 매핑됩니다. 역할별 작업은 그 워크스페이스 안의 AgentSquad 슬롯/worktree로 일어납니다.
리서치 에이전트는 searxnggrid, agent-memory-archive, datahub, playwrightgrid, suit을 쓸 수 있습니다.
SUIT나 타깃 사이트에서 온 시크릿은 절대 Astro/Starlight나 wiki 사실에 쓰면 안 됩니다.
stale한 wiki 발견은 연결된 리서치 티켓 + PR로 갱신되어야 합니다.

시작/관찰 (Operate)

리서치 런은 일반 스튜디오 API로 구동/관찰합니다. 자세한 폴링·블로커 진단은 AgentSquad Operations를 참고하세요. 템플릿만 research-team을 쓰면 됩니다.

{
  "template_id": "research-team",
  "project_slug": "<research-slug>",
  "agent_process_kind": "project_delivery",
  "work_scope": "<the research question or target site>",
  "next_goal": "Create the research questionnaire, then assign Scout/Auditor/Actor/Scribe"
}