Skip to content

Clarify agent coding and architecture guidance - #485

Open
wlewNV wants to merge 3 commits into
mainfrom
dev/wlew/agent_cleanup
Open

Clarify agent coding and architecture guidance#485
wlewNV wants to merge 3 commits into
mainfrom
dev/wlew/agent_cleanup

Conversation

@wlewNV

@wlewNV wlewNV commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

Define simple engineering principles and canonical execution paths so agents extend one coherent architecture instead of copying legacy bypasses.

Define simple engineering principles and canonical execution paths so agents extend one coherent architecture instead of copying legacy bypasses.

Signed-off-by: William Lew <wlew@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Aug 18, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@wlewNV
wlewNV marked this pull request as ready for review August 19, 2026 16:35
@wlewNV

wlewNV commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test 4f5b607

@greptile-apps

greptile-apps Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Updates the repository’s AI-agent guidance to emphasize simple, coherent architecture and canonical execution paths.

  • Establishes principles for readability, locality, dependency direction, configuration ownership, and fail-fast behavior.
  • Adds guidance for abstractions, compatibility paths, typing, error handling, documentation, and behavioral testing.

Confidence Score: 5/5

The documentation-only change appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
AGENTS.md Replaces operational repository guidance with engineering principles intended to steer future agent-authored changes toward a single maintainable architecture.

Reviews (2): Last reviewed commit: "address comments" | Re-trigger Greptile

Comment thread AGENTS.md Outdated
- Prefer plain language over architecture jargon.
- Explain invariants and non-obvious constraints, not line-by-line mechanics.
- Keep docs, examples, and launch commands synchronized with real entry points.
- Use the repository SPDX header on new source files.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

we only need the first 2 lines.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Addressed in latest revision

@wlewNV

wlewNV commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test dca0d92

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.

2 participants