Communitygithub.com

워크플로우

Freeflow 활동 전반에서 권한, 현재 소유권, 경로 변경, 연속성, 선택된 체크포인트 또는 지원되는 종료(Supported Exit)를 조정해야 할 때 사용합니다.

워크플로우란 무엇인가요?

워크플로우(Workflow)는 외부 상호작용 생애주기(Outer Interaction Lifecycle)를 담당하는 핵심 스킬입니다. 권한을 해석하고 적용하며, 각 경계가 정해진 활동에 대해 단일 현재 소유자(current owner)를 유지하고, 증거가 책임을 변경할 때만 경로를 전환합니다. 체크포인트는 의도적으로 선택하고, 지원되는 종료(Supported Exit)가 정당화되는 시점을 결정합니다. 이 스킬은 모든 작업을 직접 감독하는 대신, 구체적인 작업을 수행하는 소유자(예: Discuss, Execute Work, Commit Work 등)와 그들의 메서드(method)를 조정하는 코디네이터 역할을 합니다. 따라서 권한이 명확하지 않거나, 소유권 이전, 체크포인트 필요성, 작업 중단 등 워크플로우 차원의 결정이 필요할 때 이 스킬을 호출해야 합니다. 플랫폼 독립적으로 사용 가능하며, SKILL.md 문서는 권한 부여, 소유자 선택, 결과 기반 라우팅, 연속성 유지, 체크포인트 선택 및 지원되는 종료 도달에 대한 상세한 지침을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hassan-mohiddin/freeflow/tree/main/skills/workflow

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

워크플로우은(는) 무엇을 하나요?

외부 상호작용 생애주기(Outer Interaction Lifecycle)를 소유합니다. 권한을 해석하고 적용하며, 각 경계가 정해진 활동(bounded activity)에 대해 하나의 현재 소유자를 유지하고, 증거가 책임을 변경할 때만 경로를 전환하며, 체크포인트를 의도적으로 선택하고, 지원되는 종료(Supported Exit)가 정당화되는 시점을 결정합니다.

워크플로우는 권한을 생성하거나 모든 작업을 감독하지 않습니다. 각 소유자와 메서드(method)의 세부 작업을 대체하지 않고 조정합니다.

스킬, 메서드, 렌즈(lens), 도구, 아티팩트(artifact), 리뷰, 체크포인트, 도메인 가이드 또는 컴퓨팅 프로필을 선택한다고 해서 자동으로 권한이 확장되거나 현재 소유자가 변경되지 않습니다.

권한을 통해 진입하기

결과에 영향을 미치는 조치(consequential action)를 취하기 전에 전체 사용자 턴(user turn), 현재 런타임 상태, 그리고 여전히 유효한 사전 승인을 해석합니다.

하나의 활동에 두 가지 이상의 종류가 포함된 경우 공유 용어(Shared Terms) 정의(수동적 관찰, 능동적 증거 생성, 변경 또는 전달)를 사용하여 효과를 누적적으로 분류합니다.

직접적인 요청은 해당 경계 내 결과와 그에 수반되는 도구, 검사, 되돌릴 수 있는 로컬 선택을 승인합니다. 관련 없는 정리, 다른 결과, 별도로 통제되는 효과, 또는 결과가 사용자의 선택을 실질적으로 변경할 수 있는 행동은 승인하지 않습니다.

명세(Spec), 계획(Plan), 작업 기록(Working Record), 인계(Handoff), 리뷰, 권장 사항, 체크포인트, 유용한 증거 또는 침묵은 작업을 제한하거나 보존할 수 있습니다. 어느 것도 권한을 생성하지 않습니다.

능동적 증거 생성, 변경, 전달 또는 현재 권한으로 다루어지지 않는 별도로 통제되는 행동을 수행하기 전에, 사용자에게 그 행동이 필요한 이유, 정확히 무엇이 일어날지, 어떤 증거나 결과를 생성해야 하는지, 그리고 어디서 중단될 것인지 알려야 합니다. 하나의 직접적인 승인 질문을 하고 기다리십시오. 기다리는 동안 제안된 행동이나 의존 작업을 수행하지 마십시오.

권한, 수용된 의도(accepted intent), 또는 효과 경계(effect boundary)가 명확하지 않은 경우, 실행 소유자를 선택하기 전에 해당 경계를 먼저 해결하십시오.

하나의 현재 소유자를 선택하고 유지하기

현재 경계가 정해진 활동(bounded activity)과 일치하는 가장 좁고 발견 가능한 소유자를 선택하십시오. 아래 카테고리는 일반적인 소유자이며 완전한 목록이 아닙니다.

이해 또는 결정

방향이 설계를 수반하는 경우 렌즈로서 깊이를 위한 설계(Design for Depth)를 사용하십시오. 렌즈는 현재 소유자가 되지 않습니다.

