livt経由で各実装リポジトリに自動化Issueを起票する

ストーリールール提案中のルールテストが自動化している具体例疑問点ユビキタス言語

表示

livt経由で各実装リポジトリに自動化Issueを起票する→

ルール

#R-01

ルールメンテナーはlivtリポジトリのルールを指定して、対象実装リポジトリへ自動化Issueを起票できる

livt: case.yaml:1

#EX-01

story-keyとrule-idを指定すると、そのルール1件分のIssueが起票される

livt: files-one-issue-for-the-rule.md:2

#EX-02

story-keyのみ指定すると、そのストーリーの未起票ルール全件が起票される

livt: files-the-unfiled-rule.md:2

#R-02

起票したIssueのURLは、スキルがマッピングYAMLのruleに書き戻す

#EX-01

起票に成功すると、該当ruleのissuesにそのURLが追記される

livt: writes-the-url-back.md:2

#EX-02

書き戻しがそのままlivtリポジトリへの記録（record-rule-automation）になり、手作業を要しない

#R-03

dedupeはlivtリポジトリ側の記録で判定し、同じルール×対象リポジトリを二重起票しない

livt: case.yaml:1

#EX-01

ruleのissuesに対象リポジトリのIssueが既にあればスキップする

livt: skips-the-rule-already-filed.md:2

#EX-02

別の実装リポジトリへの起票は、既存の紐づけがあっても妨げない

livt: files-to-the-repo-without-one.md:2

#R-04

Issue本文はルール・具体例の本文とlivtリポジトリへのバックポインタを運ぶ

#EX-01

本文にルール名と具体例の一覧を含む

livt: body-carries-the-rule-and-its-examples.md:2

#EX-02

バックポインタとしてstory-key・rule-idと、リビングドキュメントのルールアンカー（#rule-{ID}）へのリンクを含む

livt: links-the-rules-anchor.md:2

#EX-03

起票時点のlivtリポジトリのrevをspec_versionとして記す

livt: body-pins-the-revision.md:2

#EX-04

バックポインタが指すルールIDは起票後も不変で、記録・ルール変更のAIスキル共通ポリシーとして担保する

#R-05

ストーリーにUS Issueが紐づいていれば、ルールIssueはそのsub-issueとして起票する

livt: case.yaml:1

#EX-01

US Issueがあるストーリーのルールは、起票時にsub-issueとして親へ紐づく

livt: links-under-the-story-issue.md:2

#EX-02

US Issueがなくてもルール単位の起票は成立する

livt: stands-alone-without-a-story-issue.md:2

#R-06

起票は実装リポジトリのコードを読まず、Issueというポインタだけを送る

livt: case.yaml:2

#EX-01

起票は対象リポジトリのチェックアウトを必要としない

livt: checks-out-nothing.md:2

#R-07

本ストーリーはAIスキルとして提供し、livtのCLIコマンドやMCPツールは追加しない

#EX-01

スキルはlivtリポジトリを読み、gh CLI（既存の認証）で対象リポジトリへ起票する

#EX-02

書き戻しはワーキングツリーの編集までとし、コミットやPRは通常のレビューフローに委ねる

livt: leaves-the-write-back-uncommitted.md:2

#R-08

実例マッピングYAMLの各ruleは、対応する自動化IssueのURLをissuesとして持てる

#EX-01

1つのルールが複数の実装リポジトリで自動化される場合、issuesに複数のURLを列挙する

livt: lists-both-urls.md:2

#EX-02

issuesに置くのはIssueのURLに統一し、PR・テストへの直リンクは置かない

#EX-03

issuesのないruleは未紐づけとして扱われる

#R-09

紐づけの正はlivtリポジトリが持ち、GitHub側の構造には依存しない

livt: case.yaml:1

#EX-01

親子関係はstory⊃ruleというlivtリポジトリの構造から把握し、GitHubのsub-issueグラフは読まない

livt: reads-no-sub-issue-graph.md:2

#EX-02

livt経由でないIssueも、URLをruleに貼れば同じ紐づけになる

livt: records-the-url-on-r-01.md:2 livt: records-the-url-on-r-02.md:2

#R-10

対象実装リポジトリは、ストーリーのfrontmatterのreposで宣言する

#EX-01

reposはowner/repo形式のリポジトリのリストで、複数の実装リポジトリを宣言できる

#EX-02

ルールIssueの起票先は、所属ストーリーのreposを参照する

livt: files-to-the-storys-repo.md:2

#EX-03

livtリポジトリ自身もreposに宣言でき、自リポジトリへの起票も同じ手順で成立する

#R-11

Issue本文の一次参照はlivt URIで、デプロイ済みURLは補助にとどめる

#EX-01

ルール・具体例のlivt URIをIssue本文に載せる

livt: body-cites-livt-uris.md:2

#EX-02

人が踏めるHTTPリンクは併記してよいが、一次はlivt URI

livt: keeps-the-livt-uri-beside-the-link.md:2

#EX-03

他リポジトリのIssueは後から直せないので、デプロイ先に依存させない

ユビキタス言語

livt URI→ livtリポジトリ→ 実例マッピング→ ストーリー→ ディスカバリー→