@ryusenkei/conventions 0.1.0 → 0.2.0

package/README.md

@@ -46,28 +46,47 @@ The PreToolUse hook blocks the call and tells Claude why, so Claude can fix it a
 | Rule | Enforcement |
 | --- | --- |
 | pnpm only | Blocks `npm install` (and other npm changes) and `yarn` |
-| Branch names `<type>/<name>` | Checks `git switch -c`, `git checkout -b`, `git branch`, `git worktree add -b` |
+| Branch names `<type>/<name>` | Checks `git switch -c`, `git checkout -b`, `git branch`, `git worktree add -b` (also allows `dev/<issue>-<name>` with the epic flow) |
 | No skipped Git hooks | Blocks `git commit --no-verify` / `-n` and `git push --no-verify` |
+| Stage files by path | Blocks `git add -A` / `--all` / `.` / `-u` / `--update` and `git commit -a` / `--all` |
+| No force push to `main` / `master` | Blocks `git push --force` / `-f` / `--force-with-lease` and `+<refspec>` targeting `main` or `master` (also the current branch when no refspec is given) |
 | PR title = squash commit message | Checks `gh pr create` / `gh pr edit` titles with prose-lint's commit rules |
 | No AI signature | `attribution` is empty, and the hook blocks PR bodies with an AI signature |
 | Squash merge only | Blocks `gh pr merge --merge` / `--rebase` |
