Documentation menu

    Core concepts

    The mental model behind Aztra — how workspaces, projects, issues, goals, and XP fit together.

    Aztra has a small set of concepts that everything else builds on. Understanding how they relate makes the rest of the platform click.

    The hierarchy

    • Workspace — your team's home. Everything lives inside it: people, projects, goals, the wiki, and the leaderboard.
    • Project — a container for a body of work (a product, team, or initiative). Each project has its own views, labels, statuses, and issues.
    • Issue — the unit of work: a task, bug, or feature. Issues have a status, an assignee, and can be linked to goals.
    • Goal — an outcome you're driving toward. Link issues to a goal and progress rolls up automatically as they're completed.
    • Wiki — your team's knowledge base for docs, decisions, and context.
    • XP & leaderboard — completing real work earns XP and moves you up the seasonal leaderboard.

    The key relationship: issues are linked to goals, so finishing work updates goal progress without anyone reporting status by hand.

    How a piece of work flows

    It starts as an issue

    Created in a project, with a status and an assignee.

    It moves through your workflow

    For example Todo → In progress → In review → Done.

    It rolls up to a goal

    If linked, the goal's progress advances when the issue is completed.

    It earns XP

    Completed work contributes XP toward the leaderboard.

    People and access

    Everyone in a workspace has a role (Owner, Admin, Manager, or Member) that controls what they can see and change. See Roles & permissions for the full picture.

    Where to go next