docs(users): add Outcome Graph guide

[ig-shaun]

Summary

• add a non-technical task guide for reviewing a theory of change with Outcome Graph
• lead readers through the seven guided phases, including the visual canvas and one-action-at-a-time checkpoints
• explain causal relationship statuses, evidence admissibility, claim tiers, governed review, and authority boundaries
• include the diagnostic-chain and synthetic-evidence journey used during the skill test
• add the guide to the User Guides navigation

Files changed

• guides/users/outcome-graph.mdx
• docs.json

Canonical names normalized

• Outcome Graph
• IXO Graph

Routes or navigation updated

• add /guides/users/outcome-graph under Guides → User Guides
• no existing route changed, so no redirect is required

Links verified or removed

• verified all internal routes added by this guide exist
• verified the Outcome Graph source repository through the current upstream clone
• Mintlify broken-link checking reports no issue in the new guide; its 17 findings are in five untouched existing pages

Validation

• npm run qa:docs
• npm run lint:style
• targeted ESLint, markdownlint, and cspell for the new page
• IXO documentation style lint, including prescriptive mode
• valid docs.json
• local Mintlify preview returned HTTP 200 for /guides/users/outcome-graph and rendered the expected title, table of contents, and MDX components

Open questions or blocked items

• repository-wide strict spelling remains red on existing terminology and content
• repository-wide Mintlify link checking reports 17 existing broken links in five untouched pages
• no change-specific blocker remains

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
ixoworld	🟢 Ready	View Preview	Aug 20, 2026, 9:30 AM

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 99ba9ee87b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Add a usable way to access Outcome Graph

For a first-time user, “a supported agent session” is undefined, and a repo-wide search finds no other Outcome Graph setup page; the only executable instruction assumes the Claude Code plugin and /outcome-graph command are already installed. Consequently, readers entering through the newly public navigation cannot start this task guide. Add a verified access or installation prerequisite, or link to setup instructions, before this step.

AGENTS.md reference: AGENTS.md:L38-L45

Useful? React with 👍 / 👎.