워크플로 실행

이 장에서 다루는 것

지식 베이스가 준비되면 Workflow 탭에서 A-SPICE 산출물 생성을 시작합니다. 이 장은 V-모델 화면을 읽는 법, Run 패널에서 실행 조건을 정하는 법, 실행이 시작된 뒤 SYS.1부터 SYS.5까지 11 단계가 차례로 진행되는 모습, 실행이 끝난 뒤의 화면, 그리고 Documents 탭에서 생성된 문서를 여는 법을 다룹니다.

• 대상 독자: 지식 베이스 구축을 마치고 첫 산출물 생성을 시작하려는 사용자
• 선행 조건: 앞 장에서 지식 베이스 구축(Source Ingest)을 끝낸 워크스페이스, 그리고 헤더의 AI 상태가 초록 점(연결됨)인 것

실행에는 Claude 연결이 필요하고 과금이 발생합니다. AI가 연결되어 있지 않으면 Run 패널에 Running the workflow requires a Claude connection · Connect → 가 표시되고 Start run 이 비활성화됩니다. 실행 중 각 단계가 Claude를 호출하며, 소요 시간과 비용의 사전 추정치는 앱 어디에도 없습니다.

V-모델 화면

1. 프로젝트 화면 상단의 ① Workflow 탭을 누릅니다.
2. 화면 가운데에 V-모델이 보입니다. 각 노드는 A-SPICE 프로세스(SYS.1 … SYS.5, SWE.1 … SWE.6)이고, 노드 이름 아래의 약어(StRS, SyRS …)는 그 단계가 만드는 산출물입니다. 실제로 가장 먼저 실행될 단계에 Start 배지가 붙습니다.
3. 오른쪽 위의 ② Run 을 누르면 실행 조건을 정하는 Run 패널이 열립니다.

① Workflow 탭을 열면 V-모델이 보입니다. 왼쪽 위 SYS.1에 Start 배지가 붙어 있어 실행이 여기서 시작됨을 알 수 있습니다. ② Run 을 누르면 오른쪽에 Run 패널이 열립니다.

V-모델의 11 단계와 산출물은 다음과 같습니다.

단계	약어	산출물
SYS.1	StRS	Stakeholder Requirements
SYS.2	SyRS	System Requirements Specification
SYS.3	SyAD	System Architecture
SWE.1	SwRS	SW Requirements Specification
SWE.2	SwAD	SW Architecture Document
SWE.3	SwDD	SW Detailed Design Document
SWE.4	SwUVS	SW Unit Verification Measure Specification
SWE.5	SwIVS	SW Integration and Component Verification Measure Specification
SWE.6	SwVS	SW Verification Measure Specification
SYS.4	SyIVS	System Integration Verification Measure Specification
SYS.5	SyVS	System Verification Measure Specification

화면 위쪽의 칩(Whole V-model, SYS.1-3 · SWE.1-3, SWE.4-6 · SYS.4-5, System level, Software level)은 화면을 그 영역으로 이동(줌)할 뿐, 실행할 단계를 고르지 않습니다. 오른쪽 위의 Publish 버튼은 현재 버전에서 아무 동작도 하지 않으며, Auto-saved · Not published 는 상태와 무관한 고정 문구입니다.

Run 패널에서 실행 조건 정하기

1. ① SYSTEM NAME 에 문서가 설명할 시스템의 이름을 입력합니다. 이 이름이 생성 문서의 제목과 파일 이름이 됩니다. 입력하면 그 아래에 Outputs/SyRS_<이름>_<언어>.md 형태의 경로가 미리 보입니다.
2. MODEL 은 단계별로 쓸 Claude 모델과 effort입니다(Claude opus · medium 처럼 표시). 모델은 opus / sonnet / haiku, effort는 low / medium / high이며, 기본값은 모든 생성 단계에서 opus · medium입니다.
3. ② OUTPUT 에서 산출물 언어를 고릅니다. English (en) 과 Korean (ko) 중 하나이며 기본값은 English입니다. 선택한 언어는 파일 이름의 _en / _ko 접미사가 됩니다.
4. AUDIT 는 기본값 On 으로 둡니다. Off 로 하면 검증 패스를 건너뛰어 더 빠르고 싸지만, 결과에 not release-eligible 경고가 붙습니다.
5. ③ RUN PLAN 에서 실행할 단계를 확인합니다. 이 예에서는 11 단계가 모두 켜져 있고 요약이 11 run · 0 skipped 로 표시됩니다. 각 행의 토글로 단계를 끌 수 있습니다.
6. ④ Start run 을 누릅니다. 버튼은 In progress 로 바뀌고, 실행이 끝나면 Done 이 됩니다.

