​
What are Workflows?

Inside Assembly, you’ll often find yourself handling similar types of tasks - maybe you’re creating PRDs for different features, or perhaps you’re breaking down technical specifications into actionable tickets. Workflows are your way of capturing and standardizing these processes, making them repeatable and shareable across your team.

Think of workflows as smart templates that combine:

  • The context you need (like codebase access or documentation)
  • The process steps you want to follow
  • The output format you expect
  • Any specific tools or integrations you regularly use

​
Core Components

Process Guidelines

Your team’s best practices and standard operating procedures, transformed into guided steps

Smart Context

Automatic access to relevant code, docs, and tools based on the task at hand

Output Templates

Standardized formats for your deliverables, from documents to tickets

​
How Workflows Work

Let’s say you’re creating a workflow for breaking down feature specifications into development tickets:

1

Define Your Process

Specify how your team likes to approach task breakdown:

  • Required information gathering
  • Estimation guidelines
  • Dependency mapping approach
2

Set Up Context

Configure what information should be automatically available:

  • Relevant codebases
  • Documentation standards
  • Example tickets
3

Create Templates

Define standardized formats for:

  • Ticket structure
  • Acceptance criteria
  • Time estimation
4

Add Integrations

Connect with your tools:

  • Project management systems
  • Documentation platforms
  • Code repositories

​
Common Use Cases

​
Documentation Creation

  • Product Requirements Documents (PRDs)
  • Architecture Decision Records (ADRs)
  • Technical Specifications
  • API Documentation

​
Project Management

  • Breaking down features into tasks
  • Creating sprint plans
  • Estimating work efforts
  • Managing dependencies

​
Code Development

  • Setting up new features
  • Code review processes
  • Testing procedures
  • Deployment checklists

​
Benefits of Using Workflows

​
For Individual Developers

  • Less context switching between tools
  • Consistent access to relevant information
  • Guided assistance through complex tasks
  • Faster completion of routine work

​
For Teams

  • Standardized processes across projects
  • Easier onboarding for new team members
  • Captured institutional knowledge
  • Reduced manual coordination

​
For Organizations

  • Enforced best practices
  • Improved documentation quality
  • Faster project initialization
  • Consistent delivery standards

​
Getting Started with Workflows

  1. Identify Repetitive Tasks Look for processes you frequently repeat or guide others through

  2. Document Your Process Write down the steps, required information, and expected outputs

  3. Create Your Workflow Use Assembly’s workflow creator to formalize your process

  4. Share and Iterate Get your team using the workflow and gather feedback for improvements

​
Next Steps

Create Custom Workflows

Ready to create your first workflow? Learn how to build custom workflows for your team’s specific needs.

Codebase SearchCreating Custom Workflows