Guide

Dojo Use Guide

Dojo is a layered operating system for delivery. Use it as a flow, not as one big dashboard: intake enters through Inbox, gets cleaned in Sync Review, turns into reporting in Daily Status and Sprint Reports, and communication obligations live in Follow-ups.

How To Think About Dojo

  • Projects are the operating surface.
  • Tasks are the source of truth for work.
  • Status items carry reporting continuity forward across calls.
  • Team updates power sprint and daily reporting.
  • Inbox is raw intake.
  • Sync Review is where you reconcile, review, approve, or discard.
  • Follow-ups track threads that still need a reply or update.

Navigation Groups

  • Command groups Projects, All Tasks, Daily Status, and Sprint Reports.
  • Review groups Inbox and Sync Review.
  • Comms keeps Follow-ups separate from editorial review.
  • Automation isolates Diagnostics and integration health.
  • Signals groups Insights, Pulse, Scan, and Biz Dev.

Daily Loop

1. Sync Or ImportPull meeting or Slack/Jira automation updates into Dojo.
2. Review IntakeUse Inbox and Sync Review to clean raw updates.
3. Approve OutputApproved items feed Daily Status and Sprint Reports.
4. Follow ThroughUse Follow-ups for Slack obligations and Diagnostics for automation health.
Primary Views
Use the layers in order

Projects

Use project cards for a top-level read on health, next actions, risks, reporting hygiene, thread pressure, and Jira pressure. If the hygiene panel looks noisy, the project likely needs review work before the reporting output is trustworthy.

Open Projects ↗

All Tasks

Use this when you need to inspect canonical work directly. Tasks remain the truth layer for execution, ownership, due dates, and completion.

Open All Tasks ↗

Daily Status

Internal operational reporting. This view only shows approved items by default. If something appears to be missing, check Sync Review first.

InternalClient-safeNarrative
Open Daily Status ↗

Sprint Reports

Windowed reporting by project. Use Ops Mgr mode for temperature, problems, and upcoming milestones without too much task detail.

InternalClient-safeNarrativeOps Mgr
Open Sprint Reports ↗

Inbox

Raw intake from imports, Slack, and future connectors. Items disappear from the default Inbox view once they are handled through review, approval, merge, link, or discard.

Open Inbox ↗

Sync Review

The editorial control layer. Review items, compare likely matches, reconcile with current work, approve what should publish, and discard what should not survive. Pending Inbox signals can surface here too when they still need editorial handling.

Open Sync Review ↗

Follow-ups

The communication obligations queue, especially for Slack threads. Track reply drafts, waiting states, overdue obligations, and Jira handoffs.

Open Follow-ups ↗

Diagnostics

The observability layer. Use it for webhook health, sync events, Slack setup, Jira bridge contracts, sample payloads, and test flows.

Open Diagnostics ↗
Reporting Rules
What shows up where

Approval Matters

Daily Status and Sprint Reports use approved content by default. Imported items can exist in Dojo without appearing in reporting yet, and that is expected while they are still in draft or need review.

Reconciliation

When imported work overlaps with existing tasks or reporting items, use compare, merge, link, or keep separate. The main review states are now Needs decision, Distinct, and Reconciled. Exact duplicates can auto-merge when the copy and project pattern clearly match.

Carry-forward

Status items exist so unfinished work can roll from one internal call to the next. Resolve, hide, or link them instead of letting old wording accumulate forever.

Inbox Behavior

If an Inbox card remains visible, it usually still needs action. Handled items should fall out of the default view after review, approval, merge, link, or discard.

Slack And Jira Flow
Automation loop

Slack Intake

  • Slack message or thread triggers Make.
  • Claude analyzes the context against current Dojo state.
  • Dojo receives normalized Inbox items and optional thread follow-ups.

Follow-up Actions

  • Copy a reply draft.
  • Mark waiting on team.
  • Mark replied.
  • Resolve when the loop is closed.

Jira Bridge

  • Slack-derived issues can carry a Jira proposal.
  • Make creates or updates the issue in Jira.
  • Jira calls back into Dojo so the follow-up stores key, status, and assignee.

Where To Debug

Start in Diagnostics. It shows source events, payload examples, callback contracts, and a test checklist for Slack and Jira round trips.

In-App Reference Hub
Use these instead of repo-only docs

Automation Setup

Use Diagnostics for Slack intake payloads, Jira callback contracts, curl examples, sync events, and setup validation.

Open Diagnostics ↗

Reporting Workspace

Use Daily Status, Sprint Reports, Inbox, and Sync Review together when you need to trace how raw intake becomes approved reporting.

Open Reporting Views ↗

Settings And Data

Use Settings for theme selection, data review, import/export, integrations, and Dojo build tracking.

Open Settings ↗

Data Model Summary

Dojo’s main working layers are projects, tasks, status items, team updates, inbox items, sync events, and thread follow-ups. This page now summarizes the operational model directly in-app.

Private Repo Note

The repo remains the implementation source of truth, but the live app docs now point you to the actual pages you can use inside Dojo instead of private markdown files.

Common Troubleshooting
Fast answers

Something Is Missing From Reporting

Check whether it is still in Sync Review, still unapproved, or filtered out by the current output mode.

Inbox Feels Stuck

Make sure the related review item was actually handled. Approval, merge, link, and discard should all clear the corresponding Inbox signal from the default view.

Slack Thread Needs Attention

Use Follow-ups. That view exists precisely so thread obligations do not get buried inside Inbox or project notes.

Automation Looks Broken

Open Diagnostics and inspect the latest sync events, Slack setup panel, Jira callback contract, or sample curl requests.