+| Merge only after CI passes | Blocks `gh pr merge` unless every check of the PR has passed (`gh pr checks`). Pending, failed, missing, or unreadable checks are blocked, also with `--auto` |
+| Epic flow (opt-in) | See [Epic flow](#epic-flow) |
 | Do not edit `node_modules` | Blocks Edit and Write under `node_modules` |
 | Secrets | `permissions.deny` blocks reading `.env` and `.dev.vars` with Claude's file tools (not Bash) |
 | Definition of done (`--stop`) | The Stop hook runs `pnpm lint` and `pnpm test` when the working tree has changes, and sends Claude back once on failure |
 
-Commit messages are checked by `.githooks/commit-msg`, and edited files by prose-lint's PostToolUse hook.
+Commit messages are checked by `.githooks/commit-msg`, and edited files by prose-lint's PostToolUse hook. `.githooks/pre-push` runs `pnpm run --if-present check`, so a repository that defines a `check` script cannot push until it passes. It applies to people as well as Claude.
+
+### Epic flow
+
+Opt in per repository in the root `package.json`:
+
+```json
+{
+  "ryusenkei": { "flow": "epic" }
+}
+```
+
+- Each epic gets an integration branch `dev/<issue>-<name>` (e.g. `dev/12-search`). Sub-issue PRs target it, and only a `dev/*` branch is merged into `main` (on deploy).
+- `gh pr create` to `main` (`--base main`, or no `--base`) is blocked unless the head (`--head`, or the current branch) is `dev/*`.
+- A PR from any other branch must target a `dev/*` base. `gh pr edit` is checked only when it changes `--base`.
+- Without the opt-in, none of this applies and `dev/*` branch names are rejected.
 
 ## Synced files
 
 `sync` writes these files and `check` compares them, ignoring line endings:
 
-- `.editorconfig`, `.gitattributes`, `.gitignore`, `.gitleaks.toml`, `mise.toml`, `.github/dependabot.yaml`, `.githooks/commit-msg`
+- `.editorconfig`, `.gitattributes`, `.gitignore`, `.gitleaks.toml`, `mise.toml`, `.github/dependabot.yaml`, `.githooks/commit-msg`, `.githooks/pre-push`
 - `.claude/settings.json`: only the hooks, `attribution`, and `permissions.deny` are managed. Other settings and hooks are kept
 - `pnpm-workspace.yaml`: `minimumReleaseAge` and `minimumReleaseAgeExclude`, matching the Dependabot `cooldown`
 
 `check` also reports a missing `rules.md` import in `CLAUDE.md`.
 
-Updates arrive as Dependabot PRs. The repository's `cooldown` excludes `@ryusenkei/*`, so new versions are picked up the next day. After an update, `check` fails until `sync` is run.
+Dependabot runs monthly with `rebase-strategy: disabled` to save GitHub Actions minutes, so rebase a Dependabot PR (`@dependabot rebase`) before merging it. The `cooldown` excludes `@ryusenkei/*`. To pick up a new version sooner, run `pnpm update "@ryusenkei/*"`. After an update, `check` fails until `sync` is run.
 
 ## Versioning
 

package/dist/files.d.ts

@@ -1,6 +1,6 @@
-/** CLAUDE.md の共通の規約の import */
+/** CLAUDE.md で共通の規約を読み込む import */
 export declare const IMPORT = "@node_modules/@ryusenkei/conventions/rules.md";
-/** 差分のあるファイル。`expected` が `undefined` = 自動で修正できない（`message` に対処） */
+/** 差分のあるファイル（`expected` が `undefined` = 自動で修正できない → `message` に対処） */
 export type Drift = {
     path: string;
     expected?: string;

package/dist/files.js

@@ -1,4 +1,4 @@
-// 利用側のリポの共通ファイルの同期・検査
+// 利用側のリポにある共通ファイルの同期・検査
 // - マスタ: パッケージの `files/`（npm は `.gitignore` を同梱しない → 先頭の `.` を除いた名前で格納）
 // - 比較は改行コードを LF に正規化（Windows の作業ツリーは CRLF になりうる）
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
@@ -12,10 +12,11 @@ const FILES = [
     { from: 'mise.toml', to: 'mise.toml' },
     { from: 'dependabot.yaml', to: '.github/dependabot.yaml' },
     { from: 'commit-msg', to: '.githooks/commit-msg', mode: 0o755 },
+    { from: 'pre-push', to: '.githooks/pre-push', mode: 0o755 },
 ];
 const SETTINGS = '.claude/settings.json';
 const WORKSPACE = 'pnpm-workspace.yaml';
-/** CLAUDE.md の共通の規約の import */
+/** CLAUDE.md で共通の規約を読み込む import */
 export const IMPORT = '@node_modules/@ryusenkei/conventions/rules.md';
 // `.github/dependabot.yaml` の `cooldown` と同値
 const RELEASE_AGE = [

package/dist/hook.js

@@ -2,7 +2,7 @@
 // Claude Code の hook（`.claude/settings.json` から `node` で直接実行）
 // - PreToolUse: 規約に反するツールの実行を拒否 → 終了コード2・理由は stderr
 // - Stop: 変更があれば `pnpm lint`・`pnpm test` を実行し、失敗時は完了を差し戻し
-// - hook 自体の失敗は終了コード1（拒否にしない → 作業を止めない）
+// - hook 自体の失敗は終了コード1（拒否にしない → 作業を継続）
 import { spawnSync } from 'node:child_process';
 import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -14,7 +14,7 @@ const root = process.env.CLAUDE_PROJECT_DIR ?? input.cwd ?? process.cwd();
 // Windows の `pnpm` は `.cmd` → シェル経由でのみ起動可能
 const shell = process.platform === 'win32';
 if (input.hook_event_name === 'PreToolUse') {
-    const reason = denyReason(input, { titleIssues, readFile });
+    const reason = denyReason(input, { root, titleIssues, readFile, currentBranch, prHead, prChecks });
     if (reason) {
         process.stderr.write(`${reason}\n`);
         process.exit(2);
@@ -45,6 +45,33 @@ function readFile(path) {
         return undefined;
     }
 }
+function currentBranch(cwd) {
+    const r = spawnSync('git', ['branch', '--show-current'], { cwd: cwd ?? root, encoding: 'utf8' });
+    return (r.status === 0 && r.stdout.trim()) || undefined;
+}
+function prHead(pr, cwd) {
+    const r = spawnSync('gh', ['pr', 'view', ...(pr ? [pr] : []), '--json', 'headRefName', '--jq', '.headRefName'], { cwd: cwd ?? root, encoding: 'utf8' });
+    return (r.status === 0 && r.stdout.trim()) || undefined;
+}
+// `gh pr checks` は実行中・失敗で終了コードが0以外（8・1）→ 終了コードではなく出力で判定
+function prChecks(pr, cwd) {
+    const r = spawnSync('gh', ['pr', 'checks', ...(pr ? [pr] : []), '--json', 'bucket'], { cwd: cwd ?? root, encoding: 'utf8' });
+    let buckets;
+    try {
+        buckets = JSON.parse(r.stdout).map((c) => c.bucket);
+    }
+    catch {
+        return /no checks reported/i.test(r.stderr ?? '') ? 'none' : 'unknown';
+    }
+    if (buckets.some((b) => b === 'fail' || b === 'cancel'))
+        return 'fail';
+    if (buckets.some((b) => b === 'pending'))
+        return 'pending';
+    // すべてスキップ = 成功したチェックがない
+    if (!buckets.includes('pass'))
+        return 'none';
+    return buckets.every((b) => b === 'pass' || b === 'skipping') ? 'pass' : 'unknown';
+}
 // 差し戻しは1回まで（`stop_hook_active` = 差し戻し後の再実行）→ 解消できない失敗で停止しない状態を防止
 function stop() {
     if (input.stop_hook_active)

package/dist/policy.d.ts

@@ -4,12 +4,22 @@ export type ToolUse = {
     tool_input: Record<string, unknown>;
     cwd?: string;
 };
+/** PR のチェックの集計（`unknown` = 取得に失敗） */
+export type Checks = 'pass' | 'pending' | 'fail' | 'none' | 'unknown';
 /** 判定に必要な外部の処理 */
 export type Context = {
+    /** リポのルート（`package.json` の opt-in の読み込み元） */
+    root: string;
     /** PR のタイトルの指摘（なければ空配列） */
     titleIssues: (title: string) => string[];
-    /** ファイルの内容（読めなければ `undefined`） */
+    /** ファイルの内容（読み込みの失敗時は `undefined`） */
     readFile: (path: string) => string | undefined;
+    /** 現在のブランチ（detached HEAD・取得の失敗時は `undefined`） */
+    currentBranch: (cwd: string | undefined) => string | undefined;
+    /** PR の head のブランチ（`pr` の省略時は現在のブランチの PR） */
+    prHead: (pr: string | undefined, cwd: string | undefined) => string | undefined;
+    /** PR のチェックの集計（`pr` の省略時は現在のブランチの PR） */
+    prChecks: (pr: string | undefined, cwd: string | undefined) => Checks;
 };
-/** 拒否の理由。許可する場合は `undefined` */
+/** 拒否の理由（許可する場合は `undefined`） */
 export declare function denyReason(use: ToolUse, ctx: Context): string | undefined;

package/dist/policy.js

@@ -1,10 +1,13 @@
 // PreToolUse で拒否するツールの実行
-// - 判定は純粋な関数 → 外部の処理（タイトルの検査・ファイルの読み込み）は `Context` で注入
+// - 判定は純粋な関数 → 外部の処理（タイトルの検査・ファイルの読み込み・git・gh）は `Context` で注入
 // - 拒否の理由は Claude に返却 → Claude が修正して再実行
 import { isAbsolute, join } from 'node:path';
 import { commands, option } from "./shell.js";
 const TYPES = ['build', 'chore', 'ci', 'docs', 'feat', 'fix', 'perf', 'refactor', 'revert', 'style', 'test'];
 const BRANCH = new RegExp(`^(${TYPES.join('|')})/[a-z0-9][a-z0-9._-]*$`);
+// epic のフローの統合ブランチ（`dev/<issue の番号>-<内容>`）
+const DEV_BRANCH = /^dev\/\d+-[a-z0-9][a-z0-9._-]*$/;
+const PROTECTED = ['main', 'master'];
 const EDIT_TOOLS = ['Edit', 'Write', 'MultiEdit', 'NotebookEdit'];
 // pnpm 以外のパッケージ管理の操作（`npm view`・`npm pack`・`npx` などの参照・実行は対象外）
 const NPM_CHANGES = ['install', 'i', 'add', 'ci', 'uninstall', 'un', 'remove', 'rm', 'update', 'up', 'link'];
@@ -13,7 +16,24 @@ const AI_TRAILER = /^[\w-]+:.*\b(claude|anthropic|openai|chatgpt|gpt-\d|copilot|
 const AI_NOTE = /generated (with|by) \[?(claude|chatgpt|copilot|gemini|codex|cursor)|🤖/i;
 // `git branch` の作成以外の操作
 const BRANCH_QUERY = ['-d', '-D', '--delete', '-l', '--list', '-a', '-r', '--all', '--remotes', '-v', '-vv', '--verbose', '--show-current', '--contains', '--no-contains', '--merged', '--no-merged', '-u', '--set-upstream-to', '--unset-upstream', '--edit-description'];
-/** 拒否の理由。許可する場合は `undefined` */
+// 作業ツリー全体を対象にする pathspec
+const ALL_PATHS = ['.', './', ':/', ':', '*'];
+// 値を取るオプション（位置引数・短いオプションの束の判定で値を除外）
+const COMMIT_VALUE_SHORT = 'mFCctS';
+const ADD_VALUE = ['--chmod', '--pathspec-from-file'];
+const PUSH_VALUE = ['-o', '--push-option', '--repo', '--receive-pack', '--exec'];
+const MERGE_VALUE = ['-t', '--subject', '-b', '--body', '-F', '--body-file', '-A', '--author-email', '--match-head-commit', '-R', '--repo'];
+const EDIT_VALUE = ['-t', '--title', '-b', '--body', '-F', '--body-file', '-B', '--base', '-m', '--milestone', '-R', '--repo', '--add-assignee', '--remove-assignee', '--add-label', '--remove-label', '--add-project', '--remove-project', '--add-reviewer', '--remove-reviewer'];
+const ASK_USER = '必要な場合はユーザーに実行を依頼';
+const BULK_STAGING = '一括の add（`git add -A`・`.`・`-u`、`git commit -a`）は禁止。変更・追加したファイルをパスで指定して add（`git status --short` で確認）';
+const BRANCH_RULE = `\`<type>/<内容>\`（type = ${TYPES.join('・')}、内容 = 英小文字・数字・\`-\`）`;
+const CHECKS_REASON = {
+    pending: 'CI が実行中。全チェックの成功を確認してからマージ（`gh pr checks --watch`）',
+    fail: 'CI が失敗。修正して全チェックが成功してからマージ',
+    none: 'PR にチェックがない。CI の成功を確認できない PR はマージしない',
+    unknown: 'CI の結果を取得できない（`gh pr checks` が失敗）。全チェックの成功を確認してからマージ',
+};
+/** 拒否の理由（許可する場合は `undefined`） */
 export function denyReason(use, ctx) {
     if (EDIT_TOOLS.includes(use.tool_name)) {
         const path = String(use.tool_input.file_path ?? use.tool_input.notebook_path ?? '');
@@ -31,11 +51,23 @@ function commandReasons(words, cwd, ctx) {
     if (cmd === 'yarn' || (cmd === 'npm' && NPM_CHANGES.includes(args[0] ?? '')))
         return ['パッケージ管理は pnpm のみ（`pnpm add`・`pnpm install` など）'];
     if (cmd === 'git')
-        return gitReasons(gitArgs(args));
+        return gitReasons(gitArgs(args), cwd, ctx);
     if (cmd === 'gh' && args[0] === 'pr')
         return prReasons(args[1], args.slice(2), cwd, ctx);
     return [];
 }
+// epic のフローの opt-in: ルートの `package.json` の `"ryusenkei": { "flow": "epic" }`
+function epicFlow(ctx) {
+    const raw = ctx.readFile(join(ctx.root, 'package.json'));
+    if (raw === undefined)
+        return false;
+    try {
+        return JSON.parse(raw).ryusenkei?.flow === 'epic';
+    }
+    catch {
+        return false;
+    }
+}
 // git の全体のオプション（`-C <path>`・`-c <name=value>` など）を除去
 function gitArgs(args) {
     let i = 0;
@@ -43,18 +75,87 @@ function gitArgs(args) {
         i += args[i] === '-C' || args[i] === '-c' ? 2 : 1;
     return args.slice(i);
 }
-function gitReasons([sub, ...args]) {
+// 位置引数（`--` 以降はすべて位置引数）
+function positionals(args, valued) {
+    const out = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--')
+            return [...out, ...args.slice(i + 1)];
+        if (valued.includes(a))
+            i++;
+        else if (!a.startsWith('-'))
+            out.push(a);
+    }
+    return out;
+}
+// 短いオプションの束（`-am` など）の `flag` の有無
+// - `valued` の文字の後ろは値
+function hasShort(args, flag, valued = '') {
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--')
+            return false;
+        if (!/^-[a-zA-Z]/.test(a))
+            continue;
+        for (const c of a.slice(1)) {
+            if (c === flag)
+                return true;
+            if (valued.includes(c)) {
+                if (a.endsWith(c))
+                    i++;
+                break;
+            }
+        }
+    }
+    return false;
+}
+function gitReasons([sub, ...args], cwd, ctx) {
     if ((sub === 'commit' || sub === 'push') && args.includes('--no-verify'))
         return ['フックの省略（`--no-verify`）は禁止'];
     // `git commit -n` = `--no-verify`（`git push -n` は dry run）
-    if (sub === 'commit' && args.some((a) => /^-[a-zA-Z]*n[a-zA-Z]*$/.test(a)))
+    if (sub === 'commit' && hasShort(args, 'n', COMMIT_VALUE_SHORT))
         return ['フックの省略（`-n`）は禁止'];
+    if (sub === 'commit' && (args.includes('--all') || hasShort(args, 'a', COMMIT_VALUE_SHORT)))
+        return [BULK_STAGING];
+    if (sub === 'add' && bulkAdd(args))
+        return [BULK_STAGING];
+    if (sub === 'push')
+        return pushReasons(args, cwd, ctx);
     const name = newBranch(sub, args);
-    if (name !== undefined && !BRANCH.test(name))
-        return [`ブランチ名は \`<type>/<内容>\`（type = ${TYPES.join('・')}、内容 = 英小文字・数字・\`-\`）: \`${name}\``];
-    return [];
+    if (name === undefined || BRANCH.test(name))
+        return [];
+    if (!epicFlow(ctx))
+        return [`ブランチ名は ${BRANCH_RULE}: \`${name}\``];
+    if (DEV_BRANCH.test(name))
+        return [];
+    return [`ブランチ名は ${BRANCH_RULE}、epic は \`dev/<issue の番号>-<内容>\`: \`${name}\``];
 }
-// 作成・改名するブランチの名前
+function bulkAdd(args) {
+    if (args.some((a) => a === '--all' || a === '--update'))
+        return true;
+    if (args.some((a) => /^-[a-zA-Z]*[Au][a-zA-Z]*$/.test(a)))
+        return true;
+    return positionals(args, ADD_VALUE).some((p) => ALL_PATHS.includes(p));
+}
+// main・master への force push を拒否
+function pushReasons(args, cwd, ctx) {
+    const forceAll = args.some((a) => a === '--force' || a.startsWith('--force-with-lease')) || hasShort(args, 'f', 'o');
+    if (args.includes('--all') || args.includes('--mirror'))
+        return forceAll ? [`\`--all\`・\`--mirror\` の force push は禁止（${PROTECTED.join('・')} を含む）。${ASK_USER}`] : [];
+    const [, ...refspecs] = positionals(args, PUSH_VALUE);
+    const targets = refspecs.length
+        ? refspecs.map((r) => ({ force: forceAll || r.startsWith('+'), branch: pushTarget(r.replace(/^\+/, ''), cwd, ctx) }))
+        : [{ force: forceAll, branch: ctx.currentBranch(cwd) }];
+    const hit = targets.find((t) => t.force && t.branch !== undefined && PROTECTED.includes(t.branch));
+    return hit ? [`\`${hit.branch}\` への force push は禁止。${ASK_USER}`] : [];
+}
+function pushTarget(refspec, cwd, ctx) {
+    const dst = refspec.includes(':') ? refspec.slice(refspec.indexOf(':') + 1) : refspec;
+    const name = dst.replace(/^refs\/heads\//, '');
+    return name === 'HEAD' ? ctx.currentBranch(cwd) : name;
+}
+// 作成・リネームするブランチの名前
 function newBranch(sub, args) {
     const positionals = args.filter((a) => !a.startsWith('-'));
     switch (sub) {
@@ -75,8 +176,8 @@ function newBranch(sub, args) {
     }
 }
 function prReasons(sub, args, cwd, ctx) {
-    if (sub === 'merge' && args.some((a) => a === '--merge' || a === '--rebase' || a === '-m' || a === '-r'))
-        return ['マージは squash のみ（`--squash`）'];
+    if (sub === 'merge')
+        return mergeReasons(args, cwd, ctx);
     if (sub !== 'create' && sub !== 'edit')
         return [];
     const reasons = [];
@@ -89,5 +190,31 @@ function prReasons(sub, args, cwd, ctx) {
     const body = [option(args, ['--body', '-b']), file && file !== '-' ? ctx.readFile(isAbsolute(file) || !cwd ? file : join(cwd, file)) : undefined].join('\n');
     if (AI_TRAILER.test(body) || AI_NOTE.test(body))
         reasons.push('PR の本文に AI の署名を付けない');
+    if (epicFlow(ctx))
+        reasons.push(...epicReasons(sub, args, cwd, ctx));
     return reasons;
 }
+// `--auto` も対象（必須のチェックがないリポでは即時にマージされる）
+function mergeReasons(args, cwd, ctx) {
+    if (args.some((a) => a === '--merge' || a === '--rebase' || a === '-m' || a === '-r'))
+        return ['マージは squash のみ（`--squash`）'];
+    const checks = ctx.prChecks(positionals(args, MERGE_VALUE)[0], cwd);
+    return checks === 'pass' ? [] : [CHECKS_REASON[checks]];
+}
+// epic のフロー: main への PR は dev/* から、それ以外のブランチの PR は dev/* へ
+// - `gh pr create` の base の省略 = main（既定のブランチ）
+// - `gh pr edit` は base を変更する場合のみ
+function epicReasons(sub, args, cwd, ctx) {
+    const explicit = option(args, ['--base', '-B']);
+    if (sub === 'edit' && explicit === undefined)
+        return [];
+    const base = explicit ?? 'main';
+    const head = sub === 'create' ? (option(args, ['--head', '-H'])?.replace(/^.*:/, '') ?? ctx.currentBranch(cwd)) : ctx.prHead(positionals(args, EDIT_VALUE)[0], cwd);
+    if (head !== undefined && DEV_BRANCH.test(head))
+        return [];
+    if (PROTECTED.includes(base))
+        return [`\`${base}\` への PR は epic の \`dev/<issue の番号>-<内容>\` からのみ（デプロイのとき）。sub-issue の PR は \`--base dev/...\` で epic のブランチへ`];
+    if (!DEV_BRANCH.test(base))
+        return [`PR の base は epic の \`dev/<issue の番号>-<内容>\`: \`${base}\``];
+    return [];
+}

package/dist/shell.d.ts

@@ -1,4 +1,4 @@
 /** コマンド文字列をコマンドごとの語の配列に分解 */
 export declare function commands(line: string): string[][];
-/** オプションの値（`--name value`・`--name=value`・`-n value`）。指定がなければ `undefined` */
+/** オプションの値（`--name value`・`--name=value`・`-n value`）→ 指定がなければ `undefined` */
 export declare function option(words: string[], names: string[]): string | undefined;

package/dist/shell.js

@@ -1,6 +1,6 @@
 // シェルのコマンド文字列の簡易な分解（hook の判定用）
 // - 区切り: `&&`・`||`・`;`・`|`・`&`・改行 → コマンドごとの語の配列
-// - 解釈: 引用符（`'`・`"`）とバックスラッシュ。変数・コマンド置換は展開しない
+// - 解釈: 引用符（`'`・`"`）とバックスラッシュ → 変数・コマンド置換は展開しない
 // - 先頭の `NAME=value`（環境変数の指定）は除去
 /** コマンド文字列をコマンドごとの語の配列に分解 */
 export function commands(line) {
@@ -61,7 +61,7 @@ export function commands(line) {
     endCommand();
     return out;
 }
-/** オプションの値（`--name value`・`--name=value`・`-n value`）。指定がなければ `undefined` */
+/** オプションの値（`--name value`・`--name=value`・`-n value`）→ 指定がなければ `undefined` */
 export function option(words, names) {
     for (let i = 0; i < words.length; i++) {
         const w = words[i];

package/files/dependabot.yaml

@@ -3,9 +3,11 @@ updates:
   # npm（pnpm ワークスペース）。ルートの1件で apps/*・packages/* を横断
   - package-ecosystem: npm
     directory: "/"
-    # 毎日（自社のパッケージの新しいバージョンをすぐ取り込むため）
+    # 月1回（PR ごとの CI による GitHub Actions の消費を抑制）。自社のパッケージを急ぐ場合は手動で `pnpm update "@ryusenkei/*"`
     schedule:
-      interval: daily
+      interval: monthly
+    # 自動の rebase なし（main の更新ごとの CI の再実行を防止）→ マージの前に PR で `@dependabot rebase`
+    rebase-strategy: disabled
     # 公開直後のバージョンは配布ファイルの反映待ちでインストールに失敗しうる → 2日待つ。自社のパッケージは待たない
     cooldown:
       default-days: 2
@@ -30,7 +32,8 @@ updates:
   - package-ecosystem: github-actions
     directory: "/"
     schedule:
-      interval: weekly
+      interval: monthly
+    rebase-strategy: disabled
     commit-message:
       prefix: ci
       include: scope

package/files/pre-push

@@ -0,0 +1,3 @@
+#!/bin/sh
+# push の前の検査（`check` のスクリプトを持つリポのみ。CI の失敗・Actions の消費を手元で防止）
+exec pnpm run --if-present check

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/conventions",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "RYUSENKEI のモノリポの共通の規約（Claude Code の規約・hook、共通ファイルの同期）",
   "license": "MIT",
   "author": "RYUSENKEI",
@@ -31,7 +31,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "dependencies": {
     "@ryusenkei/prose-lint": "^0.1.0"

package/rules.md

@@ -6,7 +6,7 @@
 - TypeScript: ビルドせず Node で直接実行（`node scripts/x.ts`）
 - テスト: Vitest。対象と同じディレクトリに `*.test.ts`
 - 子プロセス: `scripts/lib/exec.ts` の `exec`（Windows の `.cmd` に対応）
-- 依存の更新: Dependabot の PR で実施
+- 依存の更新: Dependabot の PR で実施（月1回・自動の rebase なし → マージの前に手で rebase）
 
 ## 設定・秘密値
 
@@ -31,9 +31,15 @@
 - ドメインの概念・説明・表示文字列は日本語
 - 文体の指摘（`prose-lint`）がドメインの用語に該当する場合: `prose-lint.json` の `allow`・`vocabulary` に追加
 
-## PR
+## Git・PR
 
-- 本文: 背景・変更・検証
+- コミット: 変更・追加したファイルをパスで指定して add（一括の add は禁止、フックで強制）
+- push の前: `pnpm check`（`check` を持つリポは pre-push で強制）
+- PR の本文: 背景・変更・検証
+- マージ: CI の全チェックの成功を確認してから（フックで強制）
+- epic のフロー（有効にしたリポのみ）
+  - epic ごとに `dev/<issue の番号>-<内容>` を作成し、sub-issue の PR は dev のブランチへ
+  - `main` へのマージはデプロイのときだけ dev のブランチから
 
 ## 完了の条件