docs(AGENTS.md): add Current Initiatives section for cross-PR context#955
Open
flystar32 wants to merge 1 commit into
Open
docs(AGENTS.md): add Current Initiatives section for cross-PR context#955flystar32 wants to merge 1 commit into
flystar32 wants to merge 1 commit into
Conversation
AI agents (Claude Code, Codex, Cursor, etc.) reviewing individual PRs lack visibility into project-wide ongoing efforts, leading to missed conflicts — e.g. a PR adding a new HICLAW_* env var without knowing the rename to AgentTeams is in progress. Add a "Current Initiatives" table near the top of AGENTS.md so that every agent (and human) reviewing or submitting code sees active cross-cutting efforts and their impact on new contributions. Change-Id: I0055740d99f371893d20c25b5c7395655f16cb8e Co-developed-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add a Current Initiatives table to the top of
AGENTS.md(after "What is HiClaw", before "Project Structure").Problem: AI agents (Claude Code, Codex, Cursor, etc.) reviewing individual PRs lack visibility into project-wide ongoing efforts. For example, PR #943 adds a new
HICLAW_DM_POLICYenv var without knowing that PR #951 is renamingHICLAW_*→AGENTTEAMS_*— the agent reviewing #943 in isolation would miss this conflict.Solution: Since
AGENTS.mdis automatically loaded by all major AI coding tools, adding a short initiatives table here gives every agent (and human) the project-wide context needed for accurate PR reviews and contributions.Current initiatives listed:
Includes a maintainer note to keep the table updated as initiatives land or new ones start.
Test plan
🤖 Generated with Claude Code