Deepveloper

Interactive CLI for installing the Deepveloper AI agent into your repo — with a Karpathy-principled system prompt and Matt Pocock's engineering skills.

Quickstart (30-second setup)

npx deepveloper@latest

The CLI will:

1. Display the banner
2. Prompt you to confirm before making changes
3. Detect which AI coding tools you have installed (opencode, Claude Code)
4. Write the deepveloper agent definition for each tool you use
5. Guide you to install Matt Pocock's engineering skills yourself

[!TIP] Run npx deepveloper@latest --yes to skip all confirmation prompts and accept defaults.

What Gets Created

| If you use… | Agent file | |---|---| | opencode | .opencode/agents/deepveloper.md — YAML frontmatter + full prompt | | Claude Code | .claude/deepveloper.md — raw prompt body | | Both | Both agent files |

The CLI does not install skills or write AGENTS.md / CLAUDE.md — it guides you through it at the end, and you run the skills setup yourself.

Why Deepveloper Exists

Setting up an AI coding agent with proper engineering practices is a manual, fragmented process — write config files for each tool, understand different agent definition formats, install skills separately. Deepveloper replaces all of that with one command.

System prompt you'd trust

The agent prompt isn't a generic "you are an expert." It's a 6-section prompt combining Karpathy's four principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) with a senior software engineer persona:

| Section | Purpose | |---|---| | Identity | Senior software engineer — pragmatic, precise, responsible | | Core Principles | Karpathy's principles verbatim | | Communication | Concise, honest, no over-apologizing | | Workflow | Understand → Plan → Implement → Verify → Iterate (max 3 retries) | | Code Standards | Conventions over comments, security first | | Tool Usage | Precise tools, batch parallel ops, ask before destructive actions |

No config sprawl

Instead of managing separate configs for opencode and Claude Code, Deepveloper detects what you have and writes the right files for each — with the same prompt, same persona, same principles across all your tools.

Engineering skills, installed by you

Matt Pocock's skills (code-review, TDD, domain-modeling, grilling, and more) are installed with one command the CLI prints at the end: npx skills@latest add mattpocock/skills. After that, run /setup-matt-pocock-skills in your agent to configure your issue tracker, triage labels, and domain docs.

CLI Reference

deepveloper — Install the Deepveloper senior engineer AI agent

USAGE
  npx deepveloper@latest         Run the interactive installer
  npx deepveloper@latest --help  Show this help
  npx deepveloper@latest --yes   Skip confirmation prompts

FLAGS
  --yes, -y   Skip all confirmation prompts and auto-overwrite
  --help, -h  Show this help message
  --version   Show the version number

Development

npm install       # Install dependencies
npm run build     # Build TypeScript
npm test          # Run tests (40 tests, 5 files)

Project structure

src/
├── cli.ts        Entry point — arguments, prompts, orchestration
├── detect.ts     Tool detection (opencode, Claude Code)
├── install.ts    Agent definition writing, skills guide
├── prompt.ts     6-section system prompt template
├── types.ts      Shared types
└── utils/
    └── fs.ts     writeFileSafe, ensureDir
tests/
├── cli.test.ts
├── detect.test.ts
├── install.test.ts
├── prompt.test.ts
└── utils/
    └── fs.test.ts
docs/
├── specs/
│   └── deepveloper-spec.md
└── research/
    └── senior-engineer-prompt-research.md

Requires Node.js 18+.