[kcargile]

This pull request finalizes the core agent guidance documentation for the OEI Core repository, aligning it with current project conventions and establishing a foundation for future publish readiness. The main updates include a complete rewrite of AGENTS.md, the introduction of a synthesized Copilot instructions file, and the creation of a detailed publish readiness registry. Documentation navigation and registry references have also been updated to reflect these additions.

Core Documentation and Guidance Updates:

• Rewrote AGENTS.md to provide comprehensive, core-specific guidance on repository scope, package layout, documentation, tooling, branching, release process, and OSS posture. This replaces the previous placeholder and brings the guidance in line with OEI standards.
• Added .github/copilot-instructions.md, synthesizing agent guidance from AGENTS.md for use by Copilot and other AI agents. This ensures consistent instructions for automated tooling and contributors.

Publish Readiness and Registry Improvements:

• Created docs/registry/core-publish-readiness-registry.md, a detailed tracker for all workstreams required to bring OEI Core to publish-ready status, including audit status, evidence, and next steps for each item.
• Updated documentation navigation: added the core publish readiness registry to docs/TOC.md and referenced it in docs/registry/README.md for improved discoverability. [1] [2]

Release Process and Changelog:

• Added a changeset entry to document these updates and trigger a patch release for @openendurance/core.

[changeset-bot]

🦋 Changeset detected

Latest commit: 25fced7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@openendurance/core	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

🟡 Changes recommended

The registry incorrectly identifies configured Biome artifact exclusions as a publish-readiness gap.

1 open issue

• The stated exclusion gap is already covered: biome.json:3–6 enables VCS ignore-file support, and… · New

What changed in this PR

Establishes repository-specific agent guidance and a registry for tracking OEI Core’s publish readiness.

Changes:

• Expands agent guidance and adds Copilot instructions.
• Adds the publish-readiness registry and documentation links.
• Adds a patch changeset for @openendurance/core.

File	Description
docs/​TOC.md	Links the new registry.
docs/​registry/​README.md	Adds the registry to its index.
docs/​registry/​core-publish-readiness-registry.md	Tracks readiness checks, evidence, and follow-up work.
AGENTS.md	Replaces placeholder guidance with repository conventions.
.github/​copilot-instructions.md	Adds aligned Copilot guidance.
.changeset/​smart-roses-sleep.md	Records the documentation update for versioning.

_{Review effort: Balanced}

[Copilot]

🟢 Approval recommended

No blocking findings remain in the documentation, navigation, and changeset updates.

No open issues 🎉

1 resolved since last review

• The stated exclusion gap is already covered: biome.json:3–6 enables VCS ignore-file support, and…

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The registry’s table formatting must be corrected to satisfy the repository’s Markdown formatting check.

1 open issue

• Registry Markdown is not Prettier-formatted · New

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The root lint command removes Biome lint-rule validation from the CI path.

2 open issues

• Replacing Biome with prettier --check removes lint-rule validation for root files such as… · New
• Registry Markdown is not Prettier-formatted

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The CI test gate fails without test suites, and signing guidance needs corrections for setup, history-rewrite scope, and diagnostics.

4 open issues

• pnpm test fails because Jest finds no test suites · New
• New signing key is not loaded or configured for Git · New
• Root rebase rewrites shared ancestors of the feature branch · New
• Command omits valid gpgsig header from merge commit · New

2 resolved since last review

• Replacing Biome with prettier --check removes lint-rule validation for root files such as…
• Registry Markdown is not Prettier-formatted

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

The CI workflow skips its only validation job for Dependabot PRs.

No open issues 🎉

1 previously missed issue

In code that hasn't changed since last review

Dependabot PRs skip all required validation checks

.github/​workflows/​ci.yml:34

For PRs opened by dependabot[bot], this condition skips the workflow's only job, so none of the lint, build, typecheck, or test steps run. Skipped jobs can satisfy required status checks, leaving those dependency updates without validation from this workflow. Remove the actor guard so Dependabot PRs follow the same checks as other PRs.

4 resolved since last review

• Command omits valid gpgsig header from merge commit
• Root rebase rewrites shared ancestors of the feature branch
• New signing key is not loaded or configured for Git
• pnpm test fails because Jest finds no test suites

_{Review effort: Balanced}

[Copilot]

🟢 Approval recommended

No unresolved blocking issues remain, and the root-lint change was explicitly confirmed as intentional.

No open issues 🎉

_{Review effort: Balanced}

[Copilot]

🟢 Approval recommended

Static review identified no unresolved blockers, and the root-lint change is explicitly confirmed as intentional.

No open issues 🎉

_{Review effort: Balanced}