H HagiTask

AGENTS.md / CLAUDE.md UpdateAGENTS.md / CLAUDE.md 更新 v1.0.0

A structured documentation-maintenance task preset that builds AGENTS.md as the primary data source and keeps CLAUDE.md as a minimal redirect, with explicit project selection and MonoSpecs-aware scope.一个结构化文档维护 task preset，以 AGENTS.md 为主要数据源，CLAUDE.md 保持为极简重定向，通过显式项目选择与 MonoSpecs 感知作用域管理。

About this task任务介绍

AGENTS.md Update is a task preset package for teams that want documentation maintenance to run through the shared preset-task contract. It treats AGENTS.md as the primary source of truth and lets users choose whether CLAUDE.md is included.

Why teams install it

AGENTS-first architecture

The preset builds or updates AGENTS.md as the comprehensive project documentation source, then writes a thin CLAUDE.md that redirects readers to AGENTS.md.

Configurable operation and content

Choose new, incresement update, or shrink, then select AGENTS.md include/exclude categories. An empty repository selection means all available repositories, including the MonoSpecs root. When CLAUDE.md is disabled, only AGENTS.md files are targeted.

MonoSpecs-aware repository scope

MonoSpecs root and child repositories use one repository selector. The resolved selection determines which targets the prompt may edit; there is no separate MonoSpecs scope switch.

Best fit

  • Best for: repository instruction refreshes, AGENTS.md maintenance (with CLAUDE.md redirect), and MonoSpecs-wide documentation updates that still need explicit scope control.
  • Not for: unrestricted cross-project batches, ad hoc repository editing, or workflows that do not center on AGENTS.md / CLAUDE.md maintenance.

FAQ

Does the migration rewrite existing AGENTS.md/CLAUDE.md files automatically?

No. Existing documentation remains unchanged until someone explicitly runs this preset.

Why does the preset ask for scope only on MonoSpecs roots?

Single-repo projects already map cleanly to root AGENTS.md + CLAUDE.md. The extra scope choice is only needed when child repositories are available.

AGENTS.md 更新是一个面向团队的 task preset，用来通过共享 preset-task 契约维护文档。它以 AGENTS.md 为事实来源，并允许用户决定是否包含 CLAUDE.md。

为什么团队会安装它

AGENTS 优先架构

该 preset 构建或更新 AGENTS.md 作为全面的项目文档源，然后写入一个精简的 CLAUDE.md 重定向到 AGENTS.md。

可配置操作与内容

可选择 new、incresement update 或 shrink，并配置 AGENTS.md 的包含/排除类别。不选择仓库表示全部可用仓库，包括 MonoSpecs 主仓库；关闭 CLAUDE.md 后只处理 AGENTS.md。

MonoSpecs 仓库范围

MonoSpecs 主仓库和子仓库使用同一个仓库选择控件，最终解析范围决定提示词可修改的目标，不再单独提供 MonoSpecs 作用域开关。

适用场景

  • 最适合：仓库说明刷新、AGENTS.md 维护（含 CLAUDE.md 重定向），以及仍然需要显式作用域控制的 MonoSpecs 文档更新。
  • 不适合：无约束的跨项目批量改动、随意编辑任意仓库，或与 AGENTS.md / CLAUDE.md 无关的任务。

FAQ

迁移后会自动改写现有 AGENTS.md/CLAUDE.md 吗？

不会。只有用户明确执行这个 preset 时，现有文档才会被更新。

为什么只有 MonoSpecs 根仓库才显示作用域选择？

单仓库项目天然对应根目录 AGENTS.md + CLAUDE.md。只有存在子仓库时，才需要额外决定是否把它们一起纳入维护范围。