Eve Repo Upkeep

Keep an app repo current with Eve conventions. The checks are independent — run them in parallel when multiple areas need attention.

When to Use

After Eve platform updates or manifest schema changes
Before a major deploy or release
When onboarding a new maintainer

Phase 1: Assess

Quickly determine which areas need attention. Check which of these files exist and whether they look stale — don't deep-read every file, just note which areas need work:

.eve/manifest.yaml — does it exist? Is the schema line eve/compose/v1?
skills.txt — does it exist? Are there pinned or obsolete entries?
AGENTS.md / CLAUDE.md — do they reference current skills?
agents/ directory — do agents.yaml, teams.yaml, chat.yaml exist?
Codebase — any obvious deprecated CLI patterns or inline secrets?

If only one area needs work, handle it directly. Otherwise, proceed to Phase 2.

Phase 2: Dispatch Workers

Create one worker per area that needs updating. Each worker description below is self-contained — a worker can execute its area independently without context from the others.

Worker: Manifest Alignment

Check and fix .eve/manifest.yaml:

Ensure schema: eve/compose/v1 is present.
Prefer services: over legacy components:.
Keep x-eve ingress and pipeline definitions accurate.
Keep x-eve.defaults in sync with harness defaults (harness/profile/options).
Keep x-eve.agents profiles aligned with orchestration policy.
Ensure x-eve.agents.config_path and x-eve.chat.config_path point to valid files.
Confirm ${secret.KEY} usage for secrets.
Deploy pipelines should include a build step before release.
Services with Docker images should have build.context defined.
Registry auth secrets (REGISTRY_USERNAME + REGISTRY_PASSWORD) are required only for custom BYO registries.

Worker: Skills File

Check and fix skills.txt:

Keep Eve skillpack references up to date.
Remove obsolete packs or pinned versions.

Worker: Agent Instructions

Check and fix AGENTS.md, CLAUDE.md, and agents/ config files:

Update skill references to include eve-se-index.
Remove stale commands or URLs.
agents/agents.yaml defines agents and skills — verify entries are current.
agents/teams.yaml defines team composition and dispatch — verify structure.
agents/chat.yaml defines chat routing rules and permissions — verify rules.

Worker: Deprecated Patterns

Search the codebase for deprecated patterns and fix or flag them:

Old CLI commands (eve deploy vs eve env deploy)
Old deploy syntax without --ref parameter
Hardcoded domains in docs or manifests
Inline secrets in repo files
Dockerfiles missing org.opencontainers.image.source label pointing to the repo URL
Pipelines missing build step before release
Services with Docker images but no build.context configuration
Missing registry authentication secrets for custom registries (REGISTRY_USERNAME, REGISTRY_PASSWORD or provider-equivalent names)

Phase 3: Verify

After all workers complete, run final verification:

# Local validation (Docker Compose)
docker compose up --build

# Staging deploy (requires --ref with 40-char SHA or a ref resolved against --repo-dir)
eve env deploy staging --ref main --repo-dir .

# Use --direct to bypass pipeline if needed
eve env deploy staging --ref main --repo-dir . --direct

Track the deploy job with eve job follow.

eve-repo-upkeep