wip: phase_z2 evidence 파이프라인 + matching 실험(phase2~26) + 프론트 trace 패널 진행분 스냅샷

- src: phase_z2 composition/mapper/pipeline/placement_planner/retry, ai_fallback(prompts/schema/validate), mdx_text_atoms 신규
- Front: PipelineTracePanel 신규, FramePanel/SlideCanvas/Home/designAgentApi 등 갱신 + 테스트 4종 추가
- templates/phase_z2: catalog(component_expansion_registry, node_slot_mapping 신규), frames, families, slide_base 갱신
- tests/matching: phase2~26 매칭 실험 스크립트·리포트·온톨로지 전체 (미커밋 진행분)
- tests: b4_v4 evidence, task5~28.5 시리즈, regression(imp95 baseline) 등 신규 테스트 대량 추가
- docs/reference: MDX 구조 인벤토리, MDX→Frame 구조 계약 문서
- scripts: mdx 계약/parity/coverage/viewport 체크, gitea comment, run sync 유틸
- .gitignore: tmp*.json, chromedriver, .orchestrator, *.pkl, Front_test* 등 임시/스냅샷 제외

미완성 작업의 보존용 스냅샷 커밋 (2026-07-02)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

src/phase_z2_ai_fallback/prompts.py

@@ -29,8 +29,12 @@ SYSTEM_PROMPT = (
     f"  3. proposal_kind MUST be one of: {_ALLOWED_KINDS}.\n"
     f"  4. Do NOT propose any of: {_FORBIDDEN_KINDS}.\n"
     "  5. Do NOT change frame_id — V4 rank-1 frame is locked.\n"
-    "  6. Keep declared frame slots (text/table/image/details) populated.\n"
-    "  7. Respect Internal Region containment; place content units within "
+    "  6. Preferred Task-12 output is proposal_kind='design_adaptation_plan': "
+    "plan frame/layout/repeat changes only; do NOT output final text slots.\n"
+    "  7. Do NOT create titles, labels, summaries, body text, or slot content. "
+    "The code layer will place MDX verbatim text.\n"
+    "  8. Keep declared frame slots (text/table/image/details) accounted for.\n"
+    "  9. Respect Internal Region containment; place content units within "
     "the declared region only."
 )
 
@@ -73,6 +77,27 @@ def build_ai_fallback_prompt(
         "figma_partial_json": figma_partial_json,
         "internal_region": internal_region,
         "mdx_text_READ_ONLY": mdx_text,
+        "task12_output_contract": {
+            "preferred_proposal_kind": ProposalKind.DESIGN_ADAPTATION_PLAN.value,
+            "allowed_operation_examples": [
+                "increase_repeat_count",
+                "split_group_across_repeat_blocks",
+                "rebalance_zone_ratio",
+                "compact_spacing",
+                "use_repeatable_frame",
+            ],
+            "forbidden_content_fields": [
+                "text",
+                "title",
+                "label",
+                "body",
+                "slots",
+                "mdx_text",
+                "summary",
+                "raw_html",
+                "raw_css",
+            ],
+        },
     }
     return {
         "system": SYSTEM_PROMPT,