Quickstart: add SuperPlane Factory to your project

In this guide, we’ll create a SuperPlane workspace, connect it to a GitHub repository through an intake, and set up our first Software Factory. By the end, you’ll be ready to run a task through implementation, verification, and review using your own Software Factory.

Ready to build your workspace?Sign in to SuperPlane and follow the setup steps below.

Get started

Prerequisites

For the smoothest first run have the following ready:

• A SuperPlane account.
• Access to a GitHub repository that you are comfortable connecting.
• Permission to install or authorize the GitHub integration for that repository.
• A repository with a few open issues for SuperPlane to analyze.
• A normal development setup with existing tests or continuous integration (CI) checks.

NOTE

First Software Factory? Choose a repository with small tasks that have a defined outcome.

Save large architectural changes and work that needs product decisions until you have completed your first factory run.

Good first tasks

• Fix a small bug
• Update documentation
• Fix a failing test
• Update a dependency
• Make a small code improvement

Save for later

• Redesign the entire architecture
• Build a large open ended feature
• Complete a task that needs major product decisions

1. Create your SuperPlane account

Create your SuperPlane account. The onboarding flow guides you through setting up your workspace and connecting your GitHub repository. Follow the steps below to get started.

Need more guidance? Follow Build your first Factory for detailed instructions or watch the Video Walkthrough to see the process in action.

2. Let SuperPlane prepare the workspace

Connect the repository through GitHub during onboarding. SuperPlane prepares the workspace and begins bringing work into the factory.

Intake will automatically imports your recent GitHub Issues and starts reviewing their suitability for agent execution. You do not need to copy tickets into SuperPlane.

3. Open your factory board

Select Go to your board to see your tasks across four stages:

Stage	What happens
Backlog	Incoming tasks are assessed and wait to start.
Implement	An agent plans and makes the code changes.
Verify	Checks and pull request feedback help validate the changes.
Done	The task has completed the factory workflow.

Start with Backlog. This is where you’ll find imported tasks before an agent begins work.

4. Understand what happens next

When you start a task it moves through implementation and verification. A failed check can return the task to the agent with feedback. Work reaches Done when the completion rule is satisfied, such as attaching a pull request after every required status check passes.

Congratulations, you created your first software factory. Have questions or want to see the complete workflow? Follow the guided walkthrough.

Tips for your first run

• Start small: Choose a focused task with a defined expected outcome.
• Add enough context: Describe what should change, where it should change and what success looks like.
• Choose the right repository: Use one with a few open issues and existing tests or CI checks.
• Use the defaults first: Complete the first run before you change agents, automations or verification steps.

Next steps

Build your first factoryConnect work intake to agents and run an issue from backlog to pull request.Understand the factory pipelineLearn what happens in Backlog, Implement, Verify and Done.Learn how automations workSee how SuperPlane combines agents with deterministic workflow steps.Learn about one shot engineeringUnderstand which engineering tasks agents can handle reliably.