okstra 0.122.0 → 0.123.0

package/runtime/schemas/final-report-v1.0.schema.json

@@ -408,6 +408,7 @@
           "minItems": 1,
           "items": { "$ref": "#/$defs/ImplementationPlanStage" }
         },
+        "designPreparation": { "$ref": "#/$defs/DesignPreparation" },
         "stepwiseExecution": {
           "description": "Legacy flat summary kept for compatibility only. New reports use stageMap/stages.",
           "type": "array",
@@ -1296,6 +1297,337 @@
       }
     },
 
+    "DesignPreparation": {
+      "type": "object",
+      "required": ["mode", "reason", "items"],
+      "additionalProperties": false,
+      "properties": {
+        "mode": { "enum": ["assessed", "no-design-inputs"] },
+        "reason": { "type": "string", "minLength": 1 },
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DesignPrepItem" }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "mode": { "const": "no-design-inputs" } }
+          },
+          "then": { "properties": { "items": { "maxItems": 0 } } }
+        }
+      ]
+    },
+
+    "DesignPrepKnownFact": {
+      "type": "object",
+      "required": ["statement", "evidence"],
+      "additionalProperties": false,
+      "properties": {
+        "statement": { "type": "string", "minLength": 1 },
+        "evidence": { "type": "string", "minLength": 1 }
+      }
+    },
+
+    "DesignPrepProposal": {
+      "type": "object",
+      "required": ["summary", "details", "assumptions", "evidence", "confidence"],
+      "additionalProperties": false,
+      "properties": {
+        "summary": { "type": "string", "minLength": 1 },
+        "details": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "assumptions": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "confidence": { "enum": ["low", "medium", "high"] }
+      }
+    },
+
+    "DesignPrepHumanConfirmation": {
+      "type": "object",
+      "required": ["required", "reason", "suggestedAction"],
+      "additionalProperties": false,
+      "properties": {
+        "required": { "type": "boolean" },
+        "reason": { "type": "string", "minLength": 1 },
+        "suggestedAction": { "type": "string", "minLength": 1 }
+      }
+    },
+
+    "DesignPrepReviewPoint": {
+      "type": "object",
+      "required": ["phase"],
+      "additionalProperties": false,
+      "properties": {
+        "phase": { "enum": ["implementation", "final-verification"] },
+        "stage": { "type": "integer", "minimum": 1 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "phase": { "const": "implementation" } } },
+          "then": { "required": ["stage"] }
+        }
+      ]
+    },
+
+    "DesignPrepItem": {
+      "type": "object",
+      "required": [
+        "id",
+        "kind",
+        "title",
+        "stageRefs",
+        "status",
+        "need",
+        "knownFacts",
+        "openQuestions",
+        "aiProposal",
+        "humanConfirmation"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^PREP-[0-9]{3}$" },
+        "kind": {
+          "enum": [
+            "domain-contract",
+            "persistence-schema",
+            "external-interface",
+            "transaction-consistency",
+            "transformation-mapping",
+            "lifecycle-state-machine",
+            "rollout-observability",
+            "manual-user-test",
+            "other"
+          ]
+        },
+        "title": { "type": "string", "minLength": 1 },
+        "stageRefs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "integer", "minimum": 1 }
+        },
+        "status": {
+          "enum": ["ready", "provisional", "blocked", "not-applicable"]
+        },
+        "need": { "type": "string", "minLength": 1 },
+        "knownFacts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DesignPrepKnownFact" }
+        },
+        "openQuestions": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "aiProposal": { "$ref": "#/$defs/DesignPrepProposal" },
+        "humanConfirmation": {
+          "$ref": "#/$defs/DesignPrepHumanConfirmation"
+        },
+        "workingAssumption": { "type": "string", "minLength": 1 },
+        "guardrails": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "reviewAt": { "$ref": "#/$defs/DesignPrepReviewPoint" },
+        "ifStillOpen": { "enum": ["block", "follow-up"] },
+        "requestPath": {
+          "type": "string",
+          "pattern": "^design-prep-requests/design-prep-request-[0-9]+-PREP-[0-9]{3}\\.md$"
+        },
+        "blockReason": { "type": "string", "minLength": 1 },
+        "requiredDecision": { "type": "string", "minLength": 1 },
+        "notApplicableReason": { "type": "string", "minLength": 1 },
+        "replanTriggerFields": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[^.\\s]+(\\.[^.\\s]+)*$"
+          }
+        }
+      },
+      "oneOf": [
+        {
+          "properties": { "status": { "const": "ready" } },
+          "allOf": [
+            { "not": { "required": ["workingAssumption"] } },
+            { "not": { "required": ["blockReason"] } },
+            { "not": { "required": ["requiredDecision"] } },
+            { "not": { "required": ["notApplicableReason"] } },
+            { "not": { "required": ["requestPath"] } }
+          ]
+        },
+        {
+          "properties": { "status": { "const": "provisional" } },
+          "required": [
+            "workingAssumption",
+            "guardrails",
+            "reviewAt",
+            "ifStillOpen",
+            "requestPath"
+          ],
+          "allOf": [
+            { "not": { "required": ["blockReason"] } },
+            { "not": { "required": ["requiredDecision"] } },
+            { "not": { "required": ["notApplicableReason"] } }
+          ]
+        },
+        {
+          "properties": {
+            "status": { "const": "blocked" },
+            "humanConfirmation": {
+              "properties": { "required": { "const": true } }
+            }
+          },
+          "required": [
+            "blockReason",
+            "requiredDecision",
+            "reviewAt",
+            "ifStillOpen",
+            "requestPath"
+          ],
+          "allOf": [
+            { "not": { "required": ["workingAssumption"] } },
+            { "not": { "required": ["guardrails"] } },
+            { "not": { "required": ["notApplicableReason"] } }
+          ]
+        },
+        {
+          "properties": { "status": { "const": "not-applicable" } },
+          "required": ["notApplicableReason"],
+          "allOf": [
+            { "not": { "required": ["workingAssumption"] } },
+            { "not": { "required": ["guardrails"] } },
+            { "not": { "required": ["reviewAt"] } },
+            { "not": { "required": ["ifStillOpen"] } },
+            { "not": { "required": ["blockReason"] } },
+            { "not": { "required": ["requiredDecision"] } },
+            { "not": { "required": ["requestPath"] } }
+          ]
+        }
+      ]
+    },
+
+    "TriggerEvidence": {
+      "type": "object",
+      "required": ["step", "field", "match"],
+      "additionalProperties": false,
+      "properties": {
+        "step": {
+          "type": ["integer", "null"],
+          "minimum": 1
+        },
+        "field": { "enum": ["files", "action"] },
+        "match": { "type": "string", "minLength": 1 }
+      }
+    },
+
+    "InlineDesignContract": {
+      "type": "object",
+      "required": ["summary", "details", "evidence"],
+      "additionalProperties": false,
+      "properties": {
+        "summary": { "type": "string", "minLength": 1 },
+        "details": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "evidence": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+
+    "DesignSurfaceCoverage": {
+      "type": "object",
+      "required": ["kind", "triggerEvidence", "disposition"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "enum": [
+            "domain-contract",
+            "persistence-schema",
+            "external-interface",
+            "transaction-consistency",
+            "transformation-mapping",
+            "lifecycle-state-machine",
+            "rollout-observability",
+            "manual-user-test",
+            "other"
+          ]
+        },
+        "triggerEvidence": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/TriggerEvidence" }
+        },
+        "disposition": {
+          "enum": ["inline-contract", "prep-item", "not-applicable"]
+        },
+        "inlineContract": { "$ref": "#/$defs/InlineDesignContract" },
+        "prepItemId": {
+          "type": "string",
+          "pattern": "^PREP-[0-9]{3}$"
+        },
+        "prepItemIds": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^PREP-[0-9]{3}$" }
+        },
+        "rationale": { "type": "string", "minLength": 1 }
+      },
+      "oneOf": [
+        {
+          "properties": { "disposition": { "const": "inline-contract" } },
+          "required": ["inlineContract"],
+          "allOf": [
+            { "not": { "required": ["prepItemId"] } },
+            { "not": { "required": ["prepItemIds"] } },
+            { "not": { "required": ["rationale"] } }
+          ]
+        },
+        {
+          "properties": { "disposition": { "const": "prep-item" } },
+          "allOf": [
+            { "not": { "required": ["inlineContract"] } },
+            { "not": { "required": ["rationale"] } }
+          ],
+          "oneOf": [
+            {
+              "required": ["prepItemId"],
+              "not": { "required": ["prepItemIds"] }
+            },
+            {
+              "required": ["prepItemIds"],
+              "not": { "required": ["prepItemId"] }
+            }
+          ]
+        },
+        {
+          "properties": { "disposition": { "const": "not-applicable" } },
+          "required": ["rationale"],
+          "allOf": [
+            { "not": { "required": ["inlineContract"] } },
+            { "not": { "required": ["prepItemId"] } },
+            { "not": { "required": ["prepItemIds"] } }
+          ]
+        }
+      ]
+    },
+
     "ImplementationPlanStage": {
       "type": "object",
       "required": [
@@ -1364,6 +1696,10 @@
           "maxItems": 6,
           "items": { "$ref": "#/$defs/StageStepRow" }
         },
+        "designSurfaceCoverage": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DesignSurfaceCoverage" }
+        },
         "exitContract": { "type": "string", "minLength": 1 },
         "stageValidation": { "type": "string", "minLength": 1 }
       }

