Vibe Traders is a personal learning project for exploring human-supervised, agentic software development workflows. It uses the third-party SpaceTraders API as the basis for building and evolving a real application with coding agents.
The project explores workflows in which coding agents perform much of the implementation work, while a human directs, reviews, and integrates their changes.
The central question is how repository structure, architecture, documentation, contracts, tests, tooling, and human review can help multiple coding agents make changes that are:
- narrowly scoped;
- compatible with existing behavior;
- respectful of architectural boundaries;
- independently verifiable;
- safe to develop concurrently.
The emphasis is not merely on generating code. It is on learning how to build an engineering environment in which work can be delegated to agents, developed concurrently, and then understood, reviewed, and trusted by a human.
The application may eventually include a shared backend and several interfaces, such as a web dashboard, mobile application, command-line tools, and an MCP server. The exact scope and technologies will emerge through the experiment.
The project is in its initial exploration and scaffolding stage. Technologies, components, and architectural ideas are provisional until they are explicitly adopted and recorded.
Project-wide documentation and decision records live in docs/.
Individual applications and packages may keep their own documentation beside
their code when they are introduced.