A map for unsolved matters

matters.global

Mapping matters and their dependencies, so we can use creativity to solve problems and see what can be unblocked next.

Why

Creativity helps us solve problems. First, we need to see the problem clearly.

Sonophilia works to make creativity accessible beyond the arts: as a human capacity for solving problems in business, science, society, and everyday life. But problems are rarely isolated. One matter blocks another. A missing decision holds back a project. An unnamed risk prevents people from moving.

matters.global turns that complexity into a map. Each matter has clear conditions for when it counts as resolved, so people can see where creative problem-solving can unlock progress.

How

From a messy situation to a useful map.

Name the matter

Capture the thing that matters enough to revisit: a goal, concern, risk, decision, or question.

Define resolution

Write down the observable conditions that would make it count as resolved.

Connect dependencies

Show which matters must resolve before other matters can resolve.

Find the next move

See the actionable matters whose blockers are already cleared.

Quick Start

Install the system, start your agent, and describe what matters.

matters.global is most useful through an AI agent. The command line stores and computes the graph; Codex or Claude helps you name matters, define conditions, discover dependencies, and decide what to work on next.

Install matters.global

python3 -m pip install git+https://github.com/matthiasroder/matters.global.git

Start your agent

cd your-workspace
codex

# or open Claude Code in the same workspace

Use the system

Help me turn this into matters:
publish the first walkthrough,
invite outside collaborators,
and keep private context private.

Ask for the next move

Look at my matters graph and tell me what is actionable now.

Extract from notes

Extract candidate matters, conditions, and dependencies from these notes. Ask before saving.

Start messy. Tell the agent what you are trying to understand or move forward. It will propose matters, conditions, and dependencies, then ask before adding them to your map.

Public

Some matters are private. Some should be shared.

The project starts with a careful distinction: private state remains private, while selected public matters can be exported into a shared view. That makes it possible to coordinate around public problems without exposing personal or sensitive context.

Publish first public walkthrough

Invite outside collaborators to try it

Explain the core concepts with examples