Skip to content

Add goal and success definition sections to AGENTS.md - #84

Merged
axis-marbell merged 1 commit into
mainfrom
vantasnerdan-AGENTS-patch-1
Aug 18, 2026
Merged

Add goal and success definition sections to AGENTS.md#84
axis-marbell merged 1 commit into
mainfrom
vantasnerdan-AGENTS-patch-1

Conversation

@vantasnerdan

Copy link
Copy Markdown
Owner

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:

  • The canonical issue existed before this PR was submitted.
  • I will not merge this PR because I opened it, authored a commit, or materially implemented it.

Change classification

  • Reusable implementation or tooling
  • Documentation or workflow
  • Scientific proposal or campaign evidence
  • Claim promotion transaction
  • Harvest from an incomplete research PR
  • Compatibility-only repair

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:

Symbol or module Authority status Accepted claim IDs Owning issue/PR Conditional boundary
accepted claim / conditional unpromoted / non-scientific utility none or exact IDs

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.

Unit Local claim or purpose Dependencies Evidence and tests Proposed disposition
merge / refactor / history only

Answer each decision independently:

  • Artifact merge:
  • Claim promotion:
  • Goal completion:

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.

# command
# exit status and meaningful verdict

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/A and explain why in the verification
section; 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.

  • Targeted tests and named scientific verifiers pass.
  • Load-bearing mutations, counterexamples, or wrong-convention probes fail as expected.
  • Affected downstream consumers replay.
  • scripts/validate.sh --pytest-scope ... passes with the exact selectors recorded, --fixed-only is justified by no affected pytest scope, or the full-suite trigger is explained and scripts/validate.sh --full passes; PR CI's scripts/validate_changed.py decision agrees.
  • The pytest scope remains valid against the merge base; an equivalent unchanged validation is not duplicated.
  • git diff --check passes in a separate invocation.
  • No unrelated, generated-by-hand, or host-specific artifacts are included.

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

  • Base release, issue, accepted boundary, diff, memory, and discussion inspected.
  • The canonical issue existed before the PR was submitted.
  • The designated merger did not open, author a commit for, or materially implement the PR.
  • Load-bearing result independently rederived or reproduced.
  • Dependencies, conventions, imports, consumers, and GitNexus impact audited.
  • Every new public symbol has an explicit authority status and owning issue.
  • Verification sensitivity and applicable numerical/formal limits audited.
  • Merge, claim-promotion, and goal-completion decisions kept independent.
  • A finite refactor or harvest has an owner/handoff, live PR, and landing test; its source PR remains open.
  • Any proposed unmerged closure passes the terminal-close test and records landed replacements.
  • Canonical issue handoff is posted or preserved ready to post.
  • The exact same-repository head will be deleted after merge; open or closed-unmerged/failed heads are preserved unless an owner explicitly retires them.

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.

@axis-marbell axis-marbell left a comment

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.

Approved per repository-owner authorization. Exact head 67813e0 is an AGENTS.md-only Markdown change; the hosted repository-validation check passed.

@axis-marbell
axis-marbell merged commit 37bd550 into main Aug 18, 2026
1 check passed
@axis-marbell
axis-marbell deleted the vantasnerdan-AGENTS-patch-1 branch August 18, 2026 10:13
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