feat: session-end reflection を qa_schema 3 の Transferable Principles として inline する (Phase 1)

[penne-0505]

Closes #1

何を変えるか

agent が「既存 pattern と一致するから新規 intent 不要」と inline で正当化し、session で得た transferable principle の昇格検討そのものを skip する構造的な抜け穴を塞ぐ。fix の説明 (what) は書かれるが一般化された学び (why generalized) が残らない、という downstream で観測された failure mode への対応。

設計判断

• qa_schema 3 = 2 + verification の Transferable Principles 必須。legacy 2 は受理継続、test-plan の要件は不変。既存文書の一斉移行は要求しない。
• validator は presence のみ検証: candidate (- TP: ...) または理由付き None: <reason> のみ受理。空欄と裸の None は fail。これにより「検討したが無かった」と「無言の skip」が構造的に区別される。中身の質は user review の領分 (intent ↔ code traceability の強制レベルと同じ哲学)。
• verification テンプレートの新 section は comment のみの本文で出荷: 未記入のまま複製した文書は validator で fail するため、reflection を書かずに通過する経路がない。
• skill 側の prompt は「intent を書け」ではなく「『これはなぜ』と立ち止まった判断はあったか」: 記録行為を thinking の延長に寄せ、儀式化を避ける。昇格判断は user gate。
• 昇格先の canonical path を新設: cross-cutting な原則は _docs/intent/<Area>/conventions/decision.md に集約 (documentation_operations 昇格ルール 5)。昇格 DEC は昇格元 verification への provenance を references に残す。
• eval case transferable-principle-skip を追加: 昇格 skip を再現するシナリオで、この step が agent 挙動を変えるかを逸話ではなく回帰確認できるようにする。
• 第一 sample (candidate / none の記入例) は quality_assurance.md に書き下ろし。agent が模倣する対象を先に供給する。

検証

• ./scripts/check-docs.sh PASS (fmt / check / 全 validator / fixture 回帰 / hook test / smoke)
• 新規 invalid fixture は意図したメッセージで fail することを個別確認 (missing heading / must record candidates or explicit None)
• CI 第 2 job 相当の starter 展開シミュレーションでも check-docs PASS
• markdownlint (CI 同等 glob) 0 errors

🤖 Generated with Claude Code