Skip to content

docs: add AGENTS.md for AI coding assistants#148

Merged
sundaramramaswamy merged 1 commit into
microsoft:mainfrom
sundaramramaswamy:docs/agents-md
May 5, 2026
Merged

docs: add AGENTS.md for AI coding assistants#148
sundaramramaswamy merged 1 commit into
microsoft:mainfrom
sundaramramaswamy:docs/agents-md

Conversation

@sundaramramaswamy
Copy link
Copy Markdown
Collaborator

@sundaramramaswamy sundaramramaswamy commented May 5, 2026

Add AGENTS.md to help AI coding assistants (Copilot, Claude, Codex, etc.) work effectively on the Reactor framework codebase.

Covers:

  • Build, test, and lint commands (all three test tiers with single-test examples)
  • Architecture overview (virtual DOM, reconciler split, hooks, echo suppression, pooling)
  • Key conventions (immutable records, factory DSL, fluent modifiers, 4-point control addition, test tier selection, AOT rules)

This complements SKILL.md (which teaches agents to write Reactor apps) by teaching agents to hack on the framework itself.

@sundaramramaswamy
Copy link
Copy Markdown
Collaborator Author

sundaramramaswamy commented May 5, 2026 •
edited
Loading

Of course, this is unrelated to //skills and SKILL.md (which are for users of Reactor, not makers of Reactor).

@sundaramramaswamy
docs: add AGENTS.md for AI coding assistants
1300c9c 
Provides build/test commands, architecture overview,
and key conventions for Copilot, Claude, Codex, and
other AI assistants working on the framework itself.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@sundaramramaswamy
Copy link
Copy Markdown
Collaborator Author

sundaramramaswamy commented May 5, 2026

All CI checks passed (Pack, CLA, Detect changes; Build/Tests skipped as docs-only). Local verification: unit tests and selftests pass. Ready for merge.

codemonkeychris
codemonkeychris approved these changes May 5, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator

@codemonkeychris codemonkeychris left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks great

@sundaramramaswamy sundaramramaswamy merged commit a6c8408 into microsoft:main May 5, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@codemonkeychris codemonkeychris codemonkeychris approved these changes

@madhuvan-msft madhuvan-msft Awaiting requested review from madhuvan-msft

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@sundaramramaswamy @codemonkeychris