codeforjapan / codeforjapan/workflow-interviewer
A2. KB パーサ (YAML frontmatter + Mermaid + gap-notes 構造化)
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 0
- Avg merge
- 30m
- Merged PRs (30d)
- 2
Description
親: #1
## 目的
`docs/kb/` 配下のMarkdownを構造化データに変換するパーサを実装し、後続フェーズ(スキーマ拡張・ギャップ検出・キャンバス描画)が型付きで参照できるようにする。
## 実装範囲
- `lib/kb/parser.ts` 新規
- YAML frontmatter 抽出(gray-matter 相当の最小実装でも、軽量ライブラリでも可)
- Mermaid `flowchart TD` → `{ nodes, edges, subgraphs }` の AST
- ノードID・ラベル・形状(角丸/菱形/楕円)
- エッジのソース・ターゲット・条件ラベル(`-- 条件 -->`)
- subgraph アクター(住民・申請者 / 窓口担当 / システム / 審査担当 等)
- gap-notes.md の構造化(各「ギャップN: タイトル」を抽出し、仕様書の記述 / 現実 / FDE提案根拠 のセクションに分解)
- `lib/kb/loader.ts`: スラッグ(例: `inkan-toroku`)から flow-standard と gap-notes を読み込むファサード
- 型定義: `lib/kb/types.ts`
## 完了条件
- inkan-toroku の flow-standard.md と gap-notes.md がパース可能(テスト or 簡易スクリプトで確認)
- パース結果が後続 Issue(A3 / B2 / C1 / C2 / D2 / D3)から型安全に呼べる
## 関連
- KB 構造: `docs/kb/CONTRIBUTING.md`(file_type と必須プロパティ)
- 参考実装対象: `docs/kb/workflows/_standardized-20/inkan-toroku/`
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.