HCPチャート
type: Concept
definition: 処理の目的を左に、手段をより深いインデントの右に置いて階層的に記述する図法で、日本電信電話公社の横須賀電気通信研究所で考案された。
alternative label: Hierarchical ComPact description chart
alternative label: HCP図

MakingHCPChartSkill
type: Concept
definition: HCP-DSLを仕様に沿って解釈し、決定的なSVGを返すためのスキルリポジトリ。
alternative label: hcp-chart-svg-v2
uses: HCP-DSL
uses: hcp_render_svg.py
requires: 記述粒度の規約

HCP-DSL
type: Concept
definition: HCPチャートをテキストで記述するための、MakingHCPChartSkillが定める記法で、行頭の記号とインデントで階層・分岐・繰り返しなどを表す。
alternative label: HCP記述言語
broader: HCPチャート
implements: HCPチャート
requires: 記述粒度の規約

hcp_render_svg.py
type: Concept
definition: JSON入力を検証し、HCP-DSLを解釈してSVGレスポンスを返すMakingHCPChartSkillの本体スクリプト。
implements: HCPチャート
implements: HCP-DSL
succeeds: hcp_xml_to_svg.py
uses: renderAllModules
uses: moduleパラメータ
requires: Python
implements: diagnostics(診断結果)

hcp_xml_to_svg.py
type: Concept
definition: MakingHCPChartSkillでdeprecatedとなっている旧エントリーポイントのスクリプトで、現在はhcp_render_svg.pyに置き換えられている。

記述粒度の規約
type: Concept
definition: レベル0(最上位)には目的ラベルだけを書き、代入や比較のようなコード風の記述は子ノードへ下げるという、MakingHCPChartSkillが必須ルールとして定める記述規約。
alternative label: レベル0は目的ラベルのみ

Codex
type: Concept
definition: OpenAIが提供する、リポジトリのファイルを実際に読み書きするコーディングエージェント。
alternative label: OpenAI Codex

renderAllModules
type: Concept
definition: hcp_render_svg.pyへのJSON入力で指定する、全モジュールのSVGをまとめて生成させるオプション。
alternative label: 全モジュール描画オプション
incompatible with: moduleパラメータ

moduleパラメータ
type: Concept
definition: hcp_render_svg.pyへのJSON入力で、描画対象とする単一モジュール名を指定するパラメータ。
alternative label: module指定

Python
type: Concept
definition: 汎用のインタープリタ型プログラミング言語で、hcp_render_svg.pyはこの言語の標準ライブラリのみで実装されている。
alternative label: CPython

diagnostics(診断結果)
type: Concept
definition: hcp_render_svg.pyがHCP-DSLの検証結果として返すJSONフィールドで、errorが含まれる場合はsvg/svgsが空になる。
alternative label: diagnosticsフィールド

subject: HCP-DSL
predicate: implements
object: HCPチャート
description: HCP-DSLはHCPチャートという図法をテキストとして表現するための記法である
evidence: hcpchartspec.md
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: implements
object: HCPチャート
description: hcp_render_svg.pyはHCP-DSLを解釈し、実際にHCPチャートの図(SVG)として描画する
evidence: hcp render svg.py
verified at: 2026-08-01
certainty: established

subject: MakingHCPChartSkill
predicate: uses
object: HCP-DSL
description: MakingHCPChartSkillはHCP-DSLを入力形式として使う
evidence: MakingHCPChartSkill
verified at: 2026-08-01
certainty: established

subject: MakingHCPChartSkill
predicate: uses
object: hcp_render_svg.py
description: MakingHCPChartSkillはhcp_render_svg.pyを本体スクリプトとして使う
evidence: SKILL.md
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: implements
object: HCP-DSL
description: hcp_render_svg.pyはJSON入力を検証し、HCP-DSLの解釈と描画を実装する
evidence: hcp render svg.py
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: succeeds
object: hcp_xml_to_svg.py
description: hcp_render_svg.pyは、deprecatedとなったhcp_xml_to_svg.pyの後継スクリプトである
evidence: hcp xml to svg.py
verified at: 2026-08-01
certainty: established

subject: HCP-DSL
predicate: requires
object: 記述粒度の規約
description: HCP-DSLでの記述は、レベル0に目的ラベルだけを書く記述粒度の規約を前提とする
evidence: hcp-chart-schema.md
verified at: 2026-08-01
certainty: established

subject: MakingHCPChartSkill
predicate: requires
object: 記述粒度の規約
description: MakingHCPChartSkillは記述粒度の規約を必須ルールとして定めている
evidence: hcp-chart-schema.md
verified at: 2026-08-01
certainty: established

subject: Codex
predicate: uses
object: MakingHCPChartSkill
description: OpenAI Codexは、リポジトリのディレクトリを$HOME/.codex/skills配下へ配置することでMakingHCPChartSkillをスキルとして利用できる。Codexを使わない場合はこの手順は不要
evidence: README.md
verified at: 2026-08-01
certainty: context-dependent

subject: renderAllModules
predicate: incompatibleWith
object: moduleパラメータ
description: renderAllModulesをtrueにする場合、moduleパラメータを同時に指定することはできない
evidence: SKILL.md
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: uses
object: renderAllModules
description: hcp_render_svg.pyはrenderAllModulesオプションにより全モジュール分のSVGをまとめて生成できる
evidence: SKILL.md
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: uses
object: moduleパラメータ
description: hcp_render_svg.pyはmoduleパラメータにより描画対象を単一モジュールへ絞り込める
evidence: SKILL.md
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: requires
object: Python
description: hcp_render_svg.pyはPython 3で動作するスクリプトで、標準ライブラリのみに依存し追加パッケージを必要としない
evidence: index.html
verified at: 2026-08-01
certainty: established

subject: hcp_render_svg.py
predicate: implements
object: diagnostics(診断結果)
description: hcp_render_svg.pyは入力の検証結果をdiagnosticsとして返し、errorが含まれる場合はsvgまたはsvgsを空にする
evidence: SKILL.md
verified at: 2026-08-01
certainty: established