Repositories Guide

In OutcomeDev, a Repository (or "Repo") is the home for your project.

What is a Repository?

If you are new to software development, think of a Repository as a project folder that lives in the cloud. It contains:

1. All your files: Code, images, documents.
2. History: A record of every change ever made (Version Control).
3. Collaboration: Tools for people to work together without overwriting each other's work.

We use GitHub, the world's most popular platform for hosting repositories.

Creating a Repository

To start a new project, you need a repository.

1. Click the "+" Icon: Located in the top header or the "New Repo" option in the menu.
2. Owner: Select who will own this repo (usually your personal account).
3. Name: Give it a unique name (e.g., marketing-dashboard, 3d-house-plans).
4. Privacy:
   • Public: Anyone can see it. Good for open-source.
   • Private: Only you can see it. Good for internal tools.
5. Description: A short sentence about what this project is.

Once created, OutcomeDev automatically connects to it. You are ready to start assigning tasks.

Why Version Control Matters

OutcomeDev uses Git under the hood. This provides safety:

• Undo Button: Every change the agent makes is saved as a "Commit." If the agent breaks something, you can revert to the previous version.
• Branches: Agents work on "Branches" (separate timelines). They don't touch your main code until you approve it.
• Pull Requests (PRs): This is a proposal to merge the agent's work into your main project. You can review the changes, see the "Diff" (difference), and approve or reject it.

Importing Existing Repos

Have a project already on GitHub?

1. Click the Repo Selector in the header.
2. Search for your repository name.
3. Select it to start creating tasks for that existing codebase.