Agent launch matrix — one playbook, many agent surfaces
Default recommendation: copy-paste prompt block from Getting started into your preferred agent.
Canonical files
| File | Purpose |
|---|---|
prompts/onboarding/adopt-ship-generic.md | Universal adoption workflow |
prompts/onboarding/adopt-ship-elmundi.md | ElMundi-specific delta |
documentation/adoption/agent-setup-contract.md | Interactive discovery contract |
Cursor (IDE)
- Open target repo.
- Attach
@tools/ship/prompts/onboarding/adopt-ship-generic.md(or equivalent path). - Add instruction: "Run this playbook end-to-end, ask discovery questions first, then open PR."
Codex / CLI agents
codex -- "Read tools/ship/prompts/onboarding/adopt-ship-generic.md and execute it in this repo. Ask discovery questions before changing files."
Claude Code
claude "Read tools/ship/prompts/onboarding/adopt-ship-generic.md and execute it in this repo. Start with interactive discovery questions."
Copilot / chat surfaces
Paste the content of adopt-ship-generic.md + the short instruction above.
Optional helper launcher
You can still use:
curl -fsSL https://raw.githubusercontent.com/ElMundiUA/ship/main/adopt-ship.sh | bash
Treat launcher as convenience, not the canonical contract.
Required behavior across all agent surfaces
- Ask discovery questions before assumptions.
- Propose adaptation options when infrastructure is unknown.
- Record selected mapping (tracker/states/gates) in repo docs.
- Never commit secrets.