---
name: mspec-delta
description: delta step of mspec workflow — generate Delta Spec with auto-numbered FR-NNN
when_to_use: User runs /mspec:delta, or workflow auto-continues to delta
---

<!-- @mspec-delta 2026-05-15-063805-fix-command-name-consistency/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-017 -->
<!-- Change: fix-command-name-consistency -->

<!-- @mspec-delta 2026-05-15-040857-step-checkbox-update/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-015 -->
<!-- Change: step-checkbox-update -->

<!-- @mspec-delta 2026-05-17-214224-fix-locale-spec-language/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-021 -->
<!-- Change: fix-locale-spec-language -->

## Procedure

1. Run `mspec status --change <change-dir> --json` first.
2. Read `proposal.md` → extract capability names from `## Capabilities (touched)`.
3. For each capability, run `mspec delta init --capability <name> --change <change-dir>`. The CLI auto-numbers FR-NNN by reading existing `specs/<name>/spec.md`.
4. Edit each generated `changes/<change-dir>/specs/<capability>/spec.md`:
   - Replace placeholders in `### Requirement: FR-NNN — <Short Title>` headers (H3).
   - Write the Requirement body in **EARS format** using RFC 2119 keywords with the following semantics (per Constitution):
     - `SHALL` — 機能要件（system の振る舞いを規定するデフォルト）
     - `MUST` — 制約・安全要件（絶対的強制または禁止）
     - `SHOULD` — 推奨（逸脱可能だが理由が必要）
     - `MAY` — 任意（オプション機能）
   - EARS pattern guidance — read `"locale"` from the `mspec status --json` output (step 1) and use the matching format:
     - **locale=ja の場合**:
       - Ubiquitous: `このシステムは SHALL <振る舞い>.`
       - Event-Driven: `<トリガー> のとき、このシステムは SHALL <振る舞い>.`
       - State-Driven: `<状態> の間、このシステムは SHALL <振る舞い>.`
       - Unwanted Behavior: `<条件> の場合、このシステムは SHALL <振る舞い>.`
       - Optional Feature: `<機能> が有効な場合、このシステムは SHALL <振る舞い>.`
     - **locale=en の場合**（locale フィールドが undefined の場合も含む）:
       - Ubiquitous: `The system SHALL <response>.`
       - Event-Driven: `When <trigger>, the system SHALL <response>.`
       - State-Driven: `While <state>, the system SHALL <response>.`
       - Unwanted Behavior: `If <condition>, then the system SHALL <response>.`
       - Optional Feature: `Where <feature>, the system SHALL <response>.`
   - Add at least one `#### Scenario: <Name>` (must be H4) with `- GIVEN`, `- WHEN`, `- THEN` bullets nested inside each Requirement.
5. `readme.md` の `## Artifacts` 節の `- [ ] specs/*/spec.md (Delta Spec)` を `- [x] specs/*/spec.md (Delta Spec)` に更新する。
6. Run `mspec validate --change <change-dir>` (validates FR-ID uniqueness and H4 Scenarios). validate が失敗した場合は `- [x] specs/*/spec.md (Delta Spec)` を `- [ ] specs/*/spec.md (Delta Spec)` にロールバックする。
7. `block: false` — auto-continue via `/mspec:continue`.

## Verification (C2)

- `mspec validate --change <change>` — アーティファクト整合性チェック
- `mspec anchor check --change <change>` — アンカー解決確認
- `mspec spec lint` — Delta Spec実装詳細漏洩チェック

## Learning (C3)

このスキルの実行で発生した学習候補を記録する:

```
<!-- LEARNING: <パターン説明> | source: <FR-ID> | confidence: low|medium|high -->
```

`mspec learn` コマンドが archive 済み changes からこれらを収集してpost-condition候補をproposeする。