Skip to content

Consolidate the AGENTS.md rules into a rulebook - #282

Merged
soareschen merged 1 commit into
mainfrom
consolidate-agents-rules
Nov 7, 2026
Merged

soareschen merged 1 commit into
mainfrom
consolidate-agents-rules

Conversation

@soareschen

@soareschen soareschen commented Nov 7, 2026 •

Copy link
Copy Markdown
Collaborator

Overview

[deepseek-v4.1-flash-1017] The cgp repository's AGENTS.md files now contain only rules, and the set is consolidated from four files to three. The two macro-core files merge into crates/macros/AGENTS.md, the root keeps the code, test, macro-review, and sibling rules, and the test-suite file keeps only its directory rules. The development commands move to README.md, and the macro review procedure moves to the knowledge base's implementation document.

The change is editorial: it removes project descriptions, architecture, module maps, command lists, histories, and procedures from the rule files, and points each rule at the document that owns the material. The root states the universal rules and the cgp-specific rules.

Impact

The files an agent reads before working in cgp are shorter and contain only rules. The macro review procedure now lives in cgp-knowledge-base/cgp/implementation/review.md, and the commands live in README.md. No crate code or runtime behavior changes.

The matching AGENTS.md changes in the sibling repositories are prepared separately and are not part of this PR.

Areas needing attention

Compare the new root, crates/macros/AGENTS.md, and crates/tests/AGENTS.md with the old four files to confirm that every rule and anchor survived. The macro review procedure moved out of cgp/AGENTS.md; its old #scrutinize-the-macro-codegen anchor now lives in cgp-knowledge-base/cgp/implementation/review.md#scrutinize-the-macro-codegen.

The root, test-suite, and macro-core guides now contain only rules, and the
two macro-core files merge into crates/macros/AGENTS.md. The development
commands move to the README, and the macro review procedure moves to the
knowledge base's implementation document. The root states the universal
rules and the cgp-specific code, test, review, and sibling rules.

Co-Authored-By: deepseek-v4.1-flash-1017
@soareschen
soareschen marked this pull request as ready for review November 7, 2026 12:12
@soareschen
soareschen merged commit fab0d07 into main Nov 7, 2026
3 checks passed
@soareschen
soareschen deleted the consolidate-agents-rules branch November 7, 2026 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant