Skip to main content

Documentation Index

Fetch the complete documentation index at: https://allhandsai-add-ai-enabled-sdlc-use-case.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

View SDLC Automations

Set up scheduled automations for vulnerability scans, code reviews, and more.
AI agents can transform every stage of your software development lifecycle—from gathering customer feedback to shipping secure releases. This guide shows you how to implement AI-powered automation across your entire SDLC using OpenHands.

The SDLC Stages

Feedback

Capture and triage customer feedback

Planning

Plan and prioritize work

Design

Architect and design solutions

Coding

Implement and review code

Testing

Test and validate

Release

Deploy and monitor
Each stage presents opportunities for AI automation. Below are detailed implementations for key jobs across the lifecycle.

Feedback Stage: Create Issues from Sales Feedback

The Challenge

Sales and customer success teams constantly receive valuable product feedback through Slack conversations. This feedback often gets lost or never makes it to the product backlog in a structured way. Pain Points:
  • Customer feedback is scattered across Slack channels
  • Manual issue creation is time-consuming and inconsistent
  • Important feature requests often get lost or delayed
  • Design team needs early visibility into UI/UX requirements

The Solution

Use OpenHands to automatically transform Slack conversations into actionable GitHub or Jira issues, with intelligent tagging for design requirements. Desired Outcome: Every piece of customer feedback is automatically converted into a well-structured issue with proper categorization, priority signals, and design-needed tags when UI changes are involved.

Implementation

1

Create a Slack Trigger

Set up an automation that listens for messages in #customer-feedback or messages with specific emoji reactions (e.g., 🎫)
2

Configure the Agent Prompt

Define how the agent should analyze feedback and determine if design involvement is needed
3

Connect to GitHub/Jira

Link your issue tracker and define the target project/repository
4

Set Auto-Tagging Rules

Configure rules for when to apply the design-needed label

Example Configuration

# Agent Canvas Configuration
trigger:
  type: slack
  channel: "#customer-feedback"
  reactions: ["🎫", "feature"]

agent:
  task: |
    Analyze customer feedback and create an issue:
    1. Extract the core feature request or bug
    2. Determine priority from urgency signals
    3. Check if UI/UX changes are mentioned:
       - New screens or pages
       - Visual changes
       - User workflow modifications
    4. Create issue with design-needed label if applicable
  
  output:
    type: github_issue
    repo: "myorg/product"
    labels: ["customer-feedback"]
    notify: slack_thread

Example Prompt

When I receive customer feedback in Slack:

1. Extract the core feature request or bug report
2. Determine priority based on urgency words (ASAP, blocking, critical)
3. Analyze if UI/UX changes are mentioned:
   - New screens or pages → add design-needed
   - Visual changes → add design-needed
   - User workflow modifications → add design-needed
4. Create a GitHub issue with:
   - Clear, actionable title
   - Structured description with customer context
   - Appropriate labels including design-needed if applicable
5. Reply in the Slack thread with the issue link

Planning Stage: Plan to Pull Request

The Challenge

When a new issue is created in your GitHub repository, it typically requires a technical implementation plan before coding begins. This planning phase can be automated to accelerate development while maintaining quality. Pain Points:
  • Technical planning is often a bottleneck in the development process
  • Junior developers may struggle with implementation approach
  • Consistent technical plans improve code review efficiency
  • Automated implementation can handle routine tasks

The Solution

Automatically generate technical implementation plans from new issues, then transform approved plans into working pull requests. Desired Outcome: New issues automatically receive a technical implementation plan as a comment, and for approved plans, a draft PR with working code is created for review.

Implementation

1

Set Up Issue Trigger

Create an automation that triggers when issues are labeled ready-for-planning
2

Configure Planning Agent

Agent analyzes the issue, explores the codebase, and proposes an implementation plan
3

Add Approval Gate

Wait for a maintainer to approve the plan by adding plan-approved label
4

Implementation Agent

A second agent implements the approved plan and opens a draft PR

Example GitHub Workflow

# .github/workflows/plan-to-pr.yml
name: Plan to PR Pipeline
on:
  issues:
    types: [labeled]

jobs:
  generate-plan:
    if: github.event.label.name == 'ready-for-planning'
    runs-on: ubuntu-latest
    steps:
      - uses: openhands/agent-action@v1
        with:
          task: |
            Analyze issue #${{ github.event.issue.number }}
            and create a technical implementation plan
          output: issue-comment

  implement:
    if: github.event.label.name == 'plan-approved'
    runs-on: ubuntu-latest
    steps:
      - uses: openhands/agent-action@v1
        with:
          task: |
            Implement the approved plan for
            issue #${{ github.event.issue.number }}
          output: pull-request
          draft: true

Design Stage: Auto-Generate Design Docs

The Challenge

When an issue requires design work, someone needs to create a technical design document outlining the approach. This often becomes a bottleneck as architects are pulled in multiple directions. Pain Points:
  • Design documents ensure alignment before coding begins
  • Writing design docs is time-consuming
  • Inconsistent documentation formats across teams
  • Important architectural decisions need to be recorded

The Solution

When issues are tagged with design-needed, automatically generate a draft design document with architecture recommendations, trade-offs, and open questions. Desired Outcome: Issues tagged with design-needed automatically receive a draft design document PR with architecture recommendations, trade-offs, and open questions for the team to review.

Implementation

1

Trigger on Label

Set up automation when design-needed label is added to an issue
2

Codebase Analysis

Agent explores the repository to understand existing architecture
3

Generate RFC Document

Create a design doc following your team’s RFC template
4

Create PR with Doc

Open a PR adding the design doc to /docs/rfcs/ folder

Design Document Template

# RFC: [Feature Name]

## Summary
Brief description of the proposed change.

## Motivation
Why are we doing this? What problem does it solve?

## Detailed Design

### Architecture Overview
[Diagram and explanation]

### API Changes
[New endpoints or interface changes]

### Data Model
[Database schema changes]

## Alternatives Considered
What other approaches were evaluated?

## Trade-offs
What are we giving up with this approach?

## Open Questions
- Question 1 that needs team input
- Question 2 about edge cases

## Implementation Plan
1. Phase 1: ...
2. Phase 2: ...

Coding Stage: Automated PR Review

The Challenge

Code reviews are essential for maintaining code quality, but they can be a bottleneck when senior developers are overloaded. An AI-powered first pass can catch common issues and speed up the review process. Pain Points:
  • Human reviewers spend time on mechanical checks
  • Inconsistent review quality across the team
  • Security and performance issues sometimes slip through
  • Long review queues slow down deployment velocity

The Solution

Run intelligent code reviews on every PR, checking for bugs, security issues, performance concerns, and code style. Desired Outcome: Every PR receives an immediate automated review with inline comments for bugs, security concerns, and code style issues—allowing human reviewers to focus on architecture and business logic.

Implementation

1

Set Up PR Trigger

Configure automation on pull_request opened and synchronize events
2

Define Review Criteria

Specify what the agent should check: bugs, security, performance, style
3

Configure Comment Style

Set severity levels and how comments should be formatted
4

Enable Suggestions

Allow the agent to propose code changes as GitHub suggestions

Review Checklist

review_criteria:
  security:
    - SQL injection vulnerabilities
    - XSS attack vectors
    - Hardcoded secrets or credentials
    - Insecure dependencies

  performance:
    - N+1 query patterns
    - Missing database indexes
    - Unnecessary re-renders
    - Memory leaks

  code_quality:
    - Dead code or unused imports
    - Missing error handling
    - Inconsistent naming conventions
    - Missing or incorrect types

  best_practices:
    - Test coverage for new code
    - Documentation for public APIs
    - Breaking change detection

Automated Code Review

See our dedicated guide for setting up comprehensive automated code reviews.

Testing Stage: Vulnerability Remediation

The Challenge

Software dependencies frequently have security vulnerabilities discovered and published as CVEs. Keeping dependencies updated is critical for security but often falls behind due to other priorities. Pain Points:
  • New CVEs are discovered daily in common dependencies
  • Manual dependency updates are tedious and error-prone
  • Security compliance requires timely remediation
  • Version upgrades can introduce breaking changes