package/runtime/skills/okstra-inspect/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: okstra-inspect
 description: >-
-  Use this for everything that happens AFTER a single okstra task has already run — inspecting it or light bookkeeping on it, never launching new work. The tell is usually a named task id (PROD-1623, dev-9184), often dropped without the word "okstra." Reach for it when the user wants one task's: status, current/next phase, blockers, or approval gate; its final report — where it is or whether it passed (결론·통과); its elapsed time (소요 시간) or context/read cost (컨텍스트 비용); its run history, re-run, or resume; to mark it done / in-progress / blocked / todo; or a failed run's error logs gathered into a report (에러 리포트). Also bundles cross-project okstra errors into an anonymized feedback zip (에러 환류). Use it even for a bare "mark it done" or "where's the report." NOT for starting a run (okstra-run), rollups/schedules (okstra-rollup / okstra-schedule), a brief (okstra-brief-gen), setup (okstra-setup), or cross-project management (okstra-manager).
+  Use this for everything that happens AFTER a single okstra task has already run — inspecting it or light bookkeeping on it, never launching new work. The tell is usually a named task id (PROD-1623, dev-9184), often dropped without the word "okstra." Reach for it when the user wants one task's: status, current/next phase, blockers, or approval gate; its final report — where it is or whether it passed (결론·통과); its elapsed time (소요 시간) or context/read cost (컨텍스트 비용); its run history, re-run, or resume; to mark it done / in-progress / blocked / todo; or a failed run's error logs gathered into a report (에러 리포트). Also bundles cross-project okstra errors into an anonymized feedback zip (에러 환류). Use it even for a bare "mark it done" or "where's the report." NOT for starting a run (okstra-run), rollups/schedules (okstra-rollup / okstra-schedule-gen), a brief (okstra-brief-gen), setup (okstra-setup), or cross-project management (okstra-manager).
 ---
 
 # OKSTRA Inspect
@@ -186,7 +186,7 @@ Confirm in Korean:
 
 Annotate inferred values with `(inferred)` or `(default)`. Do not back-fill on read; only write when the user explicitly issues an update.
 
-**Catalog sync note:** the CLI updates `task-manifest.json` only. `discovery/task-catalog.json` may be stale until the next run regenerates it; downstream consumers (e.g. `okstra-schedule`) re-read each manifest directly.
+**Catalog sync note:** the CLI updates `task-manifest.json` only. `discovery/task-catalog.json` may be stale until the next run regenerates it; downstream consumers (e.g. `okstra-schedule-gen`) re-read each manifest directly.
 
 ---
 

package/runtime/skills/okstra-rollup/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: okstra-rollup
 description: |
-  Use when the user wants run results from MULTIPLE okstra tasks collected and summarized at once — a task-group digest or a whole-project roll-up, not a single task. Aggregates per-task run count, elapsed time, error count, and latest report path, plus group-level totals and status/category/phase tallies, then synthesizes a cross-task prose summary from the report files. Make sure to use this skill whenever the user mentions "okstra rollup", "롤업", "task-group 요약", "그룹 단위 리포트", "여러 task 결과 모아", "전체 task 현황 요약", "cross-task summary", "그룹 종합 리포트", "모든 task 정리", "run 결과 한꺼번에", even if they don't say "rollup". For a SINGLE task's report/time/errors/recap use okstra-inspect instead; for a forward-looking work plan over non-done tasks use okstra-schedule.
+  Use when the user wants run results from MULTIPLE okstra tasks collected and summarized at once — a task-group digest or a whole-project roll-up, not a single task. Aggregates per-task run count, elapsed time, error count, and latest report path, plus group-level totals and status/category/phase tallies, then synthesizes a cross-task prose summary from the report files. Make sure to use this skill whenever the user mentions "okstra rollup", "롤업", "task-group 요약", "그룹 단위 리포트", "여러 task 결과 모아", "전체 task 현황 요약", "cross-task summary", "그룹 종합 리포트", "모든 task 정리", "run 결과 한꺼번에", even if they don't say "rollup". For a SINGLE task's report/time/errors/recap use okstra-inspect instead; for a forward-looking work plan over non-done tasks use okstra-schedule-gen.
 ---
 
 # OKSTRA Rollup