① SYSTEM NAME 에 test 를 넣으면 그 아래에 Outputs/SyRS_test_en.md 가 미리 보입니다. 이 화면의 MODEL 은 Claude sonnet · medium 으로 바꿔 둔 상태입니다. ② OUTPUT 은 English (en), AUDIT 는 On 이고, ③ RUN PLAN 은 11 run · 0 skipped 로 11 단계가 모두 켜져 있습니다. ④ Start run 으로 실행을 시작합니다.

진행 확인

1. 실행이 시작되면 첫 단계인 SYS.1 노드 위에 ① Running 배지가 붙고, 화면 위쪽에 ② 진행 배너가 나타납니다. 배너에는 단계 이름(StRS), 진행 문구(예: plan 0/3 · dispositions 1/3), 모델·effort가 표시되고 Open / Pause / Stop 버튼이 있습니다.

① SYS.1 노드에 Running 배지가 붙었고, ② 진행 배너에 StRS, plan 0/3 · dispositions 1/3, sonnet · medium 이 보입니다. Run 패널의 버튼은 In progress 로 바뀌어 있습니다.

2. 진행 문구는 <페이즈> <현재>/<전체> · <메모> 형식입니다. 페이즈 이름은 엔진이 내보내는 plan, materialize/analyze, fill, validate, audit, repair, write이고, 예를 들어 StRS plan 0/3 · dispositions 1/3 은 plan 페이즈에서 disposition 3 개 중 1 번째를 처리 중이라는 뜻입니다.
3. SYS.1이 끝나면 노드에 ① 완료 체크가 표시되고 SYS.2에 ② Running 배지가 옮겨 갑니다. 배너의 단계 이름도 SyRS 로 바뀝니다.

① SYS.1의 완료 체크와 ② SYS.2의 Running 배지. 배너는 SyRS fill 124/129 · fill:intro 를 보여 줍니다 — SyRS 문서의 슬롯 129 개 중 124 번째(intro)를 채우는 중입니다.

일시정지와 중지. 배너의 Pause 는 진행 중인 호출이 끝난 뒤 멈추고(결과는 paused), Stop 은 같은 방식으로 멈추되 canceled 로 기록됩니다. 여러 단계를 잇는 실행은 멈춘 단계에서 중단되고 남은 단계는 실행되지 않습니다. 앱을 껐다 켜면 워크플로 실행은 이어지지 않습니다 — 다시 시작하려면 Start run 을 다시 누릅니다(Ingest는 이와 달리 재시작 후 이어서 실행할 수 있습니다).

단계별 진행 화면

SYS.2가 끝나면 같은 방식으로 SYS.3 → SWE.1 → SWE.2 → SWE.3 → SWE.4 → SWE.5 → SWE.6 → SYS.4 → SYS.5 순으로 Running 배지가 옮겨 가고, 끝난 단계에는 완료 체크가 남습니다. 아래는 각 단계가 실행 중일 때의 화면입니다. 배너의 진행 문구와 수치는 실행마다 다르므로 예시로만 보세요.

① SYS.3 노드의 Running 배지, ② 배너의 단계 이름 SyAD. SYS.1·SYS.2에는 완료 체크가 남아 있습니다.

① SWE.1 노드의 Running 배지, ② 배너의 SwRS. 여기서부터 소프트웨어 단계(SWE.1 … SWE.6)입니다.

