Before you begin
Have these ready:- Flowfield installed and running with
flowfield serve. - A supported coding agent installed and signed in.
- An existing Git repository with a README and a committed starting point.
Create a workspace
Choose New workspace, name it after your project, and select a harness and model for its agents. Choose Create workspace. You’ll see the Coordinator conversation beside the workspace views. The worker queue starts paused, giving you time to prepare the task.Add your project
Open Projects → Add project → Choose directory. Select your repository, review its name and ID, then choose Add project. Send this to the Coordinator, replacing the branch name if needed:Help me prepare this project for its first task. Read its existing instructions and scripts. Use main as the delivery branch, configure the setup and validation commands appropriate to this repository, agree on a run command or why no runnable preview applies, and validate the setup. Explain anything you need me to decide.The project should show successful setup validation before you start work. You can inspect the commands in Project settings. Project setup and checks explains those settings.
Shape the first task
Ask the Coordinator:Create a task to improve the README’s local-development instructions. A new contributor should be able to find the prerequisites, install dependencies, run the tests and start the application using the repository’s existing commands. Verify the instructions against the project scripts. Keep the change focused on the README and preserve useful existing content.Open the task on Task Board. Read its definition and success criteria beside the conversation. For this task, check that it calls for accurate prerequisites, working commands and a clear order of steps. Discuss any adjustments with the Coordinator or edit the task while it is in Backlog. You’re ready to proceed when you know how you’ll judge the result.
Run the task
Move the task to Up next on the board, then choose Run queue in the sidebar. Open the task to follow its activity as a Worker reads the project and makes the change. If the agent needs a decision, open Inbox → Needs me, read the question and send your answer. Work continues with that answer attached to the task. The Reviewer then checks the proposed README against the assignment and evidence. It can send the work back for corrections before presenting a result to you.Review the result
Open the result from Inbox. Read the report and reviewer findings, then inspect Code changes. Check the README as a new contributor would: are the prerequisites clear, are the commands correct, and can you follow them in order?
The test command is clear, but the setup instructions omit the environment file used by the application. Add the existing example-file step and explain which values a contributor needs to supply.When the result meets the criteria, choose Approve and integrate and confirm. Flowfield delivers the approved change to your local branch and marks the task Done.