---
title: 中断と再開
description: 途中で止まった作業をどこから再開できるのか、進捗はどのファイルに記録されているのか
seo:
  image: /ogp.png
---

長いパイプラインは、途中で止まります。セッションが切れることもあれば、
レビューでブロッカーが出て人の判断待ちになることもあります。
NexusArchitectは、進捗をファイルに書きながら進むので、**同じコマンドをもう一度打てば続きから再開します**。

進捗の記録場所は、productパイプラインとバックログ側で別々です。

| 記録ファイル | 誰が書くか | 何が入っているか |
|---|---|---|
| `work/pipeline-progress.json` | `/product:start`と各フェーズ | フェーズごとの状態(`pending` / `in_progress` / `completed` / `failed` / `skipped`)、検証ゲートの判定、出力先 |
| `reports/backlog/backlog-manifest.json` | `export-backlog`と実装系スキル | Epic・Sub-Epic・Issueごとの`impl.status`と、作成済みIssueのURL |
| GitLab/GitHubの`status::*`ラベル | 実装系スキル | 各Issueの現在の段階。[ステータスラベルの状態機械](/concepts/status-labels)を参照 |

## 今どこにいるかを見る

```
/product:report-status --once
```

フェーズごとの状態、宣言された出力ファイルがいくつ存在するか、検証ゲートの判定、
そして次に打つべきスラッシュコマンドまで表示されます。
`--once`を付けると1回だけ描画します(付けない場合は10秒ごとに更新されるライブ画面になります)。

productパイプライン以外の状況も、同じ画面のタブ切り替え(Tabキー)で見られます。
Architect(architectパイプライン)、Code Generation、Backlog Deliveryの3つです。
画面の詳しい読み方は[ライブダッシュボード](/concepts/live-dashboard)を参照してください。

## 企画(product)を再開する

```
/product:start --profile=<前回と同じプロファイル>
```

`pipeline-progress.json`で`completed`になっているフェーズは飛ばされ、
止まったところから続きます。プロファイルは前回と同じものを指定してください。
違うプロファイルを渡すと、実行するフェーズの範囲そのものが変わります。

## バックログを再開する

`export-backlog`は**何度実行しても同じ結果になる**ように作られています。
すでに`remote.url`(作成済みIssueへのリンク)が記録されているアイテムは飛ばすので、
同じIssueが二重に作られることはありません。

実装から先は、Issueごとの段階を見て再開します。

```
/architect:deliver-backlog --epic=E1
```

完了したIssueは飛ばされ、途中のIssueはその段階から続きます。
どの段階から入るかは`impl.status`と`status::*`ラベルから判断されるので、通常は指定不要です。
判断を上書きしたいときだけ`--from`を使います。

```
/architect:deliver-backlog --epic=E1 --from=review
```

:::note[状態の読み取り元は決まっています]
再開時に見るのは`impl.status`とトラッカーの`status::*`ラベルです。
manifestの`labels`配列は`export-backlog`が作成時に書いた初期値で、作業が進んでも更新されません。
また、Markdownのチェックボックスも状態の入力元ではありません([チェックリストの三重構造](/concepts/checklist-contract))。
`impl.status`とラベルが食い違った場合は、**トラッカー側が正**として扱われ、manifestが更新されます。
:::

## ブロッカーで止まった場合

`review-issue`の自動修正ループが上限(既定3回)に達しても直らなかった場合、
Issueは`status::blocked`になり、判断を求めるコメントが書き込まれます。
これは異常終了ではなく、人が決めるべきところまで来たという合図です。
コメントの内容に対応したら、同じコマンドで再開できます。

:::warning[shared-contextパックが古いとき]
`reports/`の設計ドキュメントを書き換えたあとは、[Shared-Contextパック](/concepts/shared-context)が
古い内容のままになっています。作り直すには`--build-context`を付けてください。

```
/architect:implement-backlog --build-context
```
:::