내구성 있는 상태(durable state) 생성, 보존 또는 판단

작업 실행, 조사, 검증 또는 판단

TDD, 코드 단순화(Simplify Code), 도메인 지침, 참조 및 도구는 현재 소유자의 메서드를 제공할 수 있지만 다른 소유자가 되지는 않습니다.

보존, 체크포인트, 통합 또는 전달

수정자(modifier) 및 상호작용 제어 적용

우회(Bypass)는 명시적으로 선택된 선택적 워크플로우 압력을 수정합니다. 기본 활동의 소유자가 되지는 않습니다.

소유자가 환경 상호작용이 필요하고 행동 또는 도구 선택이 명확하지 않은 경우, 행동 선택(Action Selection)을 사용하십시오. 이는 관찰과 상태 변경을 동일한 현재 소유자에게 반환합니다.

전문 엔지니어링 지침이 현재 소유자를 지원해야 하는 경우, 도메인 스킬 구성(Domain Skill Composition)을 읽으십시오.

현재 소유자의 질문, 의도된 결과, 권한 및 필요한 관찰 경계가 일관성을 유지하는 동안 현재 소유자를 유지하십시오. 메서드, 도구, 피드백, 프로필 전환 및 환경 상호작용은 그 자체로 소유자 변경을 생성하지 않습니다.

사용자 입력이 결과, 경계, 트레이드오프, 접근 방식 또는 수용을 실질적으로 변경할 수 있는 경우에만 권한 작업 전에 토론(Discuss)을 권장하십시오. 사용 가능한 사실을 검토하고 불필요한 질문 없이 되돌릴 수 있는 로컬 세부 사항을 선택하십시오.

결과에서 경로 설정하기(Route From The Result)

보장된 피드백 루프(Feedback Loop)를 현재 소유자를 통해 실행하십시오. 권한, 소유권, 필요한 증거, 체크포인트 또는 지원되는 종료가 변경되는 경우에만 워크플로우에 다시 진입하십시오.

결과가 현재 지원하는 바에 따라 경로를 설정하십시오:

  • 계속(Continue): 현재 소유자, 의도된 결과, 권한 및 필요한 관찰 경계가 일관성을 유지함.
  • 로컬 수정(Correct locally): 하나의 명확한 결함이 수용된 의도와 효과를 보존함; 이를 생성한 소유자에게 반환하고, 영향을 받는 경계를 재검증하며, 수정된 상태를 자체 리뷰함.
  • 증거 확대(Broaden evidence): 주장이 현재 관찰자를 초과함; 작업 검증(Verify Work)을 사용하거나 누락된 증거 요구 사항을 현재 소유자에게 반환함.
  • 진단(Diagnose): 원인이 불명확하거나, 증거가 충돌하거나, 수정이 반복됨.
  • 토론(Discuss): 가정, 대안, 전략 또는 방향이 실질적으로 변경됨.
  • 결정 게이트(Decision Gate): 하나의 사용자 소유 선택 또는 소스 충돌이 안전한 계속 진행을 차단함.
  • 추적(Track): 내구성 있는 작업 상태를 생성, 복구, 조정하거나 실질적으로 변경해야 함.
  • 아티팩트 수정(Revise an artifact): 수용된 콘텐츠, 전략, 결정 또는 전송 상태가 변경됨; 해당 아티팩트의 소유자에게 반환함.
  • 리뷰(Review): 사실적 지원 후 선택된 판단이 필요함.
  • 체크포인트(Checkpoint): 의존 작업 전에 선택된 경계가 예정됨.
  • 중단 또는 연기(Stop or defer): 안전하고, 승인되었으며, 가치 있는 계속 진행이 더 이상 존재하지 않음.

영향을 받지 않은 결정, 아티팩트, 작업 및 증거는 보존하십시오. 새로운 증거는 그 결과가 적용되는 경우에만 경로를 변경합니다.

구현이 시작되었다고 계속 진행하거나, 지원되지 않는 작업을 준비된 것으로 리뷰하거나, 하나의 책임이 변경되었다고 작업을 다시 시작하거나, 유용한 다음 행동이 묵시적 권한이 되도록 두지 마십시오.

의도적으로 연속성 보존하기

현재 작업 상태를 잃는 것이 나중에 정렬 불일치를 초래할 수 있는지 결정하십시오.

결정, 증거, 권한, 현재 작업, 차단기, 체크포인트 또는 다음 유용한 행동에 내구성 있는 복구가 필요한 경우 작업 추적(Track Work)을 사용하십시오. 단순히 작업이 발생했다는 이유만으로 짧고 일회성 활동에 대해 작업 기록(Working Record)을 생성하지 마십시오.