package/runtime/skills/{okstra-schedule → okstra-schedule-gen}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-name: okstra-schedule
+name: okstra-schedule-gen
 description: Use when the user asks for a task-group work schedule, a consolidated implementation plan across multiple tasks in a task-group, or wants to generate a "schedule" / "일정" / "작업 계획표" for non-done tasks. Trigger words include "okstra schedule", "<task-group> 일정 만들어", "<task-group> schedule 생성", "task-group 작업 계획".
 model: opus
 ---
 
-# OKSTRA Schedule
+# OKSTRA Schedule Gen
 
 Generate a consolidated work schedule for the selected `implementation-planning` stages of every non-done task in a given `task-group` (or a single `task-id`). For each task the skill reads its `implementation-planning` final-report **Stage Map** as the authoritative forward-looking decomposition, asks the user which stages to include, drafts a single Markdown plan, and only writes the final file after an **independent verifier subagent** confirms the draft covers exactly the selected stages. It runs as a **lead + verifier** flow; the frontmatter `model: opus` switches supporting harnesses to Opus-class for the turn — stage-level cross-task synthesis needs that reasoning depth.
 

package/runtime/skills/okstra-user-response/SKILL.md

@@ -57,19 +57,21 @@ Carry the chosen entry's `reportPath` and `taskKey` forward.
 okstra user-response show --report <reportPath>
 ```
 
-Returns `{reportPath, rows: [{id, kind, blocks, status, statement, recommended, alternatives, contextRefs}]}`. For each open `C-*` row, present to the user:
+Returns `{reportPath, rows: [{id, kind, blocks, status, statement, recommended, alternatives, contextRefs, resolvedRefs}]}`. `resolvedRefs` is `[{ref, definition}]` — the CLI has already looked up what each internal token (`RB-002`, `FU-001`, `§4.7`, …) means in the report body; `definition` is `null` only when the report text alone could not resolve it (e.g. a `path:line` pointer).
 
-- **`id`** and its **`statement`** (the original question).
-- **`recommended`** — the answer okstra proposed (+ rationale). It is only a recommendation.
-- **`alternatives[]`** — list them if present.
-- **`contextRefs[]`** — the report `§`/`C-id`/`path:line` references this question points at.
+**Do NOT paste the raw `statement` as the question.** A `statement` like `Rewrite RB-002 rollback (see §4.7)` is meaningless to the user on its own — that is the whole reason this skill exists. For each open `C-*` row, you MUST present:
+
+- **A rewritten, self-contained question** (lead with this): rewrite `statement` in plain language with **every internal token expanded inline** from its `resolvedRefs` `definition` — the user must never have to know what `RB-002` is to answer. If a token's `definition` is `null`, resolve it yourself **using Read** on the report `§`/`path:line` before asking; only if it is genuinely unresolvable do you say so plainly.
+- **`recommended`** — the answer okstra proposed (+ rationale), also stated in plain language. It is only a recommendation.
+- **`alternatives[]`** — list them if present, each in plain language.
+- **Raw source** (secondary, for traceability): the raw `id` + `statement` so the mapping back to the report stays visible.
 
 ## Step 3: Per-item — collect the user's decision (4 branches)
 
 For each open item, the user picks one of four dispositions. You relay and transcribe; you never choose:
 
 1. **Answer** — the user accepts the recommendation or gives their own answer. `disposition: "answer"`, `value` = the user's utterance verbatim.
-2. **Ask-to-explain** — if the user asks "what does this mean?", open the report `§`/`path:line` that this item's `contextRefs[]` points at **using Read** and explain it in plain language. Only explain — **do not pick the answer for the user**; after explaining, hand the decision back to the user.
+2. **Ask-to-explain (fallback)** — Step 2 already expanded every internal token, so the question should already be self-contained. If the user still asks "what does this mean?" or a `resolvedRefs` `definition` was `null`, open the report `§`/`path:line` that this item's `contextRefs[]` points at **using Read** and explain it in plain language. Only explain — **do not pick the answer for the user**; after explaining, hand the decision back to the user.
 3. **Free-form** — the user gives a narrative answer that matches neither a recommendation nor an alternative. `value` = that narrative verbatim, with the rationale in `rationale` if needed. `disposition: "answer"`.
 4. **Hold + reframe** — if the user asks to "re-frame this question itself", record it as `disposition: "reframe"`. Put what the user wants re-asked into `value` verbatim. A reframe is not an answer, so it does not satisfy the approval gate — the next run re-frames that question.
 

package/runtime/templates/reports/final-report.template.md

@@ -387,6 +387,73 @@ Carried-forward plan items retain their prior verdicts verbatim; each such item
 {% endfor %}
 {%- endif %}
 
+### 5.5.10 Implementation Design Preparation{% if t("implementationPlanning.designPreparation.heading") != "Implementation Design Preparation" %} ({{ t("implementationPlanning.designPreparation.heading") }}){% endif %}
+
+- **{{ t("implementationPlanning.designPreparation.mode") }}:** `{{ implementationPlanning.designPreparation.mode }}`
+- **{{ t("implementationPlanning.designPreparation.reason") }}:** {{ implementationPlanning.designPreparation.reason }}
+
+{% if implementationPlanning.designPreparation["items"] | length == 0 -%}
+{{ t("implementationPlanning.designPreparation.empty") }}
+{%- else %}
+{% for item in implementationPlanning.designPreparation["items"] %}
+#### {{ item.id }} — {{ item.title }}
+
+- **{{ t("implementationPlanning.designPreparation.kind") }}:** `{{ item.kind }}`
+- **{{ t("implementationPlanning.designPreparation.status") }}:** `{{ item.status }}`
+- **{{ t("implementationPlanning.designPreparation.stages") }}:** {{ item.stageRefs | join(", ") }}
+- **{{ t("implementationPlanning.designPreparation.need") }}:** {{ item.need }}
+{% if item.knownFacts %}
+- **{{ t("implementationPlanning.designPreparation.knownFacts") }}:**
+{% for fact in item.knownFacts %}
+  - {{ fact.statement }} — {{ fact.evidence }}
+{% endfor %}
+{% endif %}
+{% if item.openQuestions %}
+- **{{ t("implementationPlanning.designPreparation.openQuestions") }}:** {{ item.openQuestions | join("; ") }}
+{% endif %}
+- **{{ t("implementationPlanning.designPreparation.aiProposal") }}:** {{ item.aiProposal.summary }}
+  - **{{ t("implementationPlanning.designPreparation.proposalDetails") }}:** {{ item.aiProposal.details | join("; ") or t("implementationPlanning.designPreparation.none") }}
+  - **{{ t("implementationPlanning.designPreparation.proposalAssumptions") }}:** {{ item.aiProposal.assumptions | join("; ") or t("implementationPlanning.designPreparation.none") }}
+  - **{{ t("implementationPlanning.designPreparation.proposalEvidence") }}:** {{ item.aiProposal.evidence | join("; ") or t("implementationPlanning.designPreparation.none") }}
+  - **{{ t("implementationPlanning.designPreparation.proposalConfidence") }}:** `{{ item.aiProposal.confidence }}`
+- **{{ t("implementationPlanning.designPreparation.humanConfirmation") }}:**
+  - **{{ t("implementationPlanning.designPreparation.confirmationRequired") }}:** `{% if item.humanConfirmation.required %}yes{% else %}no{% endif %}`
+  - **{{ t("implementationPlanning.designPreparation.confirmationReason") }}:** {{ item.humanConfirmation.reason }}
+  - **{{ t("implementationPlanning.designPreparation.suggestedAction") }}:** {{ item.humanConfirmation.suggestedAction }}
+{% if item.replanTriggerFields %}
+- **{{ t("implementationPlanning.designPreparation.replanTriggerFields") }}:** `{{ item.replanTriggerFields | join("`, `") }}`
+{% endif %}
+{% if item.workingAssumption %}
+- **{{ t("implementationPlanning.designPreparation.workingAssumption") }}:** {{ item.workingAssumption }}
+{% endif %}
+{% if item.guardrails %}
+- **{{ t("implementationPlanning.designPreparation.guardrails") }}:** {{ item.guardrails | join("; ") }}
+{% endif %}
+{% if item.reviewAt %}
+{% if item.reviewAt.stage %}
+- **{{ t("implementationPlanning.designPreparation.reviewAt") }}:** {{ item.reviewAt.phase }} — stage {{ item.reviewAt.stage }}
+{% else %}
+- **{{ t("implementationPlanning.designPreparation.reviewAt") }}:** {{ item.reviewAt.phase }}
+{% endif %}
+{% endif %}
+{% if item.ifStillOpen %}
+- **{{ t("implementationPlanning.designPreparation.ifStillOpen") }}:** `{{ item.ifStillOpen }}`
+{% endif %}
+{% if item.requestPath %}
+- **{{ t("implementationPlanning.designPreparation.requestPath") }}:** `{{ item.requestPath }}`
+{% endif %}
+{% if item.blockReason %}
+- **{{ t("implementationPlanning.designPreparation.blockReason") }}:** {{ item.blockReason }}
+{% endif %}
+{% if item.requiredDecision %}
+- **{{ t("implementationPlanning.designPreparation.requiredDecision") }}:** {{ item.requiredDecision }}
+{% endif %}
+{% if item.notApplicableReason %}
+- **{{ t("implementationPlanning.designPreparation.notApplicableReason") }}:** {{ item.notApplicableReason }}
+{% endif %}
+{% endfor %}
+{%- endif %}
+
 {% endif %}
 {% if header.taskType == 'release-handoff' %}
 ## 5.6 Release Handoff Deliverables

package/runtime/templates/reports/i18n/en.json

@@ -129,6 +129,37 @@
       "decision": "Decision",
       "consequences": "Consequences",
       "alternativesConsidered": "Alternatives Considered"
+    },
+    "designPreparation": {
+      "heading": "Implementation Design Preparation",
+      "mode": "Mode",
+      "reason": "Reason",
+      "kind": "Kind",
+      "status": "Status",
+      "stages": "Stages",
+      "need": "Need",
+      "knownFacts": "Known facts",
+      "openQuestions": "Open questions",
+      "aiProposal": "AI proposal",
+      "proposalDetails": "Details",
+      "proposalAssumptions": "Assumptions",
+      "proposalEvidence": "Evidence",
+      "proposalConfidence": "Confidence",
+      "humanConfirmation": "Human confirmation",
+      "confirmationRequired": "Required",
+      "confirmationReason": "Confirmation reason",
+      "suggestedAction": "Suggested action",
+      "replanTriggerFields": "Replan trigger fields",
+      "workingAssumption": "Working assumption",
+      "guardrails": "Guardrails",
+      "reviewAt": "Review at",
+      "ifStillOpen": "If still open",
+      "requestPath": "Request path",
+      "blockReason": "Block reason",
+      "requiredDecision": "Required decision",
+      "notApplicableReason": "Not applicable reason",
+      "none": "(none)",
+      "empty": "No implementation design preparation items."
     }
   },
   "releaseHandoff": {

package/runtime/templates/reports/i18n/ko.json

@@ -129,6 +129,37 @@
       "decision": "결정",
       "consequences": "결과",
       "alternativesConsidered": "검토한 대안"
+    },
+    "designPreparation": {
+      "heading": "구현 설계 준비",
+      "mode": "모드",
+      "reason": "이유",
+      "kind": "종류",
+      "status": "상태",
+      "stages": "스테이지",
+      "need": "필요성",
+      "knownFacts": "확인된 사실",
+      "openQuestions": "열린 질문",
+      "aiProposal": "AI 제안",
+      "proposalDetails": "세부 내용",
+      "proposalAssumptions": "가정",
+      "proposalEvidence": "근거",
+      "proposalConfidence": "신뢰도",
+      "humanConfirmation": "사람 확인",
+      "confirmationRequired": "필수 여부",
+      "confirmationReason": "확인 이유",
+      "suggestedAction": "권장 조치",
+      "replanTriggerFields": "재계획 트리거 필드",
+      "workingAssumption": "작업 가정",
+      "guardrails": "가드레일",
+      "reviewAt": "검토 시점",
+      "ifStillOpen": "미해결 시",
+      "requestPath": "요청 경로",
+      "blockReason": "차단 이유",
+      "requiredDecision": "필요한 결정",
+      "notApplicableReason": "해당 없음 이유",
+      "none": "(없음)",
+      "empty": "구현 설계 준비 항목이 없습니다."
     }
   },
   "releaseHandoff": {