Add goal and success definition sections to AGENTS.md - #84
Merged
Conversation
Added a section outlining the goal of the repository and the criteria for success. Emphasized the importance of promoting validated claims and honesty about failures.
vantasnerdan
requested review from
axis-marbell and
mlops-kelvin
as code owners
August 18, 2026 09:56
axis-marbell
approved these changes
Aug 18, 2026
axis-marbell
left a comment
Collaborator
There was a problem hiding this comment.
Approved per repository-owner authorization. Exact head 67813e0 is an AGENTS.md-only Markdown change; the hosted repository-validation check passed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Added a section outlining the goal of the repository and the criteria for success. Emphasized the importance of promoting validated claims and honesty about failures.
Objective and issue
Describe the positive deliverable and the smallest coherent merge boundary.
Canonical issue:
Issue relationship:
Authoring agent:
Intended independent merger:
Change classification
Authority and scope
Base release and commit:
Accepted claims and canonical sources used:
Declared imports, assumptions, and conventions:
Files or concerns intentionally out of scope:
New or materially changed public interfaces:
An exported symbol is not accepted scientific authority by itself. For every
conditional unpromoted API, state its explicit inputs, assumptions, exclusions,
and why it is still independently reusable.
Unit-level disposition
List the smallest coherent units. A mergeable unit must remain useful and true
without relying on an unearned headline claim.
Answer each decision independently:
Verification and sensitivity
List exact commands and results. Include the claim-appropriate oracle,
mutations or counterexamples, numeric refinement and independent route when
applicable, and affected consumer replay. A pass tally by itself is not enough.
GitNexus impact
Record index freshness, pre-change symbol/API impact when applicable, and final
diff change detection. For documentation-only work, state that no graph-mapped
symbol or process was expected or found.
Memory, governance, and generated state
Durable contract or decision entry:
Proposal/campaign/claim/release changes:
Generated outputs and synchronization commands:
Debt remaining inside the proposed merge unit:
Campaign frontier outside this merge unit:
Validation boundary
Mark a nonapplicable scientific row
N/Aand explain why in the verificationsection; do not claim it passed. An additive public export may stay scoped when
impact analysis shows a bounded sector, no changed existing contract, known
consumers, and targeted API coverage. Record that rationale rather than treating
the export alone as a full-suite trigger.
scripts/validate.sh --pytest-scope ...passes with the exact selectors recorded,--fixed-onlyis justified by no affected pytest scope, or the full-suite trigger is explained andscripts/validate.sh --fullpasses; PR CI'sscripts/validate_changed.pydecision agrees.git diff --checkpasses in a separate invocation.Author handoff
State what the reviewer should independently reproduce, the riskiest assumption,
and the next decisive action if this PR advances rather than completes the goal.
Reviewer disposition
Review the actual head commit and complete this section or provide the same
fields in a formal review.
Canonical issue predates PR:
Authoring or implementing agent:
Distinct merger:
Artifact merge:
Claim promotion:
Goal completion:
Merge as written:
Refactor or harvest:
Leave in PR history:
Source PR lifecycle:
Terminal-close evidence:
Next decisive action:
Head branch disposition:
Reviewer checks