Esc

↑↓ move↵ openIndex · Pagefind

Create a project task and leave a useful progress update

Write a clear task in os.construction, check its saved detail page, change its status, and add a comment that explains the next check.

Charley Forey5 min readTasksProject coordinationWorkflows
On this page
  1. Start with an action and an expected result
  2. Save and inspect the task detail
  3. Change the status when the stage changes
  4. Add the context behind the status
  5. Check the result before moving on
  6. Video transcript
  7. Start a project task
  8. Name the follow-up clearly
  9. Describe what the follow-up needs
  10. Save the task and inspect its detail page
  11. Move the sample task into progress
  12. Write a useful progress comment
  13. Save the update
  14. Review the saved progress context
  15. Try a clear follow-up in your own workflow

A useful task names the follow-up, the expected result, and the next check. Its status gives a quick signal; a progress comment explains the context.

This walkthrough creates a sample delivery-window task, moves it from Initiated to In Progress, and saves an update in one local sample project.

Recorded in a local instance of the actual os.construction app using the seeded Sandbox Test Project. The task and progress update are invented sample data. No assignees or distribution members are selected in this example.

Task progress record: action, status, and next check Three connected cards show the verified sample: create a task called Confirm delivery window with an expected result, mark its status In Progress, then save a comment that the window still needs confirmation and the logistics coordinator is the next check. A status change does not confirm a real delivery window. 1 · DEFINE Confirm delivery window Result: agreed time and access instructions 2 · MARK STAGE In Progress The task is underway; the window is unconfirmed. 3 · LEAVE CONTEXT Save a progress comment Next check: logistics coordinator before drop Actual local app · invented sample follow-up · verified task and comment
The three parts of this sample record serve different purposes: the description defines the result, the status tracks its stage, and the saved comment explains the next check.

Watch this walkthrough on YouTube.

Start with an action and an expected result

Open Create Task in your project’s Tasks tool. Confirm the project before entering the follow-up.

Use a title that names the action. The example uses Confirm delivery window, with a unique demo reference to distinguish repeated recordings.

Use Description to explain what a useful result would contain. The sample says:

Confirm the planned delivery window with the logistics coordinator. Record the agreed time and access instructions here before marking the task ready for review.

Adapt the description to your actual follow-up and the information its reviewer will need.

Field What it should help the reader understand Sample content
Title The action that needs attention Confirm delivery window
Description What the expected result should contain Agreed time and access instructions
Status The current stage of the follow-up In Progress
Comment The next check or new information Check with the logistics coordinator

Review the other fields before saving. The example keeps the supplied number and due date, Private selected, and assignees and distribution empty. Choose people, dates, and visibility for your team’s process. Assignment and notices are outside this recording.

Create Task form with the sample title and a description requesting delivery window, time, and access information.
The description explains what a useful result should contain. Open the image to inspect the form at full size.

Save and inspect the task detail

Select Create and wait for the task detail page. Check its title and saved Description.

Check the task number and current status. The example begins in Initiated, with the follow-up and expected result together on one record.

The saved sample task detail page showing the title, description and Initiated status.
Step 4Save the task and inspect its detail page · sample data, no sound

Change the status when the stage changes

Select In Progress for the sample task. After the update, confirm In Progress in the task’s current status badge.

The sample task after selecting In Progress, with In Progress shown as its status.
Step 5Move the sample task into progress · sample data, no sound

Read the current status badge to confirm the change. The button offers an action. In Progress records the task’s stage; the delivery time still needs confirmation.

Saved sample task showing In Progress as its current status after the update.
  1. In Progress in the header badge is the current status.
  2. The status buttons. In Progress is no longer offered; Ready For Review is highlighted as the usual next step.
  3. Status in Details shows the same current status.
Confirm the new current status on the saved task after selecting the action. Markers added for this guide (sample data).

Add the context behind the status

In the comment field, give the next reader useful context. The invented update says:

Delivery window needs confirmation. Next check: logistics coordinator before the planned drop.

Select Add Comment, wait for the saved text, and read it again. Separate what is known from what still needs checking.

The sample progress comment saved in the task Comments list.
Step 7Save the update · sample data, no sound
The sample delivery-window update saved in the task's Comments section.
  1. Comments (1): the count goes up once the comment is saved.
  2. The saved update, with its Demo reference. Read it back to confirm it says what you intended.
  3. The status is unchanged. A comment adds context; it does not move the task.
The saved comment explains the next check alongside the task's progress state. Markers added for this guide (sample data).

Check the result before moving on

  • The task names one specific follow-up.
  • Its description explains what a useful result should contain.
  • Its current status matches the stage you intended to record.
  • The comment appears in the saved list and explains the next check.

This walkthrough stops with the task In Progress. Keep the record current as your team works through the follow-up and decides when it is ready for review or closure.

Task statuses and where this walkthrough stops A task moves from Initiated to In Progress to Ready For Review to Closed. Void cancels a task. This walkthrough covers Initiated and In Progress and adds a comment; adding a comment does not change the status. InitiatedCREATEDIn this walkthrough In ProgressBEING WORKEDIn this walkthrough Ready For ReviewDONE, TO BE CHECKED ClosedDONE AND CHECKED ADD COMMENT: ADDS CONTEXT, STATUS UNCHANGEDVOID: CANCELS THE TASK
Status names as they appear in the app. Who can set each status depends on permissions; see the Tasks docs.

Video transcript

Start a project task

Open Create Task in the sample project. A useful task names a specific follow-up and gives the next reader enough context to understand what needs to happen. We will save this example, change its status, and add an update.

Name the follow-up clearly

Give the task an action-oriented title. Confirm delivery window tells the reader what needs attention. The unique demo reference distinguishes this sample record from other recordings.

Describe what the follow-up needs

Use Description to explain the expected result. Our invented example asks for the delivery window, the agreed time, and access instructions. Review the task’s other fields before saving. This recording leaves assignees and distribution empty.

Save the task and inspect its detail page

Select Create and wait for the task detail page. Confirm the title and description. The saved record now has a task number and a current status that the project team can use to track the follow-up.

Move the sample task into progress

For this sample, select In Progress. Check the current status in the task header after the update. A status change records the stage of the task; the delivery window itself still needs confirmation.

Write a useful progress comment

Add a comment that explains the next check. Our sample update says that the delivery window needs confirmation and identifies who to check with. This gives the reader more context than the status alone.

Save the update

Select Add Comment. Wait for the text to appear in the saved comment list. Read the saved update so you can confirm the task contains the information you intended to leave.

Review the saved progress context

Here is the saved update on the task. We have created a specific follow-up, moved its status into progress, and recorded the next check. Keep updating the record as the work changes so another reader can understand what remains.

Try a clear follow-up in your own workflow

Create an os.construction account or open the app. Start with one specific follow-up, save it, and inspect the result.

Explore the platform on os.construction, watch Construction-OS walkthroughs on YouTube, or follow os.construction on LinkedIn. For a question about your team’s coordination process, email Charley.

Your next step

Try it on the sample project.

Create an account, open the sample project and run this workflow yourself with sample data.

Try it in the app

Share this article

Written by

Charley Forey

Founder of os.construction. We're building the operating system for construction. Project Financials follows job money, and company Accounting covers the books and controls. AI agents remain planned. We write about how money and data actually move on a job, and we build in public.

Apply to the founding program →Start a free trial →
Open file