Add initial operating standards structure#2
Draft
iperev wants to merge 11 commits into
Draft
Conversation
added 11 commits
July 8, 2026 19:48
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.
Summary
Adds the initial Agent Operating Standards kernel and refines the pull request description standard into an agent-first contract.
The core runtime rule is explicit: external agents load repository bindings, select the standards catalog entry, load the global agent operating kernel when adopted, then use the selected
standard.yamlas the token-efficient task instruction whenagent_entrypointis present.standard.mdremains the proof, rationale, and dispute surface.Context
Agents need durable, versioned owner surfaces for artifact creation and review. Without a catalog, claim taxonomy, repository binding, machine entrypoint, kernel invariants, and artifact-specific standards, agents infer authority from filenames, templates, generated Markdown, pull request bodies, or chat context.
The pull request description standard is the first artifact standard hardened under this model. It defines the universal PR body invariant as
SummaryplusContext, then adds optional sections only when decision-tree triggers are true.Impact
Validationsections.Changes
meta.agent-operating-kernel.v1for repository-wide agent operating invariants.standard.yamlas the machine-readable agent entrypoint for standard packages.meta.standard-package.v1to separate proof/prose, agent contract, schema, semantic rules, templates, and examples.meta.semantic-rules.v1plus validation for unique semantic rule ids.docs/AGENT_CONSUMPTION.mdto define external-agent load order and the final instruction surface.artifact.rendered-view.v1to bound Markdown, HTML, and rendered projections as non-canonical unless freshness is proven.SummaryandContext, structuredreview_scope,change_profiles,readiness_state, and triggered optional sections.Links
docs/AGENT_CONSUMPTION.mdstandards.catalog.yamlstandards/meta/agent-operating-kernel/v1/standard.mdstandards/meta/agent-operating-kernel/v1/standard.yamlstandards/meta/standard-package/v1/standard.mdstandards/meta/semantic-rules/v1/standard.mdstandards/artifacts/rendered-view/v1/standard.mdstandards/artifacts/roadmap/v1/standard.mdstandards/artifacts/pull-request-description/v1/standard.mdstandards/artifacts/pull-request-description/v1/standard.yamlstandards/artifacts/pull-request-description/v1/schema.jsonstandards/artifacts/pull-request-description/v1/semantic-rules.yamlEvidence
npm run validate: passed.git diff --check HEAD~1..HEAD: passed for the latest commit.[codex]: no matches.meta.agent-operating-kernel.v1template and minimal example: passed earlier in this PR.meta.agent-operating-kernel.v1/standard.yamlagainstmeta.standard-package.v1/schema.json: passed earlier in this PR.Risk / Rollback
Risk: The first machine-entrypoint and kernel layer may need migration as issue, release, evidence, validator, renderer, and harness installation standards are admitted.
Rollback: Revert this PR branch to remove the standards kernel and machine-entrypoint layer.
Non-Claims
Review Focus
meta.agent-operating-kernel.v1owns only cross-standard operating invariants.standard.yamlis the routine agent instruction andstandard.mdremains the proof surface.SummaryandContextuniversally visible.Evidenceis conditional and does not reintroduce routine visible validation boilerplate.