Skip to content

docs(spec): 経路別ラウンドトリップ忠実度マトリクスを追加#3

Merged
kentalow merged 3 commits into
mainfrom
docs/round-trip-fidelity
Jun 20, 2026
Merged

docs(spec): 経路別ラウンドトリップ忠実度マトリクスを追加#3
kentalow merged 3 commits into
mainfrom
docs/round-trip-fidelity

Conversation

@kentalow

Copy link
Copy Markdown
Member

概要

CASE JSON / Excel / CSV の各インポート/エクスポート経路で、CASE v1.1 の全フィールドが往復で保持されるか落ちるかを、全リソース単位のマトリクスにまとめた新規ドキュメント docs/spec/round-trip-fidelity.md を追加します。

targetType が「JSON では保持されるが CSV/Excel では落ちる」件を起点に、同じ性質を持つ他フィールドを網羅的に洗い出した結果です。

要点

  • JSON(CFPackage) = フル忠実度 / Excel = OpenSALT 互換サブセット / CSV = さらに小さいサブセット(関連は isChildOf のみ表現可能)。
  • 落ちる/落ちないを決めるのは「ツールの CASE バージョン」ではなく「形式の表現力」である点を明記。
  • v1.1 で追加されたフィールド(targetType / notes(CFAssociation) / 全クラスの extensions / frameworkType / caseVersion / item 級 subjectsubjectURI 等)は軒並み JSON のみ保持、という傾向を可視化。
  • rubricCriterionText は唯一 JSON でも往復しない項目として記載。
  • クロステナント/クロスフレームワーク関連(exactMatchOf 等)の経路別挙動を注記。

変更

  • docs/spec/round-trip-fidelity.md(新規)
  • docs/spec/csv-format.md … 忠実度ノートから新規ドキュメントへ相互リンク
  • CLAUDE.md … docs 一覧に1行追加

ドキュメントのみの変更(コード変更なし)。既存の docs/dev/round_trip_status.md(JSON 経路の lossless 検証ステータス)とは補完関係。

🤖 Generated with Claude Code

kentalow and others added 3 commits June 20, 2026 13:08
CASE JSON / Excel / CSV の各経路で CASE v1.1 全フィールドが往復で
保持されるか落ちるかを、全リソース単位のマトリクスにまとめた。

- JSON(CFPackage) はフル忠実度、Excel は OpenSALT 互換サブセット、
  CSV はさらに小さいサブセット(関連は isChildOf のみ)という整理。
- targetType / notes(assoc) / extensions / frameworkType / caseVersion /
  item級 subject(URI) など v1.1 追加フィールドは軒並み JSON のみ保持、
  という傾向を明示。
- rubricCriterionText は唯一 JSON でも往復しない項目として記載。
- csv-format.md と CLAUDE.md の docs 一覧から相互リンク。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XXFogp18twGiPFBAZcqJw2
往復しない理由の説明で、実在する DB 列名 rubric_criterion_text_plain
を明示(誤読防止)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XXFogp18twGiPFBAZcqJw2
Excel は CF Doc シートの subject 列に title を | 区切りで保持し、import 時に
#subject メタ→CSV 経路で subject_uri を再構築する。identifier/uri は再生成
されるが title 経由で復元されるため、CSV と同じ △ が正確(同行 Note とも整合)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XXFogp18twGiPFBAZcqJw2
@kentalow kentalow merged commit 09e4fee into main Jun 20, 2026
2 checks passed
@kentalow kentalow deleted the docs/round-trip-fidelity branch June 20, 2026 04:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant