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 .