Forge¶

Forge automates the software development lifecycle from feature ideation through code delivery using AI-powered planning and execution. It connects Jira, GitHub, and Claude to transform tickets into shipped code with human approval gates at each stage.

How It Works¶

graph TD
    A[Create Feature] --> B[Generate PRD]
    B -->|Approval| C[Generate Spec]
    C -->|Approval| D[Decompose Epics]
    D -->|Approval| E[Generate Tasks]
    E -->|Approval| F[Implement Code]
    F --> G[Local Review]
    G --> H[Create PR]
    H --> I[CI/CD + Fix]
    I --> J[AI Review]
    J --> K[Human Review]

Quick Links¶

• Getting Started — Set up Forge in 10 minutes
• Feature Workflow — How features flow through Forge
• Developer Guide — Full local development reference
• Skills System — Customize Forge for your stack
• Contributing — How to contribute

Key Features¶

AI-Powered Planning : PRD, spec, and task generation at each stage with human approval gates before moving forward.

Q&A Mode : Ask clarifying questions at any approval gate without triggering regeneration. Start a comment with ? or @forge ask.

Automated Implementation : Code executed in ephemeral Podman containers with no external network access.

CI Fix Loop : Automatic CI failure analysis and fixing, up to 5 retries. Skip infrastructure-related failures with /forge skip-gate.

Skills System : Customizable per-project AI behavior. Override only what's specific to your stack; defaults cover the rest.

Resumable Workflows : LangGraph checkpoints state to Redis after every step. Use forge:retry to resume from the exact node that failed.