Skip to content

Add AGENTS.md#5765

Merged
compulim merged 8 commits intomainfrom
feat-agents-md
Mar 3, 2026
Merged

Add AGENTS.md#5765
compulim merged 8 commits intomainfrom
feat-agents-md

Conversation

@compulim
Copy link
Contributor

@compulim compulim commented Mar 3, 2026

Changelog Entry

Description

Adding AGENTS.md and HUMAN.md.

HUMAN.md contains directives for human developers.

We intentionally leave it out in AGENTS.md because they are unlikely process-able by coding agent and more targeting human developers. We may move them to AGENTS.md when coding agent become more capable.

Design

Specific Changes

  • Added AGENTS.md and HUMAN.md
  • I have added tests and executed them locally
  • I have updated CHANGELOG.md
  • I have updated documentation

Review Checklist

This section is for contributors to review your work.

  • Accessibility reviewed (tab order, content readability, alt text, color contrast)
  • Browser and platform compatibilities reviewed
  • CSS styles reviewed (minimal rules, no z-index)
  • Documents reviewed (docs, samples, live demo)
  • Internationalization reviewed (strings, unit formatting)
  • package.json and package-lock.json reviewed
  • Security reviewed (no data URIs, check for nonce leak)
  • Tests reviewed (coverage, legitimacy)

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces AGENTS.md guidance documents at the repository root and within several packages to describe package-specific constraints (e.g., platform neutrality) and general coding/testing expectations for contributors and automation agents.

Changes:

  • Added root-level AGENTS.md with coding, typing, testing, and PR-process guidelines.
  • Added package-level AGENTS.md files describing allowed/forbidden technologies for api, base, core, and test.
  • Documented a React + valibot “template” snippet intended as a reference implementation pattern.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
AGENTS.md Adds overarching repo guidelines (deps, platform constraints, typing/runtime validation, testing, PR process).
packages/api/AGENTS.md Declares tech constraints for botframework-webchat-api.
packages/base/AGENTS.md Declares platform-neutral constraints for botframework-webchat-base.
packages/core/AGENTS.md Declares platform-neutral constraints for botframework-webchat-core.
packages/test/AGENTS.md Declares permissive tech constraints for the test framework packages.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

OEvgeny
OEvgeny previously approved these changes Mar 3, 2026
@compulim compulim marked this pull request as ready for review March 3, 2026 02:16
@compulim compulim changed the title [WIP] Add AGENTS.md Add AGENTS.md Mar 3, 2026
@compulim compulim merged commit 6b157f1 into main Mar 3, 2026
30 checks passed
@compulim compulim deleted the feat-agents-md branch March 3, 2026 09:50
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.

3 participants