Quickstart: add SuperPlane Factory to your project

Use this guide to create a SuperPlane workspace, connect a GitHub repository and open your first software factory board.

By the end of this guide your workspace will be ready for agents, automations and an end to end task run.

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.

First projectChoose 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 a SuperPlane account

Sign up for SuperPlane. Create or enter the workspace where you want to run your software factory. The onboarding flow guides you through creating your first workspace.

Start the onboarding flow to connect your first repository.

To create a workspace for another repository open the workspace switcher in the upper left corner. Select Create new workspace, connect GitHub and choose the repository.

Use the workspace switcher to open an existing workspace or create another one.

Read Build your first Factory for a detailed configuration walkthrough.

2. Let SuperPlane prepare the workspace

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

For GitHub Issues the onboarding flow imports recent open tickets and starts reviewing their suitability for agent execution. You do not need to copy tickets into SuperPlane.

SuperPlane imports work from your repository and starts evaluating what the factory can take on.

3. Open your factory board

Select Go to your board. The factory pipeline contains four stages:

1. BacklogWork is discovered and evaluated.
2. ImplementAn agent plans the task and changes the code.
3. VerifyChecks and review feedback validate the result.
4. DoneThe pull request completes the factory workflow.

Focus on Backlog first. Newly discovered work appears here before implementation begins.

The board shows discovered work and each task’s current factory stage.

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.

Verification can return failed work to the agent before the pull request reaches Done.

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

Video walkthrough Watch a task move from backlog through implementation, verification and review.

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.