Project Overview

Agentic Software Factory

The Agentic Software Factory is a local development and orchestration platform that drives Claude Code in the backend and combines project definition, artifact generation, run orchestration, Git transparency and validation in a single user interface.

1
local control plane
6+
markdown artifacts
7
run phases
7
agent roles

What it is essentially about

The platform makes working with Claude Code more structured, more reproducible and easier to operate than plain shell usage.

  • capture project ideas in a structured way
  • generate markdown artifacts automatically
  • manage agent roles and teams
  • start, monitor and continue runs
  • make Git, build and log status visible

Which problem does it solve?

Using the CLI directly is powerful but often unstructured. Typical problems are too few commits, unclear project definitions, repeated approvals without context and a lack of traceability.

  • more process discipline
  • less prompt tinkering
  • more reusability
  • better visibility for runs and decisions

What the project contains

Project Definition

Managing project title, target picture, constraints, technology preferences and DoD.

Agent Definition

Managing agent roles, default instructions, tool profiles and limits.

Team Assembly

Composing agent teams for different project types and run flavours.

Prompt Assembly

Generating PROJECT.md, INSTRUCTIONS.md and additional artifacts.

Run Orchestration

Starting, monitoring, pausing and completing development runs.

Git & Build Integration

Showing commits, working tree, build results and logs directly in the UI.

How the user works with the platform

1. Capture the ideaStructured fields plus free text.
2. Generate artifactsProduce markdown files like PROJECT.md.
3. Prepare the workspaceCreate directory, repository and run context.
4. Start the runLaunch Claude Code as the dev agent in the backend.
5. Monitor the runRead phases, logs, commits and builds.
6. InterveneApprove, correct, stop or start a follow-up run.

Technical foundation of version 1

Java 21Spring BootThymeleafHTMXPostgreSQLSpring SecurityDocker ComposeJUnit 5

Angular is deliberately not required for version 1. The focus is on workflow, orchestration, traceability and reusability.

What version 1 deliberately does not yet have to deliver

  • true parallel multi-agent execution
  • a graphical workflow designer
  • cloud scaling
  • multi-tenancy
  • a full CI/CD platform

Recommended domain model

ProjectDefinitionInstructionSetDefinitionOfDoneAgentDefinitionAgentTeamRunRunPhaseTaskExecutionStepExecutionLogApprovalPolicyApprovalDecisionGitRepositoryGitCheckpointBuildResultArtifactPromptArtifact

Key UX design decision

The user should not have to write markdown files manually first.

Idea → structured UI capture → auto-generated markdown artifacts → editable preview → run
Why this matters: This is precisely what makes the platform simpler and more productive than using Claude Code directly in the shell.

Documentation, quality and operations

Agentic Software Factory · Project Overview · aligned with Introduction, Architecture Overview and Quickstart