LogoLogo
  • About Acorn
    • What is Acorn?
    • The Ontology of Acorn
    • Who is Acorn for
    • Best Practices
    • Updating the App
  • Projects
    • Project Members
    • Projects Dashboard
    • Create a Project
    • Join a Project
    • Import a Project
    • Invite Members to a Project
    • Export a Project
    • Delete or Leave a Project
  • Project Views
    • Map View
      • Creating Outcomes
      • Removing Outcomes
      • Outcome Connections
      • Canvas Navigation in Map View
      • Tree Navigation by Keyboard
      • Map Viewing Options
    • Table View
    • High Priority View
    • Expanded View
  • Outcomes
    • Outcome Scope
    • Outcome Statement
    • Achievement Status
    • Progress Indicator
    • ID Number
    • Assignees
    • Tags
    • GitHub Link
    • Time
    • Description
    • High Priority Outcomes
    • Entry Point Outcomes
    • Comments
    • Tasklist
    • Children List
    • Ancestors Breadcrumbs
  • 🐛Troubleshooting
    • Clearing Application Data
  • Data in Acorn
    • Your Project Data
Powered by GitBook

© 2020-2024 Harris-Braun Enterprises, LLC, operating as Lightningrod Labs. Licensed under the Cryptographic Autonomy License v1.

On this page
  • Getting started with your project in Acorn
  • Starting with the highest level intended Outcomes
  • Breaking down the Outcomes
  • Creating a Dependency Tree of Outcomes
  • Modifying the Dependency Tree
  • Your team's day-to-day workflow
  • Picking and ranking project priorities
  • Achieving Small Scope Outcomes
  • Connecting Outcomes with Your GitHub Repository
  1. About Acorn

Best Practices

Learn tips on how to manage your project in Acorn.

Last updated 2 years ago

This page is under development.

Getting started with your project in Acorn

Starting with the highest level intended Outcomes

Acorn focuses on desired and intended instead of goals. What it means for you and your team is that when you start a project in Acorn you would want to start with writing down the highest level Outcome or Outcomes for your project in declarative sentence (we call this an ). For example, one of the highest level Outcomes that we want to achieve for the Acorn software project would be:

Software dev teams have a seamless and frictionless experience doing project management using Acorn.

Breaking down the Outcomes

So you would need to break down your highest level Outcome(s) into smaller scoped Outcomes. You would need to ask yourself:

  • What Outcomes do we need to achieve first to consider the highest level Outcome achieved?

  • What's our Hypothesis for breaking down the Outcome in a specific way?

Creating a Dependency Tree of Outcomes

Modifying the Dependency Tree

Your team's day-to-day workflow

Now that you've broken down your tree in Map View and it has grown large enough with some Small Scoped Outcomes available, you may begin to think about where to start. Here are some tips:

Picking and ranking project priorities

If an Outcome marked as High Priority is:

  • Uncertain Scope with Children

  • Uncertain Scope without Children

  • Small Scope:

Achieving Small Scope Outcomes

In the future we are intending to have the 'Only show my cards' filter for the Table View as well.

Going through the Tasklist

If you achieve all the Small Scope Outcomes that are Children and/ore Descendants of a Big Scope Outcome, then the Parent Outcome automatically becomes Achieved.

Connecting Outcomes with Your GitHub Repository

Acorn is designed with project management for distributed software teams in mind. There is a GitHub Issue or Pull Request link option that you can add to any Outcome. This will help you and your team cross reference between your GitHub repo and your Acorn space.

Translating a GitHub Issue to an Outcome

What could be very useful for project management of a software product is translating GitHub issues into Outcomes in Acorn. This will help you make a cohesive understanding of where the external feedback belongs in the bigger picture of your project's Dependency Tree.

For example, we received the issue below on GitHub:

Then we look into whether this Outcome speaks to a bigger Outcome we want to achieve for our project. For example, this Outcome helps us with achieving a bigger scoped Outcome:

App functions normally and without interruption in terms of connectivity.

At first any intended Outcome is Uncertain in : It's not clear how long it is going to take, how it could be achieved, or who should work on it for it to get achieved.

You will then need to add to the Outcome you are breaking down. That's where the dependency relationship between Outcomes comes into play, modelled as a of Outcomes in Acorn (visible in ).

This Breakdown process might take you or your team some time. This allocation of time and focus is accounted for in Acorn. When you are in the process of breaking down an Uncertain scope Outcome mark it as In Breakdown mode. You can also give it a for how long it could take you to break down that Outcome into Small Scoped Outcomes (shown as the Children and/or of that Outcome). You can also define who is doing this Breakdown by them to that Outcome.

Keep breaking down each Outcome till you can confirm the lowest in each branch is clear in Scope and can be achieved within a short amount of time (right now this is automatically set as 1 day in Acorn). These Outcomes are , and you can mark them as such by opening the of that Outcome and switching the Scope to Small.

Acorn is meant to be an agile project management methodology. It means that as you progress through developing your project, your Dependency Tree would evolve or change. Acorn is designed to accommodate these iterations. For example, at some point you might realize you have a different highest level Outcome for your project, and you can modify your Dependency Tree of Outcomes accordingly. .

The team member or members in project management hat would mark certain Outcomes in the Dependency Tree as .

Then they have to sort between those High Priority Outcomes in to rank them.

It needs to be broken down until all of its lowest level are Small in Scope.

The priority for it is that Outcome.

Make sure there is relevant team member (or members) to breaking down the Outcome.

It needs to be to related team member or members

Have a created for it.

You can also add a .

The team members in 'doer' hat (those who execute to achieve Small Scope Outcomes) will be able to access the Outcomes assigned to them via the and using the filter 'Only show my cards'.

They can also view the High Priority Outcomes in and see which ones they are assigned to.

If the Small Outcome already has added to it by the members in Project Management hat then the Assignee can go through those tasks and check them off as they complete each task. The Assignee also can create a Tasklist for themselves to help them break down the steps to Acheive that Small Scope Outcome.

Checking off each task in the Tasklist updates the for that Outcome. When all of the tasks are checked off the Outcome automatically turns into Achieved Status. If for any reason it is determined that the Outcome is not achieved yet, you can manually switch the back to Not Achieved.

Then, we translate it into an intended or desired Outcome and to it:

So we make the recently created Outcome a of the bigger scope Outcome:

Learn how to add or change the connections between Outcomes
High Priority
Priority View
Descendants
assigned
assigned
Tasklist
Table View
Priority View
Tasklist
Progress Indicator
Achievement Status
link the GitHub Issue
Child
breaking down
Outcome Statement
Children Outcomes
Map View
Descendants
assigning
Child Outcome
Expanded View
Breakdown Time Estimate
Target Date
An example of the Tasklist for a Small Scope Outcome, viewed in Expanded View
An example of an Issue on a the GitHub repo for the project
An example of a GitHub Issue translated into an Outcome on Acorn
An example of the newly created Outcome becoming a Child of a bigger scope Outcome
An example of a highest level Intended Outcome, viewed in Expanded View
Breaking down the Outcomes in the Dependency Tree to reach to the level of . If an Outcome only has Small and/or Big Scope Children it automatically shifts from Uncertain to Big in Scope.
An example of a Dependency Tree of a project seen in . The Outcome on the top is the highest level Outcome.
An example of a , viewed in Expanded View
Map View
Outcomes
Scope
Dependency Tree
Small in Scope
Small Scope Outcomes
Small Scope Outcome