Skip to content

[EA] Add org-wide AI agent instruction baseline - #56

Closed
wfieldx wants to merge 1 commit into
mainfrom
wf-ea-2130
Closed

wfieldx wants to merge 1 commit into
mainfrom
wf-ea-2130

Conversation

@wfieldx

@wfieldx wfieldx commented Mar 3, 2026

Copy link
Copy Markdown

What

Adds the org-wide AI agent instruction baseline files (AGENTS.md and CLAUDE.md) to this repository.

Why

These files provide consistent architectural guidance to AI coding agents (Claude Code, GitHub Copilot, Cursor, and others) working in this codebase. They codify b.well's architecture standards, design principles, security requirements, and testing discipline so agents produce code aligned with platform conventions.

What These Files Do

  • AGENTS.md: Universal baseline read by GitHub Copilot (native since Aug 2025), Cursor, Windsurf, Aider, and other tools. Sets the floor for architecture, SOLID principles, distributed systems patterns, security, testing, and operational standards.
  • CLAUDE.md: Symlink to AGENTS.md (Claude Code compatibility).

Relationship to Existing Instructions

If this repo already has .github/copilot-instructions.md, that file is unchanged. It provides repo-specific context (service identity, commands, domain details) that extends the org-wide baseline. AGENTS.md sets the floor; repo-level files add specifics.

Governance

These files are owned by Enterprise Architecture. Changes require EA review (CODEOWNERS enforced).

Status

This is a DRAFT PR. EA is currently validating instruction files in pilot repositories. This PR will be marked ready for review after validation completes.

For full context: https://icanbwell.atlassian.net/wiki/spaces/ENTARCH/pages/6081708037

Related

  • JIRA: EA-2130
  • Phase: Phase 2 baseline distribution

Adds AGENTS.md and CLAUDE.md to establish consistent architectural
guidance for AI coding agents (Claude Code, GitHub Copilot, Cursor).

Files:
- AGENTS.md: Universal baseline (event-driven, SOLID, security, testing)
- CLAUDE.md: Symlink to AGENTS.md (Claude Code compatibility)
- CODEOWNERS: EA ownership of instruction files

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@wfieldx

wfieldx commented Oct 28, 2026

Copy link
Copy Markdown
Author

Closing this. Org AI-agent standards now reach every Claude Code session through the b.well Claude org's managed settings, so the copied org instruction files are no longer needed and this sync is retired. If this repo still carries an org copy of AGENTS.md, CLAUDE.md or .claude/rules, a separate cleanup PR or issue will follow. Your team's own instructions stay yours. The background is in https://github.com/icanbwell/.github/tree/main/policies/claude (EA-2774).

@wfieldx wfieldx closed this Oct 28, 2026
@wfieldx
wfieldx deleted the wf-ea-2130 branch October 28, 2026 20:37
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