Core Concepts

한국어 | English

핵심 개념

이 페이지는 AGS 문서를 읽을 때 반복해서 등장하는 개념을 빠르게 정리합니다.

Task Contract

작업의 기준선입니다.

보통 다음을 포함합니다.

• 목표
• 수정 또는 조사 범위
• 완료 기준
• 위험
• 권한과 제한
• 필요한 검증

작업이 길어지거나 반복될수록 처음의 목표와 실제 수행 범위가 달라지기 쉽습니다. Task Contract는 후속 판단을 같은 기준에 묶는 역할을 합니다.

Skill

특정 종류의 판단을 수행하기 위한 전문 규칙과 결과 형식입니다.

예:

• task-contract
• change-scope-guardian
• mutation-risk-preflight
• acceptance-evidence-validator
• independent-audit-gate
• blocker-diagnostician
• recovery-strategy-selector

스킬은 단순 프롬프트 모음이 아니라 “어떤 조건에서 무엇을 보고 어떤 결과를 만들어야 하는가”를 정의합니다.

Orchestrator

작업에 필요한 전문 capability를 고르고 순서와 입출력을 연결합니다.

오케스트레이터가 모든 판단을 직접 수행하는 것이 아니라, 전문 스킬의 결과를 조합하고 다음 단계로 연결합니다.

Workflow

여러 전문 단계를 하나의 실행 단위로 연결한 것입니다.

대표 흐름:

plan_workflow
      ↓
start_guarded_workflow
      ↓
record_stage_result
      ↓
record_stage_result
      ↓
finalize_workflow

각 단계는 계획된 순서와 계약에 맞는지 검사됩니다.

Stage

Workflow 안의 하나의 전문 작업 단계입니다.

Stage 결과에는 상태, 산출물, 증거, findings, blockers 등이 포함될 수 있습니다.

Evidence

완료 판단을 뒷받침하는 현재 근거입니다.

중요한 원칙은 주장과 근거를 분리하는 것입니다.

예를 들어 “테스트가 통과했다”는 문장보다 실제 실행 결과, 파일 위치, digest, receipt가 더 강한 근거가 됩니다.

Audit

구현자와 분리된 관점에서 요구사항, 변경 결과, 실패 가능성과 증거를 다시 확인하는 과정입니다.

고위험 변경에서 특히 중요합니다.

Peer Session

다른 세션의 하위 프로세스라는 의미가 아니라, 자신의 독립 문맥을 유지하면서 다른 세션과 협업하는 실행 주체를 뜻합니다.

Session Board

현재 세션의 host, session ID, 작업 디렉터리와 한 줄 업무 요약을 공유하는 현황판입니다.

어떤 세션이 어떤 일을 맡고 있는지 찾는 데 사용합니다.

PEER Message

세션 간 실제 요청, 조건, 근거, 검토 결과와 차단 사유를 전달하는 메시지입니다.

메시지는 시스템이 발급한 ID로 추적됩니다.

ACK

메시지 처리 확인입니다.

ACK는 다음을 뜻하지 않습니다.

• 업무 완료
• 실행 승인
• 검토 통과
• 사용자의 새 승인

따라서 ACK 이후 실제 작업 결과는 별도로 확인해야 합니다.

Wake

유휴 상태의 수신 세션에 새 메시지가 있음을 알리고 작업 재개를 돕는 host-specific transport입니다.

메시지 본문과 wake 신호는 분리되어 관리됩니다.

Context Continuity

긴 작업에서 범위, 결정, 미해결 항목과 검증 참조를 checkpoint로 보존하는 기능입니다.

재개 시 무조건 과거 문맥 전체를 주입하는 대신, 필요한 정보만 명시적으로 복원할 수 있게 설계되어 있습니다.

Receipt

Workflow 실행의 상태와 검증 결과를 기록한 구조화된 결과입니다.

Receipt가 존재한다는 사실만으로 모든 내용의 진실성이 자동 보장되는 것은 아닙니다. AGS는 실행 경계와 구조를 검증하고, 실제 산출물의 의미 판단은 전문 스킬과 감사 단계가 담당합니다.