docs(starter): c-prose コメント記法を c-overlay 形式(分離形)に統一 + AGENT_GUIDE URL 削除 (#182)#183
Merged
Merged
Conversation
… 削除 (#182) - 公開 API ブロックを冒頭に移動(c-overlay 標準分離形に合わせる) - 説明コメントを分離形の複数行コメントに変更(文末句点、`*` 始まり) - AGENT_GUIDE ドラフトブランチ URL を削除(リンク切れリスク排除) - 代替として「spec §5.4 / agent-reference S2-4 参照」の一般表記に変更 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
プロンプト指示の誤り(spec §5.4 は Layout 層の定義であり c-prose とは無関係)を 自律補正。c-prose は Component 層(spec §5.5)の子孫セレクタ CMS 例外。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
AR C1 審判で Critical 検出: - spec §5.5 には子孫セレクタ許容の規則が存在しない - c-overlay の DEVIATION コメントが実在する §5.5 SHOULD NOT を参照するのとは異なり、 c-prose の場合は spec 上の禁止規則が存在しないため §5.5 引用は誤情報 - 根拠は agent-reference S2-4 のみ → spec 参照部分を削除 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
Issue #182 対応。c-prose.css のコメント記法(異形・混在)を c-overlay.css の標準分離形に統一し、ドラフトブランチ直リンク URL を削除。
修正対象
c-prose.css のみ(1 ファイル)
変更内容
Before
After
変更方針
*始まり)agent-reference S2-4 参照の一般表記に変更DEVIATION: spec §5.5 SHOULD NOTパターンとは異なり、c-prose の場合は spec 上の禁止規則が存在しないため spec 参照を誤情報として削除。根拠は agent-reference S2-4 のみ。独自の記法・順序・空行配置を導入せず、c-overlay.css の標準分離形をそのまま踏襲。
全 Component 揺れ点検結果(web-dev-lead 事前確認済)
17 Component のうち公開 API を持つのは 8 個。変更が必要なのは c-prose のみ。
公開 API なし 9 Component(c-accordion / c-back-to-top / c-badge / c-blockquote / c-hamburger / c-section-heading / c-skip-link / c-stat / c-table)はヘッダ追加不要。
検出方法: 各 Component の prefix(例:
c-button→--button-)で始まりvar(--xxx-yyy, ...)形式で参照される Custom Property を grep。--_xxx(local)は除外。AR レポート
C1(発見フェーズ)
spec §5.5 /は §5.5 に子孫セレクタ規則が存在しないため誤情報Critical 対応:
spec §5.5 /削除 →agent-reference S2-4(子孫セレクタ許容例外)参照。のみにC2(検証フェーズ)
AR 最終判定
AR 合格 — マージ可
確認事項
pnpm build成功(built in 71ms)pnpm lint:csspass(Stylelint エラーなし)Closes #182