## 経緯 [[Obsidian]]による[[PKM]]を行っているが、初めての試みであったためナレッジを育てる過程で統一感のあるルールが揺らいだり、変わったりしている。 ルールを全く設けないと一貫性が無くなってしまうが、カッチリ設けすぎるとそちらが気になって筆が進まなくなる。[[アジャイルソフトウェア開発]]の観点からも、時間と共にルールが変わること自体は好ましいものと思われるので、変更不可にはしたくない。 最近は[[Obsidianの利用戦略]]などで管理をし始めたが、絶好の機会なので仕事や[[OSS]]開発でも活かせるテクニックを取り入れたい。 ## 提案内容 [[Minerva]]に対する[[ADR]]を作成する。 ### ファイル管理 - [[ADR]]の一覧は[[💿MIN]]で管理 - [[ADR]]は同じ階層に1Record 1Fileで管理 - [[ADR]]の命名は `💿XXX-NNNN タイトル` - `XXX`はキーとなるアルファベット大文字3文字 - `NNNN`は0埋め4桁の数字 - タイトルは[[AD]]を表す名前 - ==過去のレコードは基本変更不可== - 追加議論をしたい場合は別途[[AD]]を追加する - ==変更する場合も[[Change log]]は書かない== - 書かないと困るようなことは別の[[AD]]を立てること ### ステータス ステータスは以下のいずれかをタグで指定する。 | ステータス | 意味 | | ----------- | ---------------- | | #🤔Proposed | 提案段階で検討中 | | #💖Accepted | 採用された | | #💔Rejected | 不採用 | ## 承諾した場合の結果 ### メリット - 規約が一覧で見やすい - 却下したアイデアが分かりやすい - [[ADR]]を知る[[Obsidian]]に興味のある第3者に価値を提供できる - [[ADR]]を学習でき、[[Minerva]]の運用以外でも活用できる ### デメリット - [[💿MIN]]や[[ADR]]ファイルを1から手作業で書く場合は面倒 - 👌[[Templater]]や[[Obsidianプラグイン]]で自動化できればOK - [[Minerva]]は[[📕tadashi-aikawa]]の1人管理なので大袈裟 - 現状の管理で把握しきれていないためチャレンジの価値あり - 学習要素も大きい