① SWE.2 노드의 Running 배지, ② 배너의 SwAD. 배너의 fill 1/8 · fill:intro 는 fill 페이즈가 슬롯 8 개 중 첫 번째(intro)를 채우는 중이라는 뜻입니다(예시).

① SWE.3 노드의 Running 배지, ② 배너의 SwDD. V-모델 왼쪽(하강) 팔의 맨 아래입니다.

SWE.3이 끝나면 Documents 탭이 채워집니다. 생성 문서 사이트는 SW Detailed Design(SWE.3)이 끝날 때 자동으로 만들어집니다. 그 전에 Documents 탭을 열면 No documents generated yet. They are built automatically when SW Detailed Design (SWE.3) finishes — until then the raw markdown is readable on the Files tab. 가 표시되고, 그때까지의 산출물은 Files 탭에서 Markdown으로 읽을 수 있습니다.

① SWE.4 노드의 Running 배지, ② 배너의 SwUVS. V-모델의 오른쪽 팔에서는 배지가 위쪽 노드에 일부 가려집니다. 오른쪽 아래에는 앞 단계 SWE.3의 완료 알림이 떠 있습니다.

① SWE.5 노드의 Running 배지, ② 배너의 SwIVS.

① SWE.6 노드의 Running 배지, ② 배너의 SwVS.

① SYS.4 노드의 Running 배지, ② 배너의 SyIVS. 다시 시스템 단계로 돌아왔습니다.

① SYS.5 노드의 Running 배지, ② 배너의 SyVS. 마지막 단계이며, 나머지 10 개 노드에는 모두 완료 체크가 있습니다.

실행 완료

1. 마지막 단계 SYS.5가 끝나면 Running 배지와 진행 배너가 사라지고, 11 개 노드 모두에 완료 체크가 표시됩니다. Run 패널의 버튼은 Done 으로 바뀝니다.
2. 각 단계의 산출물은 워크스페이스의 Outputs/<약어>_<시스템 이름>_<언어>.md 에 있습니다(예: SYS.2의 산출물은 Outputs/SyRS_test_en.md). Files 탭의 폴더 트리에서 열어 볼 수 있습니다.

11 개 노드 모두에 완료 체크가 표시되고, Running 배지와 배너는 더 이상 없습니다. 왼쪽 위 SYS.1의 Start 배지는 실행 계획의 첫 단계를 가리키는 표시라 그대로 남아 있습니다.

Documents 탭에서 생성 문서 보기

1. ① Documents 탭을 누릅니다. 이 탭은 워크스페이스의 Outputs/DocSite/site/index.html 에 만들어진 생성 문서 사이트를 그대로 보여 줍니다. Markdown을 다시 렌더링하는 것이 아니라서 사이드바·페이지별 목차·검색·문서 간 링크는 모두 그 사이트 안에서 동작합니다.
2. ② 왼쪽 사이드바의 문서 목록에서 볼 문서를 고릅니다.
3. 이 탭은 파일 변화를 스스로 감시하지 않습니다. SWE.3이 끝나기 전부터 열어 둔 상태였다면 Check again 을 눌러 다시 읽습니다.

① Documents 탭을 열면 생성 문서 사이트(DocSite)가 보입니다. ② 왼쪽 사이드바에 단계별 문서(StRS-test, SyRS-test …)가 나열되고, 가운데에 첫 문서인 StRS가, 오른쪽에 그 문서의 목차가 표시됩니다. 위쪽의 Search (/) 는 문서 사이트의 검색창입니다.

docx·PDF 내보내기는 없습니다. 생성 문서를 다른 형식으로 내보내는 기능은 현재 버전에 없습니다. 파일은 워크스페이스의 Outputs/ 아래 Markdown과 Outputs/DocSite/site/ 아래 HTML로 남아 있습니다.

다음 단계

산출물 파일 이름에 들어가는 시스템 이름에 영문자·숫자·.·_·- 이외의 문자가 있으면 _ 로 바뀝니다. 여기까지가 PAVE 첫 실행 가이드입니다.