Skip to content

docs(agents): keep project skills synchronized#2349

Open
pimlock wants to merge 3 commits into
mainfrom
sync-agent-skills/pimlock
Open

docs(agents): keep project skills synchronized#2349
pimlock wants to merge 3 commits into
mainfrom
sync-agent-skills/pimlock

Conversation

@pimlock

@pimlock pimlock commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

OpenShell's project behavior and agent skills have accumulated significant drift. This PR refreshes the relevant CLI, inference, and cluster-debugging guidance, then adds conditional synchronization checks to build and review workflows so future product and workflow changes keep their companion skills current.

Related Issue

N/A

Changes

  • Refresh the OpenShell CLI reference and operational workflows to match current commands and behavior
  • Update inference and cluster debugging guidance for current routes, authentication, interceptors, and compute drivers
  • Teach policy authoring and CLI iteration about dynamic network_middlewares, including ordering, host selection, registration boundaries, and failure behavior
  • Add operator-run supervisor middleware startup and request-path diagnostics to the cluster debugger
  • Capture the latest portable Kubernetes sandbox-name constraints and symlink-preserving upload behavior
  • Centralize the skill-maintenance map in sync-agent-infra while keeping AGENTS.md compact
  • Route future supervisor middleware changes through the relevant policy, CLI, and cluster-debugging skills
  • Add conditional sync-agent-infra gates to PR creation, issue builds, PR review, and the shared principal-engineer reviewer
  • Reconcile missing skill and crate inventory entries discovered by the consistency audit

Testing

  • mise run pre-commit passes
  • Unit tests added/updated (documentation and agent-workflow changes only)
  • E2E tests added/updated (not applicable)
  • Agent infrastructure consistency audit passes
  • Direct Markdown lint of touched agent files passes
  • Skill metadata validation passes for all updated skills
  • DNS-1123 sandbox-name validation examples pass

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (not applicable; architecture inventory updated in AGENTS.md)

pimlock added 3 commits July 17, 2026 16:22
Signed-off-by: Piotr Mlocek <pmlocek@nvidia.com>
Signed-off-by: Piotr Mlocek <pmlocek@nvidia.com>
Signed-off-by: Piotr Mlocek <pmlocek@nvidia.com>
@pimlock
pimlock force-pushed the sync-agent-skills/pimlock branch from 5c56f8c to 8480fde Compare July 17, 2026 23:31
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.

1 participant