Software Factory
General

Quickstart

Complete your first 8090 Software Factory workflow, from project creation through implementation of a work order.

Complete your first workflow

This guide walks you through your first 8090 Software Factory workflow, from creating a project to implementing your first work order.

Create or join an organization

An Organization is a private workspace where teams collaborate across one or more projects. During sign-up, a new user can create an organization or join an existing one after receiving an invitation from the organization admin.

  • If you are starting a new workspace, create an organization during sign-up; you will become its administrator.
  • If an administrator invited you to an existing organization, accept the invitation and sign in with the invited account.
  • Organization administrators can invite additional members from the Organization Console.

See Organization Management for membership, roles, and administration details.

Create your first project

A Project captures all of the knowledge and documentation that defines the intent of the software and guides users from requirements gathering to software delivery.

  • After signing in, click Create New Project and enter a project name.
  • Once created, 8090 Software Factory opens the Project Overview dashboard.

Connect your repository (optional)

Connecting a codebase to a project allows 8090 Software Factory agents to index and read the code. This supports writing blueprints and work orders and keeps documentation synchronized with the codebase after a release.

  • Open Settings → Codebase and choose GitHub or GitLab.
  • For GitHub, install the 8090 Software Factory GitHub App and grant it access to your repository. For GitLab, authorize 8090 Software Factory and select your project.
  • Select the repository or project and the branch to index, then confirm the connection.
  • Confirm that the connection was created and indexing is in progress.

See Codebase Connection for more details.

Add supporting knowledge (optional)

Knowledge Base files give 8090 Software Factory agents additional context while generating requirements, blueprints, and work orders.

  • Navigate to Knowledge Base in the primary sidebar if you have supporting documents that provide project context.
  • Upload any files that will help 8090 Software Factory agents build out your project.

See Knowledge Base for more details.

Define your product requirements

The Requirements module manages documents that capture product intent. Product Overview documents capture the product’s motivation and executive summary, while Feature Requirements documents capture feature-level requirements.

  • Navigate to Requirements using the top-left module selector.
  • Engage with the Getting Started alert in the agent chat panel to collaborate with the agent on Product Overview documents and begin creating Feature Requirements documents.
  • Tell the agent whether it should initialize the requirements from an existing project or start fresh.

Create technical Blueprints

The Blueprints module houses the core architectural designs and implementation decisions for the product. Container and Component Blueprints capture the shared infrastructure and reusable capabilities of the product, while Feature Blueprints capture feature-specific architectural details.

  • Navigate to Blueprints using the module selector.
  • Select a template to initialize Container, Component, and Feature Blueprints with your configured outlines.
  • Document core technology decisions in Container Blueprints, and capture reusable, cross-feature capabilities in Component Blueprints.
  • Choose a Feature Blueprint and work with the Blueprints Agent to define its technical specification. The Quick Q&A action guides you through key decisions step by step.

Generate Work Orders

The Work Orders module coordinates the work required to build the product. Work Orders are created from upstream requirements and blueprints and packaged into context-rich prompts that coding agents and developers can execute.

  • Navigate to Work Orders using the module selector.
  • Click Extract Work Orders in the agent chat panel to generate Work Orders from your Blueprints and Requirements.
  • Review the resulting Work Orders, assign them, and sequence them into phases.

Connect to a coding agent via MCP

Work Orders integrates with local development environments through the Model Context Protocol (MCP). Coding agents such as Cursor or Claude Code can pull Work Order details and update statuses directly from the IDE. The MCP connection uses an API key scoped to a specific project and user.

  • In Work Orders, follow the popup instructions to connect your coding agent to 8090 Software Factory via MCP.
  • Tell your coding agent to get the next Work Order from 8090 Software Factory.
  • Monitor the coding agent as it executes the Work Order.
  • When the agent finishes, it marks the Work Order as In Review.

Next Steps

Congratulations on completing your first Work Order. This is a simple forward pass from requirements to code, but there is much more to explore:

  • Complete more Work Orders for the Blueprints you have written.
  • After completing a phase, push your code to the indexed branch. The Blueprints Agent checks for drift between the blueprints and code and guides you through discrepancies.
  • Create more features in Requirements, write Blueprints for them, and extract more Work Orders.
  • When requirements change, update the Product Overview or Feature Requirements document and flow those changes downstream through features, Blueprints, and Work Orders.
  • After deploying the first version of your product, consider setting up feedback collection in Feedback.

Further Reading

  • Requirements — Learn structured product and feature authoring with agent-assisted drafting.
  • Blueprints — Learn advanced Blueprint techniques.
  • Work Orders — Optimize your task management workflow.
  • Feedback — Set up comprehensive feedback systems.

Getting Help

On this page