release-starter
Skill16 starsChanged yesterdayApache-2.0View on GitHub
独立 review 済み starter candidate を承認 gate 後に atomic push し、検証済み snapshot として公開する。
- Commits and pushes
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- baseline-precheckSkill
- grill-meSkill
- herdr-kaji-launchSkill
- i-dev-final-checkSkill
- i-doc-final-checkSkill
- i-doc-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- incident-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-reviewSkill
- incident-verifySkill
- i-prSkill
- issue-closeSkill
- issue-createSkill
- issue-designSkill
- issue-fix-codeSkill
- issue-fix-designSkill
- issue-fix-readySkill
- issue-implementSkill
- issue-review-codeSkill
- issue-review-designSkill
- issue-review-readySkill
- issue-small-change-executeSkill
- issue-small-change-reviewSkill
- issue-startSkill
- issue-verify-codeSkill
- issue-verify-designSkill
- kaji-run-verifySkill
- pr-fixSkill
- pr-verifySkill
- releaseSkill
- review-cycleSkill
- review-pollSkill
- reviewSkill
- review-starter-updateSkill
- run-watchedSkill
- series-createSkill
- update-starterSkill
- watch-triageSkill
The file
Files
Release Starter
/release-starter <tracking_issue_id> で managed starter の検証済み template snapshot を公開する。
Pre-flight
- tracking Issue と starter sync runbook から
target(= 本文の現在の
syncingbatch から求まるactive_target)、covered_targets(同じ batch の target 集合)、starter identity、local path を解決する。同じ本文読み取りからtracking_issue_has_pending_tasks(現在の batch 以外にopen行が残っているか)も導出する。 kaji issue resolve-verdict <id> --step review-starter-update --require-meta target --require-meta base --require-meta candidateを実行し、最新 verdict が独立 review PASS で、 meta.target == active_target、meta.candidate == local main HEAD であることを確認する。未検出、 不正 marker、meta 欠落、不一致は fail-closed で ABORT。- local main clean、target kaji Release published、dependency / lockfile version 整合、quality gate を確認する。
meta.base == meta.candidateの N/A を release-plan より先に分岐し、N/A では release-plan を呼ばない。ただし N/A でも close 前に remote main == meta.base (== meta.candidate) を必須とし、review PASS 後に remote main が前進していれば stale review evidence として ABORT する。変更 candidate の場合だけ、この時点で初めて pre-flight and recovery を読み、手順1で導出したtracking_issue_has_pending_tasksを含む観測 JSON を release-plan へ渡す。未公開 path は remote main == meta.base、公開済み残処理 path は remote main == meta.candidate を必須にする。
Publish
- N/A (
meta.base == meta.candidate): 上記の先行分岐で、独立 review PASS かつ remote main == meta.base (== meta.candidate) を確認した後だけ完了 bookkeeping(後述)を実行する。 remote main が前進していれば stale review evidence として ABORT する。starter tag / Release は 作らない。 - ref push path: candidate SHA と
kaji-vX.Y.Zまたはkaji-vX.Y.Z-rNを提示し、workflow 外で 人間の明示承認を得てから annotated tag と main をgit push --atomicする。 - push 後は Release notes template から
gh release createを実行し、 続けて完了 bookkeeping を行う。 - route 2 の部分成功再実行は release-plan の
remaining_actionsのうちcreate_releaseだけを 実行する(不足していればgh release createを再試行。新 tag、ref push、再承認は不要)。update_state_table/close_tracking_issue/promote_next_taskは状態表更新・Issue close が未完了であることを示す参考情報に留め、直接実行しない。実行は必ず下記の完了 bookkeeping(kaji starter task-plan)経由で行う(判定の二重化防止。詳細は pre-flight and recovery)。
完了 bookkeeping(kaji starter task-plan の completion)
kaji Release 状態表更新と tracking Issue close は kaji starter task-plan に completion を
渡して判定する。completion.batch は active_target を含む batch id、completed_targets は
covered_targets と完全一致する集合(部分集合・上位集合は ABORT)、published_tag は
ref push path なら公開した tag 名、N/A path なら null にする。
kaji starter task-plan <<EOF
{
"issue_id": <tracking_issue_id>,
"issue_state": "open",
"body": "<tracking Issue の現在の本文>",
"completion": {
"batch": "<active batch id>",
"completed_targets": <covered_targets>,
"published_tag": "kaji-vX.Y.Z"
}
}
EOF返る TaskPlan を次のとおり適用する:
state_table_updatesの各行(kaji_release/status/starter_release/reason)を kaji Release の repository 別状態表へ適用する(active_targetの行がPASS、束ねた他行が 理由付きN/A。N/A path は全行が理由付きN/A)。next_bodyが非nullなら、それを tracking Issue 本文へ反映する(対象 batch 行をdoneにする)。close_allowedが真の場合に限り tracking Issue を close する。偽の場合(他 batch やopenの 後続タスクが残っている)は close せず、Issue は開いたまま維持する。次回の/update-starterがpromote_next_taskとして残りのopen行から新しい batch を開始する。- 状態表更新・本文更新・close のいずれかが部分失敗した場合、同じ
completionでkaji starter task-planを再実行する(route: 5の冪等再適用。state_table_updatesは 初回と同一の値になるため、再適用しても値が変わらない)。
Guardrails
force push、tag 上書き、lightweight tag、review 前 publish を禁止する。GitHub Release 作成の再試行で
kaji-vX.Y.Z-rN を増やさない。starter の失敗を理由に公開済み kaji tag / Release / PyPI を rollback
しない。観測矛盾は ABORT し、人間へ値を提示する。
Verdict
PASS | ABORT。報告コメントに --verdict-step release-starter --verdict-status <STATUS> を付け、
コメント末尾と stdout に共通 verdict block を出す。注入時は全外部副作用の後、最後に
prompt の kaji verdict publish で verdict_path へ公開する(直接書かない)。ABORT は復旧 suggestion を必須とする。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

