eve-repo-upkeep

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.