Skip to content

docs: add AGENTS.md worker and trust flow notes#50

Merged
aymenfurter merged 3 commits into
microsoft:mainfrom
KunjShah95:docs/agents-md
May 25, 2026
Merged

docs: add AGENTS.md worker and trust flow notes#50
aymenfurter merged 3 commits into
microsoft:mainfrom
KunjShah95:docs/agents-md

Conversation

@KunjShah95
Copy link
Copy Markdown
Contributor

Adds the canonical AGENTS.md notes for the three worker subsystems and the local rule trust lifecycle. Includes links to the existing anti-patterns and rule editor docs so agents can follow the source material.

Copilot AI review requested due to automatic review settings May 24, 2026 12:36
@aymenfurter
Copy link
Copy Markdown
Contributor

@KunjShah95 Thanks, this looks great! Could you also add a small index to the docs page that lists all the available documentation files?

Something like:

docs/
├── features/
│   ├── _index.md
│   ├── getting-started/
│   │   ├── _index.md
│   │   ├── installation.md
│   │   └── supported-tools.md
│   ├── improve/
│   │   ├── _index.md
│   │   ├── anti-patterns.md
│   │   ├── context-health.md
│   │   ├── data-explorer.md
│   │   ├── rule-editor.md
│   │   ├── rule-playground.md
│   │   └── skill-finder.md
│   ├── level-up/
│   │   ├── _index.md
│   │   ├── achievements.md
│   │   ├── learning.md
│   │   ├── sdlc.md
│   │   └── share.md
│   ├── measure/
│   │   ├── _index.md
│   │   ├── burndown.md
│   │   ├── output.md
│   │   └── patterns.md
│   └── observe/
│       ├── _index.md
│       ├── dashboard.md
│       └── timeline.md
└── _index.md

This would make it easier for agents/readers to see the full doc structure at a glance.

@aymenfurter aymenfurter self-assigned this May 24, 2026
Copy link
Copy Markdown
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

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new AGENTS.md file at the repository root that briefly documents the worker modules and the local rule trust flow.

Changes:

  • Introduces AGENTS.md with a "Workers" section listing three worker files and their input/output summaries.
  • Adds a "Local Rule Trust Flow" section linking to related documentation.

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

Comment thread AGENTS.md Outdated
@@ -0,0 +1,9 @@
# Workers
@aymenfurter aymenfurter added documentation Improvements or additions to documentation enhancement New feature or request labels May 24, 2026
@KunjShah95
Copy link
Copy Markdown
Contributor Author

i have added up do check it out now

@KunjShah95
Copy link
Copy Markdown
Contributor Author

@microsoft-github-policy-service agree

@KunjShah95 KunjShah95 requested a review from Copilot May 24, 2026 14:51
@KunjShah95
Copy link
Copy Markdown
Contributor Author

@aymenfurter do check it out

1 similar comment
@KunjShah95
Copy link
Copy Markdown
Contributor Author

@aymenfurter do check it out

Copy link
Copy Markdown
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.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@aymenfurter
Copy link
Copy Markdown
Contributor

Can we move the Documentation Index to the AGENTS.md file? otherwise looks good

@KunjShah95
Copy link
Copy Markdown
Contributor Author

Now do check

@KunjShah95
Copy link
Copy Markdown
Contributor Author

@aymenfurter

@aymenfurter aymenfurter merged commit 9007bed into microsoft:main May 25, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants