Getting Started with WellForged

Welcome to WellForged

WellForged helps you build better software by guiding AI agents through structured research, specification, and test design phases.

How it works

  1. Open a project — Point WellForged at any directory on your machine. It works with git repos and plain directories alike.

  2. Create a flow — A flow is a unit of work: a feature, a refactor, an optimization. Choose the type and WellForged configures the right phases.

  3. Run the research phase — The AI agent explores your codebase, reads documentation, and builds context about the problem space.

  4. Review the spec — Research becomes a structured specification with clear requirements, edge cases, and design decisions.

  5. Generate test designs — From the spec, WellForged produces comprehensive test strategies covering happy paths, error cases, and integration points.

What makes WellForged different

  • Your code stays read-only — WellForged reads your codebase but never modifies it. All output goes to dedicated documents.
  • Versioned documents — Every spec and test design is versioned. You can review changes, leave comments, and track evolution.
  • Multi-phase workflows — Research, spec, and test design happen in distinct phases with clear handoffs between each.

Get started by downloading WellForged and opening your first project.