docs(agent): document NEMU agent maintenance standards#1066
Open
xiaokamikami wants to merge 2 commits into
Open
docs(agent): document NEMU agent maintenance standards#1066xiaokamikami wants to merge 2 commits into
xiaokamikami wants to merge 2 commits into
Conversation
xiaokamikami
requested review from
Anzooooo,
good-circle and
poemonsense
as code owners
NEMU Performance Results - XS Interpreter
NEMU Performance Results - XS Ref Shared Object
|
xiaokamikami
force-pushed
the
maint/nemu-harness
branch
from
93b00c2 to
10f31dc
Compare
NEMU Performance Results - XS Interpreter
NEMU Performance Results - XS Ref Shared Object
|
Module: docs-only / agent. This commit adds repository-local agent skills that describe NEMU harness maintenance, module boundaries, commit format, and delivery gates without changing executable NEMU behavior. Constraint: NEMU needs repository-local maintenance guidance for AI agents without using Codex-specific .codex directories. Constraint: AI-authored commits must use NEMU's existing Conventional Commit title style plus Lore trailers, and must stay inside one NEMU module boundary unless the body explains a narrow exception. Constraint: AI-maintained NEMU changes that can affect execution must prove local NEMU-as-DUT Linux execution under Spike DiffTest before full handoff. Rejected: Storing the harness skill under .codex | the repository should keep agent assets in an explicit project-owned directory. Rejected: Multi-module AI commits by default | they make review, revert, and regression isolation too hard for NEMU's architecture. Rejected: Treating syntax/build checks as sufficient delivery evidence for execution-sensitive changes | they do not prove NEMU can still boot Linux under Spike DiffTest. Confidence: medium Scope-risk: narrow Directive: Keep agent/ focused on agent-facing workflows, module boundaries, commit standards, and validation guidance; do not mix it with generated local IDE or Codex runtime state. Tested: git diff --check. Not-tested: Loading these skills through an external AI-agent runtime; running the required Linux DiffTest smoke, because this commit only documents the standard.
Module: docs-only / agent. This commit adds a repository-local software architecture map for AI agents and links the existing skills to it, without changing executable NEMU behavior. Constraint: Agent guidance should improve architectural understanding through documentation rather than hard-gating maintenance with scripts. Constraint: The architecture map must be broad enough to classify module ownership and validation impact before editing NEMU code. Rejected: Adding script-based enforcement for now | the requested direction is documentation guidance, not hard local gates. Confidence: medium Scope-risk: narrow Directive: Keep agent/architecture.md as the first-read map for future agent changes; update it when module boundaries or major execution flows change. Tested: git diff --check. Not-tested: Loading this architecture document through an external AI-agent runtime.
xiaokamikami
force-pushed
the
maint/nemu-harness
branch
from
10f31dc to
9ecf604
Compare
NEMU Performance Results - XS Interpreter
NEMU Performance Results - XS Ref Shared Object
|
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
1 participant
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.
This PR adds repository-local guidance for AI-assisted NEMU maintenance under
agent/.It introduces:
agent/skills/nemu-harness.mdagent/skills/nemu-delivery-standard.mdtype(scope): intentplus Lore trailersagent/architecture.mdThis PR is documentation-only and does not change executable NEMU behavior.
Tested:
git diff --checkNot-tested: