Skip to content

docs: adopt Universal Code v1.0.0 - #1742

Merged
natechadwick merged 3 commits into
developmentfrom
docs/adopt-universal-code
Aug 3, 2026
Merged

docs: adopt Universal Code v1.0.0#1742
natechadwick merged 3 commits into
developmentfrom
docs/adopt-universal-code

Conversation

@natechadwick-intsof

Copy link
Copy Markdown
Collaborator

Summary

Adopt Universal Code v1.0.0 as the ethical baseline for AI agents working in this repository.

Changes

  • Pin Universal Code v1.0.0 at the top of root and module agent instruction files (AGENTS.md, CLAUDE.md, GEMINI.md) using the embed form for agent sessions
  • Document adoption in README.md with a link to the full canonical document (UC-v1.0.0.md)

Agent files updated

  • Root: AGENTS.md, CLAUDE.md, GEMINI.md
  • Modules: WebUI, system, rest, projects/sitemanage, extensions-main, extensions-workflow, perc-i18n, perc-jetty, perc-distribution-tree, perc-qa-automation, CMLight-Main-cactus-tests

References

Test plan

  • Confirm agent files pin Universal Code v1.0.0 (embed URL)
  • Confirm README.md links to full UC-v1.0.0.md (not embed)
  • Spotless pre-push check passed
  • Human review of agent-rule changes (expected per AGENTS.md hard gate)

Co-Authored by Grok Build using Grok 4.5 with agent Grok.

Pin Universal Code v1.0.0 in root and module agent instruction files
(AGENTS.md, CLAUDE.md, GEMINI.md) and document the adoption in README
with a link to the full canonical UC-v1.0.0.md.

> Co-Authored by Grok Build using Grok 4.5 with agent Grok.
Comment thread README.md
@kilo-code-bot

kilo-code-bot Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
AGENTS.md 7 External, mutable ethics-policy URL remains the sole source for all agent instructions; vendored mitigation was reverted.
Files Reviewed (17 files)
  • AGENTS.md — 1 issue
  • CLAUDE.md — same external dependency
  • GEMINI.md — same external dependency
  • README.md — same external dependency
  • WebUI/AGENTS.md — same external dependency
  • modules/CMLight-Main-cactus-tests/AGENTS.md — same external dependency
  • modules/extensions-main/AGENTS.md — same external dependency
  • modules/extensions-workflow/AGENTS.md — same external dependency
  • modules/perc-distribution-tree/AGENTS.md — same external dependency
  • modules/perc-i18n/AGENTS.md — same external dependency
  • modules/perc-jetty/AGENTS.md — same external dependency
  • modules/perc-qa-automation/AGENTS.md — same external dependency
  • projects/sitemanage/AGENTS.md — same external dependency
  • rest/AGENTS.md — same external dependency
  • system/AGENTS.md — same external dependency
  • docs/policies/UC-EMBED-v1.0.0.md — deleted in the incremental change
  • docs/policies/UC-v1.0.0.md — deleted in the incremental change

Fix these issues in Kilo Cloud

Previous Review Summaries (2 snapshots, latest commit 3d66639)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 3d66639)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
system/AGENTS.md 1 Broken relative path to vendored doc in all 14 submodule AGENTS files (see inline comment for full scope)
Files Reviewed (17 files)
  • AGENTS.md — clean
  • CLAUDE.md — 1 issue (see inline, captured under system/AGENTS.md)
  • GEMINI.md — 1 issue (see inline)
  • README.md — clean (relative link works from repo root)
  • WebUI/AGENTS.md — 1 issue (see inline)
  • docs/policies/UC-EMBED-v1.0.0.md — clean (new vendored copy)
  • docs/policies/UC-v1.0.0.md — clean (new vendored copy)
  • modules/CMLight-Main-cactus-tests/AGENTS.md — 1 issue (see inline)
  • modules/extensions-main/AGENTS.md — 1 issue (see inline)
  • modules/extensions-workflow/AGENTS.md — 1 issue (see inline)
  • modules/perc-distribution-tree/AGENTS.md — 1 issue (see inline)
  • modules/perc-i18n/AGENTS.md — 1 issue (see inline)
  • modules/perc-jetty/AGENTS.md — 1 issue (see inline)
  • modules/perc-qa-automation/AGENTS.md — 1 issue (see inline)
  • projects/sitemanage/AGENTS.md — 1 issue (see inline)
  • rest/AGENTS.md — 1 issue (see inline)
  • system/AGENTS.md — 1 issue (inline posted here)

Notes

  • Previous SUGGESTION (third-party external dependency on monkeyking-hq/universal-code) is resolved in commit 3d66639d49 via local vendoring at docs/policies/UC-v1.0.0.md and docs/policies/UC-EMBED-v1.0.0.md, with upstream commit b7f9d517038af34d1fbe8a80ee8c4d4bb702e5c1 pinned in the vendored file headers.
  • New WARNING introduced by the vendoring commit: the 14 submodule AGENTS files now use a bare relative path docs/policies/UC-EMBED-v1.0.0.md to the repo-root vendored copy. Markdown resolves relative paths against the file's own directory, so these links resolve to non-existent paths like system/docs/policies/UC-EMBED-v1.0.0.md. Root AGENTS.md and README.md are unaffected (they sit at repo root). See inline comment on system/AGENTS.md:1 for fix options.
  • PR description explicitly defers [ ] Human review of agent-rule changes per root AGENTS.md hard gate — acknowledged, not a defect.
  • No code, test, build, or dependency changes; pre-PR per-module clean install not required for this change class.

Fix these issues in Kilo Cloud

Previous review (commit 23c8eee)

Status: 1 Issue Found | Recommendation: Merge after human rule review per root AGENTS.md §"Human review of agent rules (HARD GATE)"

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 1
Issue Details (click to expand)

SUGGESTION

File Line Issue
README.md 5 External dependency on third-party monkeyking-hq/universal-code repo for agent ethics baseline across all 15 changed files. Recommend mirroring UC-v1.0.0.md / UC-EMBED-v1.0.0.md locally (as REVIEW.md does for the Erlang persona) or pinning the upstream commit SHA in the URL.
Files Reviewed (15 files)
  • AGENTS.md — clean
  • CLAUDE.md — clean
  • GEMINI.md — clean
  • README.md — 1 issue (external dependency)
  • WebUI/AGENTS.md — clean
  • modules/CMLight-Main-cactus-tests/AGENTS.md — clean
  • modules/extensions-main/AGENTS.md — clean
  • modules/extensions-workflow/AGENTS.md — clean
  • modules/perc-distribution-tree/AGENTS.md — clean
  • modules/perc-i18n/AGENTS.md — clean
  • modules/perc-jetty/AGENTS.md — clean
  • modules/perc-qa-automation/AGENTS.md — clean
  • projects/sitemanage/AGENTS.md — clean
  • rest/AGENTS.md — clean
  • system/AGENTS.md — clean

Notes

  • All 14 agent files use the embed URL form (UC-EMBED-v1.0.0.md); README.md uses the full canonical URL (UC-v1.0.0.md). PR description confirms this split is intentional.
  • PR description explicitly defers [ ] Human review of agent-rule changes per the hard gate in root AGENTS.md — this is correctly acknowledged, not a defect of the PR.
  • No code, test, build, or dependency changes; pre-PR per-module clean install is not required for this change class.

Fix these issues in Kilo Cloud


Reviewed by minimax-m3 · Input: 50.7K · Output: 2.4K · Cached: 280.6K

Review guidance: REVIEW.md from base branch development

Mirror UC-v1.0.0.md and UC-EMBED-v1.0.0.md under docs/policies/ so agent
and README pins do not depend on a live third-party URL. Pins now read the
vendored embed path; README links the vendored full form with upstream as
source. Upstream commit b7f9d517038af34d1fbe8a80ee8c4d4bb702e5c1.

Addresses review feedback on PR #1742.

> Co-Authored by Grok Build using Grok 4.5 with agent Grok.
Comment thread system/AGENTS.md Outdated
@natechadwick
natechadwick merged commit ee3ddb7 into development Aug 3, 2026
7 checks passed
@natechadwick
natechadwick deleted the docs/adopt-universal-code branch August 3, 2026 05:22
natechadwick-intsof added a commit that referenced this pull request Aug 3, 2026
* docs: adopt Universal Code v1.0.0 for agent guidance

Pin Universal Code v1.0.0 in root and module agent instruction files
(AGENTS.md, CLAUDE.md, GEMINI.md) and document the adoption in README
with a link to the full canonical UC-v1.0.0.md.

> Co-Authored by Grok Build using Grok 4.5 with agent Grok.

* docs: vendor Universal Code v1.0.0 locally

Mirror UC-v1.0.0.md and UC-EMBED-v1.0.0.md under docs/policies/ so agent
and README pins do not depend on a live third-party URL. Pins now read the
vendored embed path; README links the vendored full form with upstream as
source. Upstream commit b7f9d517038af34d1fbe8a80ee8c4d4bb702e5c1.

Addresses review feedback on PR #1742.

> Co-Authored by Grok Build using Grok 4.5 with agent Grok.

* Revert "docs: vendor Universal Code v1.0.0 locally"

This reverts commit 3d66639.

* Fix enforcer issue with AWS SDK.  Update code links

---------

Signed-off-by: Nate Chadwick <263952448+natechadwick-intsof@users.noreply.github.com>
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