Skip to content

* Expand AGENTS.md with comprehensive guidelines#3797

Merged
PWagner1 merged 2 commits into
alphafrom
alpha-agents-enhancements
Jul 4, 2026
Merged

* Expand AGENTS.md with comprehensive guidelines#3797
PWagner1 merged 2 commits into
alphafrom
alpha-agents-enhancements

Conversation

@PWagner1

Copy link
Copy Markdown
Contributor

Replace the short "Recent Tooling Mistakes" notes with a full, structured repository guideline. Adds sections covering build/test/dev commands, shell and environment rules, project structure, architecture, editing philosophy, public API and C# rules, documentation/commenting guidance, changelog/TestForm demo processes, testing guidance, and commit/PR conventions. Also tightens guidance around PowerShell vs cmd.exe and when to run build scripts.

No changelog entry needed.

Replace the short "Recent Tooling Mistakes" notes with a full, structured repository guideline. Adds sections covering build/test/dev commands, shell and environment rules, project structure, architecture, editing philosophy, public API and C# rules, documentation/commenting guidance, changelog/TestForm demo processes, testing guidance, and commit/PR conventions. Also tightens guidance around PowerShell vs cmd.exe and when to run build scripts.
@PWagner1 PWagner1 added this to the Version 110 milestone Jun 27, 2026
@PWagner1 PWagner1 requested a review from a team as a code owner June 27, 2026 06:59
@PWagner1 PWagner1 added area:documentation All issues related to documentation. version:110 All things to do with V110. labels Jun 27, 2026
@PWagner1 PWagner1 marked this pull request as draft June 27, 2026 07:01
@tobitege

tobitege commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

The operational directives at the start, that got removed, might still be worth it to avoid repeated errors that LLM's do still.
I had them added back then as PowerShell was the best supported compared to even git bash etc., so this may of course differ for anyone else.
The file grew a lot, which doesn't have to be a big issue, but maybe less is more - it is meant for the AI, not humans, to explain the crucial parts. :)
Other than that, go for it and we can compare notes and iterate on it.

Added section on recent tooling mistakes to avoid with examples.
@cursor

cursor Bot commented Jul 4, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@PWagner1 PWagner1 marked this pull request as ready for review July 4, 2026 07:28
@PWagner1 PWagner1 merged commit 649bdd9 into alpha Jul 4, 2026
9 checks passed
@PWagner1 PWagner1 deleted the alpha-agents-enhancements branch July 4, 2026 07:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentation All issues related to documentation. version:110 All things to do with V110.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants