入れ子になったAGENTS.mdの優先順位 — 複数プロジェクトを一つのワークスペースで束ねる合流設計

from pathlib import Path
 
def collect_agents_files(target: Path, root: Path) -> list[Path]:
    """編集対象から根に向かって AGENTS.md を集め、弱い順（根が先）で返す"""
    files = []
    cur = target if target.is_dir() else target.parent
    while True:
        candidate = cur / "AGENTS.md"
        if candidate.exists():
            files.append(candidate)
        if cur == root:
            break
        cur = cur.parent
    return list(reversed(files))   # 根→近い順 = 弱い→強い順

import re
 
# 追記したいセクション（マージ）と、上書きしたいセクション（置換）を分ける
APPEND_SECTIONS = {"禁止語", "禁止事項", "用語集", "注意点"}
 
def parse_sections(text: str) -> dict[str, str]:
    sections, cur, buf = {}, None, []
    for line in text.splitlines():
        m = re.match(r"^#{1,3}\s+(.*)", line)
        if m:
            if cur is not None:
                sections[cur] = "\n".join(buf).strip()
            cur, buf = m.group(1).strip(), []
        else:
            buf.append(line)
    if cur is not None:
        sections[cur] = "\n".join(buf).strip()
    return sections
 
def merge(files: list[Path]) -> dict[str, str]:
    merged: dict[str, str] = {}
    for f in files:                       # 弱い順に処理
        for name, body in parse_sections(f.read_text(encoding="utf-8")).items():
            if name in APPEND_SECTIONS and name in merged:
                merged[name] += "\n" + body   # 足し合わせる
            else:
                merged[name] = body           # 近いものが上書きする
    return merged