Quickstart
Quickstart in 5 minutes
This page is the shortest path to start the platform locally, log in, create a project and walk through your first run with the mock adapter.
1. Prerequisites
- Docker and Docker Compose
- a free port for the web application
- a
.env with bootstrap admin
SOFTWAREFABRIK_ADMIN_USER=admin
SOFTWAREFABRIK_ADMIN_PASSWORD=ChangeMe-2026!
2. Start locally
docker compose up
Then open the platform in your browser. Log in with the bootstrap admin.
3. Create your first project
- click Create new project
- enter project title and product name
- add target picture, technology and free text in the editor
- save
4. Generate markdown artifacts
- open the project
- click Generate markdown artifacts
- quickly review
PROJECT.md and INSTRUCTIONS.md
Tip: If these files are vague, the subsequent run will usually be vague as well.
5. Start your first run with the mock adapter
- click Create run
- pick the project
- formulate a clear, small goal
- set run to
READY - start the run
- approve if necessary
6. Observe while the run is in progress
- Run detail for status and phases
- Logs for agent and build output
- Git view for commits and working tree
You should see that the platform is not just starting the agent but also making traceability and quality gates visible.
7. Afterwards
- sharpen artifacts
- create a follow-up run
- only then switch to the real Claude Code adapter
Recommendation: Learn with the mock first, then work with the real agent.
If something does not work
- check logs
- check the Git view
- sharpen the run goal
- refine
INSTRUCTIONS.md - start a follow-up run