Story
Rule
✓Automated rule
Example
Question
Ubiquitous Language
livt経由で各実装リポジトリに自動化Issueを起票する→
ルールメンテナーはlivtリポジトリのルールを指定して、対象実装リポジトリへ自動化Issueを起票できる
#R-01
起票したIssueのURLは、スキルがマッピングYAMLのruleに書き戻す
#R-02
dedupeはlivtリポジトリ側の記録で判定し、同じルール×対象リポジトリを二重起票しない
#R-03
Issue本文はルール・実例の本文とlivtリポジトリへのバックポインタを運ぶ
#R-04
ストーリーにUS Issueが紐づいていれば、ルールIssueはそのsub-issueとして起票する
#R-05
livtは実装リポジトリのコードを読まず、Issueというポインタだけを送る
#R-06
本ストーリーはAIスキルとして提供し、livtのCLIコマンドやMCPツールは追加しない
#R-07
実例マッピングYAMLの各ruleは、対応する自動化IssueのURLをissuesとして持てる
✓ automated
#R-08
紐づけの正はlivtリポジトリが持ち、GitHub側の構造には依存しない
#R-09
対象実装リポジトリは、ストーリーのfrontmatterのreposで宣言する
#R-10
Issue本文の一次参照はlivt URIで、デプロイ済みURLは補助にとどめる
✓ automated
#R-11
起票に成功すると、該当ruleのissuesにそのURLが追記される
#EX-01
書き戻しがそのままlivtリポジトリへの記録（record-rule-automation）になり、手作業を要しない
#EX-02
本文にルール名と実例の一覧を含む
#EX-01
バックポインタとしてstory-key・rule-idと、リビングドキュメントのルールアンカー（#rule-{ID}）へのリンクを含む
#EX-02
起票時点のlivtリポジトリのrevをspec_versionとして記す
#EX-03
バックポインタが指すルールIDは起票後も不変で、清書・更新のAIスキル共通ポリシーとして担保する
#EX-04
起票は対象リポジトリのチェックアウトを必要としない
#EX-01
スキルはlivtリポジトリを読み、gh CLI（既存の認証）で対象リポジトリへ起票する
#EX-01
書き戻しはワーキングツリーの編集までとし、コミットやPRは通常のレビューフローに委ねる
#EX-02
1つのルールが複数の実装リポジトリで自動化される場合、issuesに複数のURLを列挙する
#EX-01
issuesに置くのはIssueのURLに統一し、PR・テストへの直リンクは置かない
#EX-02
issuesのないruleは未紐づけとして扱われる
#EX-03
親子関係はstory⊃ruleというlivtリポジトリの構造から把握し、GitHubのsub-issueグラフは読まない
#EX-01
livt経由でないIssueも、URLをruleに貼れば同じ紐づけになる
#EX-02
Ubiquitous Language