moai spec ドキュメント管理
moai spec は .moai/specs/ ディレクトリの SPEC ドキュメントを管理します。ステータス更新、ドリフト検出、受け入れ基準の照会、EARS/GEARS リント、原子的クローズ、era 監査、アーカイブのサブコマンドを提供します。
| コマンド | 説明 |
|---|---|
moai spec status | SPEC ステータスの更新または一覧表示 |
moai spec drift | frontmatter status と git log 間のドリフト検出 |
moai spec view <SPEC-ID> | 受け入れ基準をツリー構造で照会 |
| `moai spec lint [SPEC-ID | path/to/spec.md |
moai spec close <SPEC-ID> | 原子的 4-phase クローズ (status: completed + progress.md backfill) |
moai spec audit | SPEC era 分類と modern-era ステータスドリフト監査 |
moai spec archive | クローズ済み SPEC を .moai/specs/ の外へアーカイブ |
bash
moai spec status <SPEC-ID> <new-status> # ステータス更新
moai spec status --list # 全 SPEC を一覧表示
moai spec status --sync-git # git log からステータス同期| フラグ | 説明 |
|---|---|
--dry-run | 書き込みなしで変更をプレビュー |
--list | 全 SPEC とステータスを一覧表示 |
--sync-git | main の git log から SPEC ステータスを同期 |
--yes | --sync-git の非対話自動確認 (CI/パイプ必須) |
bash
moai spec drift| フラグ | 説明 |
|---|---|
--json | JSON 形式で出力 |
--exit-code-on-drift | ドリフト検出時に終了コード 1 |
--count | ドリフト件数のみ出力 |
--no-cache | HEAD-SHA 結果キャッシュを迂回して再計算 |
bash
moai spec lint [SPEC-ID | path/to/spec.md | SPEC directory ...]| フラグ | 説明 |
|---|---|
--json | JSON 形式で出力 |
--sarif | SARIF 2.1.0 形式で出力 |
--strict | 警告をエラーとして扱う |
--format <fmt> | 出力形式 (table) |
--baseline <path> | --strict の代わりにリポジトリにチェックインされたルール別ベースラインでゲートする — エラーは常に失敗、ルールの非advisory警告数は記録値を上回った場合のみブロックし、残存する警告総数は出力にそのまま表示される |
--update-baseline | --baseline ファイルを再計算して書き直す(--reason が必須) |
--reason "<text>" | --update-baseline が記録する必須の空でない理由 — 理由が空または未指定の場合は拒否される |
| 引数の形 | 例 |
|---|---|
| SPEC-ID | SPEC-SPC-001 — プロジェクトルート配下の .moai/specs/SPEC-SPC-001/spec.md に解決 (moai spec view と同じ規則) |
| ファイルパス | .moai/specs/SPEC-SPC-001/spec.md |
| SPEC ディレクトリ | .moai/specs/SPEC-SPC-001 — その中の spec.md を読みます |
3 つの形は 1 回の呼び出しで混在できます。引数がなければ従来どおりコーパス全体を走査します。SPEC-ID に見えるのに解決先のファイルがない場合は、文書に対する指摘ではなく 引数エラー (終了コード 3) となり、試したパスを併せて知らせます。
ここから出る警告のうち 2 つは advisory 等級です。ModalityUnjudged は、リンターが判定できない要求事項を黙って見送らずにその事実を知らせます。REQTableRowsRejected は、定義表として読まれなかった表の行を知らせます。どちらも advisory であり、--strict でもエラーに昇格せず、終了コードを変えません。
bash
moai spec close SPEC-IDSPEC を単一コミットで status: completed へ原子的に遷移させます。
| フラグ | 説明 |
|---|---|
--backfill-only | progress.md の backfill のみ実行 |
--dry-run | コミットせずプレビュー |
--force | 確認なしで強制クローズ |
--json | JSON 形式で出力 |
bash
moai spec audit.moai/specs/SPEC-*/ をスキャンして各 SPEC を era ヒューリスティックで分類し、modern-era ステータスドリフトを検出します。
| フラグ | 説明 |
|---|---|
--json | JSON 形式で出力 |
--filter-era <era> | era でフィルタ |
--filter-spec <id> | SPEC ID でフィルタ |
--include-grandfathered | grandfather era SPEC を含める |
--strict | 厳格モード |
bash
moai spec archive --dry-run # 対象確認 (移動なし)
moai spec archive --yes # 計画を適用grace ウィンドウ (デフォルト 90 日) より古い terminal SPEC をアーカイブします。
| フラグ | 説明 |
|---|---|
--dry-run | 移動なしで対象集合を報告 |
--yes | 移動を確定 (適用に必須) |
--grace-days <n> | grace ウィンドウの日数 (0 = デフォルト 90) |
--json | 計画を JSON で出力 |