Skip to content

Add reference in AGENTS.md for document location#73

Merged
Malcolmnixon merged 3 commits intomainfrom
copilot/add-reference-to-docs-introduction
Mar 31, 2026
Merged

Add reference in AGENTS.md for document location#73
Malcolmnixon merged 3 commits intomainfrom
copilot/add-reference-to-docs-introduction

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 31, 2026

Adds a reference to docs/design/introduction.md in AGENTS.md so that agents can quickly locate the System/Subsystem/Unit breakdown for the repository.

Description

Updated the Project Structure Template section of AGENTS.md to list the docs/design/ folder as a sub-entry under docs/, with introduction.md listed beneath it as plain text describing that it contains the System/Subsystem/Unit breakdown for the repository.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Code quality improvement

Pre-Submission Checklist

Before submitting this pull request, ensure you have completed the following:

Build and Test

  • Code builds successfully: dotnet build --configuration Release
  • All unit tests pass: dotnet test --configuration Release
  • Code produces zero warnings

Code Quality

  • Code formatting is correct: dotnet format --verify-no-changes
  • New code has appropriate XML documentation comments
  • Static analyzer warnings have been addressed

Quality Checks

Please run the following checks before submitting:

  • All linters pass: ./lint.sh (Unix/macOS) or cmd /c lint.bat / ./lint.bat (Windows)

Testing

  • Added unit tests for new functionality
  • Updated existing tests if behavior changed
  • All tests follow the AAA (Arrange, Act, Assert) pattern
  • Test coverage is maintained or improved

Documentation

  • Updated README.md (if applicable)
  • Updated ARCHITECTURE.md (if applicable)
  • Added code examples for new features (if applicable)
  • Updated requirements.yaml (if applicable)

Additional Notes

The change adds a design/ folder entry under docs/ in the Project Structure Template section, with introduction.md listed beneath it as plain text (no link). markdownlint and cspell pass with no issues.

@Malcolmnixon
Copy link
Copy Markdown
Member

@copilot Please begin work on this

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Mar 31, 2026

@copilot Please begin work on this

Done. Added a short reference to docs/design/introduction.md (System/Subsystem/Unit breakdown) under the Project Structure Template section in AGENTS.md using a reference-style link (commit 2016aad).

Copilot AI changed the title [WIP] Add reference in AGENTS.md for document location Add reference in AGENTS.md for document location Mar 31, 2026
Copilot AI requested a review from Malcolmnixon March 31, 2026 14:31
@Malcolmnixon Malcolmnixon marked this pull request as ready for review March 31, 2026 14:41
Copilot AI review requested due to automatic review settings March 31, 2026 14:41
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

Updates repository agent guidance documentation to make the detailed design “System/Subsystem/Unit” breakdown easier to discover via the documented docs/ structure.

Changes:

  • Adds a docs/design/ entry to the Project Structure Template in AGENTS.md.
  • Notes docs/design/introduction.md as the location for the System/Subsystem/Unit breakdown.

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

@Malcolmnixon Malcolmnixon merged commit 00a6c21 into main Mar 31, 2026
10 checks passed
@Malcolmnixon Malcolmnixon deleted the copilot/add-reference-to-docs-introduction branch March 31, 2026 14: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