codeforjapan / codeforjapan/workflow-interviewer

A2. KB パーサ (YAML frontmatter + Mermaid + gap-notes 構造化)

Open
#2 0 comments 0 reactions 0 assignees View on GitHub
enhancement
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.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.