압축, 요약, 세션 탐색 또는 소유권 이전 후 작업 기록이 존재하는 경우:

  1. 기록 복구 및 조정을 작업 추적(Track Work)을 통해 라우팅하고,
  2. 복구된 메모리를 현재 사용자 턴 및 관련 실시간 상태와 비교하며,
  3. 실제로 활동을 계속하는 소유자에게 반환합니다.

복구 후, 정확한 메서드가 없는 경우 현재 소유자의 스킬을 다시 읽고, 다음 결정에 필요한 소스 또는 기록만 다시 열며, 유효한 현재 세션 소스에서 권한을 재설정합니다.

작업 추적(Track Work)은 기록 보기, 스키마, 변경 및 생애주기 메커니즘을 소유합니다. 워크플로우는 이를 재생산하지 않습니다.

요약, 과거 스킬 본문, 작업 기록, 계획(Plan) 또는 인계(Handoff)는 컨텍스트를 보존합니다. 현재 권한을 생성하거나, 실시간 상태를 증명하거나, 프로필 라우팅 상태가 되지는 않습니다.

체크포인트 선택 및 라우팅

해결되지 않은 체크포인트를 넘어서는 것이 의존 작업, 롤백, 출처, 전송, 통합 또는 전달을 실질적으로 위험에 빠뜨릴 수 있는 경우에만 체크포인트를 선택하십시오.

체크포인트는 다음을 요구할 수 있습니다:

  • 사용자 결정;
  • 선택된 독립 리뷰;
  • 로컬 커밋;
  • 연속성 전송;
  • 브랜치 통합;
  • 릴리스;
  • 론칭.

일시 중지, 상태 업데이트, 경계가 정해진 활동의 종료, 완료된 구현, 검사 통과 또는 자체 리뷰는 자동으로 체크포인트를 생성하지 않습니다.

워크플로우는 체크포인트와 그것이 보호하는 경계를 선택합니다. 해당 소유자가 이를 수행합니다. 내구성 있는 메모리가 존재하는 경우 작업 추적(Track Work)이 선택과 결과를 보존합니다.

자체 리뷰는 일반적인 피드백 루프의 일부로 남아 있으며 절대 체크포인트가 아닙니다.

작업 리뷰(Review Work)는 리뷰 역할, 발견 사항, 중재, 판단 및 주기 제한을 소유합니다. 워크플로우는 반환된 결과를 소비하고 어떤 책임이 뒤따를지 결정합니다. 리뷰 보고서, 발견 사항, 판단 또는 제안된 해결 방법은 수정 또는 다른 리뷰를 승인하지 않습니다.

체크포인트 증거 또는 조건이 더 이상 유효하지 않은 경우, 체크포인트를 강제하지 말고 편차를 반환하십시오. 명시적인 지원 경로를 통해서만 선택된 체크포인트를 취소, 대체, 연기 또는 수정하고, 내구성 있는 상태가 있는 경우 조정하십시오.

자동 리뷰-수정-리뷰 루프를 생성하지 마십시오. 통과(Pass)를 얻기 위해 계속 편집하지 마십시오.

커밋, 인계, 통합, 푸시, 릴리스 또는 론칭은 권한 범위가 명시적으로 포함하지 않는 한 별도로 통제된 상태로 유지됩니다.

지원되는 종료에 도달하기

지원되는 종료(Supported Exit)는 응답, 대기, 일시 중지, 인계, 연기, 통제된 경계 보존, 중단 또는 완료를 의미할 수 있습니다.

다음 조건이 모두 충족될 때만 완료를 주장하십시오:

  • 새로운 증거가 필요한 경계에서 수용된 결과를 지원함;
  • 완료된 모든 경계 활동이 해결되지 않은 중요한 문제 없이 필요한 자체 리뷰를 받음;
  • 선택된 리뷰와 체크포인트가 해결됨;
  • 작업 메모리와 필요한 아티팩트가 지원되는 상태를 정확하게 설명함;
  • 숨겨진 실질적 모순, 소스 충돌, 차단기 또는 사용자 소유 결정이 없음;
  • 별도로 통제되는 행동이 완료된 것으로 암시되지 않음.

비례하여 보고하십시오:

  • 지원되는 결과;
  • 가장 강력한 증거와 증명 한계;
  • 해결되지 않거나 연기된 중요한 상태;
  • 작업이 계속되거나 대기 중인 경우 현재 경로.

다음 행동에 대한 권장 사항은 이를 승인하지 않습니다.

중단

다음 조건 중 하나가 충족되면 워크플로우를 중단하십시오:

  • 지원되는 종료에 도달함; 또는
  • 하나의 현재 소유자가 해결되지 않은 권한, 소유권, 체크포인트, 연속성 또는 경로 질문 없이 계속 진행할 수 있음.

피드백 또는 증거가 이러한 경계 중 하나를 변경하는 경우에만 워크플로우를 재개하십시오.

관련 스킬