The Solution

Weekly automated scans detect vulnerabilities and generate PRs with dependency updates, including compatibility testing and migration guides for breaking changes. Desired Outcome: Weekly automated scans detect vulnerabilities and generate PRs with dependency updates, including compatibility testing and migration guides for breaking changes.

Implementation

1

Schedule Weekly Scan

Create a scheduled automation that runs every Monday at 9 AM
2

Configure Scanning Tool

Set up integration with npm audit, Snyk, or GitHub Dependabot alerts
3

Define Fix Strategy

Specify how the agent should approach fixes: patch only, minor versions, or major with migration
4

Test & PR Creation

Agent runs tests, documents changes, and creates a PR for review

Example Scheduled Automation

# Weekly Vulnerability Scan
schedule:
  cron: "0 9 * * 1"  # Every Monday 9 AM

agent:
  name: security-scanner
  task: |
    1. Run npm audit / pip-audit / cargo audit
    2. Parse CVE results and severity levels
    3. For each HIGH/CRITICAL vulnerability:
       - Research fix version
       - Update dependency
       - Run test suite
       - Document breaking changes
    4. Create PR with:
       - Summary of fixed CVEs
       - Risk assessment
       - Test results
       - Migration notes if needed
    5. Notify #security-alerts channel

Vulnerability Remediation Guide

See our comprehensive guide for automated vulnerability scanning and remediation.

Release Stage: Generate Release Notes

The Challenge

When preparing a release, someone needs to compile all the changes since the last release into a coherent changelog. This involves reviewing merged PRs, categorizing changes, and writing user-friendly descriptions. Pain Points:
  • Release notes are essential for users to understand what’s changed
  • Manually compiling changes is tedious and error-prone
  • Breaking changes need clear migration guidance
  • Consistent formatting improves readability

The Solution

When a new version tag is pushed, release notes are automatically generated from merged PRs, categorized by type, with highlighted breaking changes and migration instructions. Desired Outcome: When a version tag is pushed, release notes are automatically generated from merged PRs, categorized by type, with highlighted breaking changes and migration instructions.

Implementation

1

Trigger on Tag Push

Set up automation to trigger when a version tag (v*) is pushed
2

Analyze Git History

Agent reviews all commits and PRs since the previous tag
3

Categorize Changes

Group into: Breaking, Features, Fixes, Performance, Documentation
4

Create GitHub Release

Publish formatted release notes to GitHub Releases

Example Release Notes Output

# v2.5.0 Release Notes

## ⚠️ Breaking Changes
- **API:** Renamed `/users/list` to `/users` (#234)
  Migration: Update all API calls to use new endpoint

## ✨ Features
- Add dark mode support (#256)
- Implement webhook notifications (#248)
- New dashboard analytics view (#241)

## 🐛 Bug Fixes
- Fix memory leak in WebSocket handler (#253)
- Resolve timezone display issues (#249)
- Fix pagination on mobile devices (#245)

## ⚡ Performance
- Optimize database queries, 40% faster (#251)
- Lazy load images on scroll (#247)

## 📚 Documentation
- Updated API reference (#255)
- Added deployment guide (#250)

Full Changelog: v2.4.0...v2.5.0

Automate Your SDLC

You can implement any of these workflows using OpenHands Automations. Copy these prompts into a new conversation to get started:
Create an automation that monitors #customer-feedback in Slack.

When a message gets the 🎫 reaction:
1. Extract the feature request or bug report
2. Determine if UI/UX changes are needed
3. Create a GitHub issue with appropriate labels
4. Reply in the thread with the issue link

Add the design-needed label if the feedback mentions:
- New screens or UI components
- Visual or layout changes
- User workflow modifications

Automations Overview

Learn how to set up scheduled and event-triggered automations

Code Review

Detailed guide for automated PR reviews

Vulnerability Remediation

Comprehensive security scanning and fixing

Prompting Best Practices

Write effective prompts for better results