User Guide

How to use Compass

A step-by-step walkthrough of the full workflow — from first thought to refined insight.

1 — What Compass Does

Compass transforms messy thoughts into something measurable.

Most thinking tools ask you to organize what you already understand. Compass does the opposite — it takes an idea you can't fully articulate yet and finds the structure hiding inside it.

Every system — a business, a disease, a relationship, an economy — is made of things that constrain each other across scale. Compass maps those constraints, scores them, and tells you what zone your system is operating in. That's not philosophy — it's measurement.

[The Core Insight]
The framework doesn't care what domain you're in. A tumor, a supply chain, and a social movement can all be described using the same relational grammar. Once you see that, you can compare them — and borrow solutions.
2 — Starting a Project

A project is a focused investigation of a single system or question. Think of it like a lab notebook — not a chat, not a conversation, but a structured inquiry with a beginning, a thesis, and a set of findings.

1
Open Hierarchics AI
Go to Hierarchics AI from the navigation. You'll see the Compass interface — a single input, ready for your first message.
2
Describe your System — Naturally

Don't try to be precise yet. Just describe what you're thinking about. Examples:

"Why does our team always seem to move fast at first and then stall?"
"I want to understand how a tumor hijacks the body's coordination signals."
"What makes some open-source projects thrive and others collapse?"

Compass listens for the relational grammar underneath your words — not the topic, but how the parts constrain each other.

3
Let Clarity Guide You

Compass will ask probing questions and refine your model across a few exchanges. After 2–5 turns it will generate an analysis — a structured map of your system with scored relationships, zone classification, and real-world anchors.

You can keep talking after the analysis is generated. The analysis is a hypothesis — not the end of the conversation.

3 — Compass Mode
Clarity — Default

Compass acts as a guide. It translates your natural language into the framework, asks grounding questions, uses metaphor as a structural tool, and generates human-readable zone explanations. Best for exploring new ideas.

Chaos — Advanced

Compass becomes a peer-level co-architect. It speaks formally — Observer Position, Validity Gate, link derivation, measurement roadmaps. Best for researchers or engineers formalizing a model they already understand.

[Tip]
You can switch modes mid-project using the toggle in the input bar. The mode affects the style of the next message — all prior context is preserved.
4 — Saving a Project

When you've made meaningful progress, save your work using the Save Project button in the top bar of Hierarchics AI. Give the project a short, descriptive name.

1
Save as Draft
Saves the full conversation history and all analyses to your Library. Fast and complete. Use this when you want to return to the conversation later exactly as it is.
2
Synthesize with Librarian

Before saving, ask the Librarian to synthesize your project. The Librarian reads the full conversation and produces a structured Markdown document — a re-entry card containing:

  • ›Observer Position declared in the session
  • ›Key structural findings
  • ›Open questions and unresolved tensions
  • ›Diagnostic metrics (zone, β values, CC_avg)
  • ›A suggested re-entry prompt for the next project

You can also download the synthesis as a .md file.

5 — The Recursive Cycle

Compass is designed to be used in cycles. Each project informs the next. The synthesis document is not a final report — it's a seed for the next project.

The Refinement Loop
Step 1 — Make a Project
Describe your system. Let Clarity extract the relational grammar. Generate an analysis.
when you've reached the edge of what you can articulate
Step 2 — Synthesize
Ask the Librarian to distill the project into a re-entry card. Download or copy the synthesis.
synthesis becomes the starting point
Step 3 — Refine in a New Project
Open a new project. Paste the synthesis as your first message, or use the Librarian's suggested re-entry prompt. Now you're working at a deeper level of precision.
repeat — each cycle narrows the zone, sharpens the variables
messy thought → measurable model → testable hypothesis → refined model → ...
[Why Projects, Not Chats]
Language models are usually used for quick answers. Compass is for building something. Each project is a unit of structured inquiry — it has a domain, an observer position, and a set of findings. Treating it like a project trains you to think in terms of what you're trying to measure, not just what you're curious about.
6 — Hierarchics AI as a Reasoning Injection

Hierarchics AI isn't another chatbot. It's a reasoning injection you can drop into any AI you already use.

Each session gives you a structured, hierarchical breakdown of your system — scored relationships, zone classification, and a precise Observer Position. Paste that output into ChatGPT, Claude, Gemini, or any other model, and it becomes noticeably sharper on that topic. Not because you gave it more information, but because you gave it better structure.

It's not about replacing your current AI — it's about making it think better when it matters.

01
Run a session

Describe your system in Compass. Let it extract the relational grammar and generate an analysis.

02
Synthesize it

Ask the Librarian to produce a structured re-entry card — a compact, high-density summary of your system.

03
Inject into any AI

Paste the synthesis into any other model as context. It now has a precise structural map to reason from.

[Why This Works]
Most AI models are good at reasoning — but they need a clear structure to reason about. The Hierarchics framework gives them that: a domain declaration, scored causal links, a zone classification, and open questions. That's not context — that's a thinking scaffold.
7 — Best Synthesis Practice

Synthesis is most valuable when the conversation is coherent, focused, and structurally rich. The Compressibility (CMPRS) indicator in Hierarchics AI tells you how well your current conversation will compress. Here's what makes the difference:

HIGH compressibility

One clear domain. Consistent Observer Position. At least one formal analysis. Moderate-length messages with relational claims — not walls of text. Synthesis will be dense and useful.

MEDIUM compressibility

Some structure but also some noise. May have a clear domain but no formal analysis, or short exchanges without explicit Observer Position. Synthesis will capture the gist but may miss nuance.

LOW compressibility

Fragmented topics, very long bloated messages, or incoherent structure. No clear Observer Position. Synthesis may be vague or unreliable — consider refining in Compass first.

1
Run at least one formal analysis first
Analyses give the Librarian concrete metrics (CC_k, d_k, zone classification) to encode. Without them, the synthesis is purely qualitative — useful, but less precise.
2
Keep messages focused

Avoid extremely long messages (over 2000 characters) and rapidly switching topics. Each message should advance the relational grammar, not just explore tangentially.

3
Declare your Observer Position

Even in Clarity mode, making your Domain, Granularity, and Intent explicit helps the Librarian produce a sharper synthesis. Ask Compass: "Can we declare the Observer Position for this system?"

4
Synthesize at natural breakpoints

Don't synthesize at the exact moment you feel stuck — wait until you've reached a natural pause where the relational claims feel stable. A premature synthesis captures a moving target; a well-timed one becomes a durable re-entry card.

[The Golden Rule]
A synthesis is only as good as the conversation it compresses. If the Compressibility indicator is LOW, spend a few more exchanges tightening the focus before hitting Synthesize. The credit cost (up to 50 cr for very rich conversations) is worth it when the output is dense and reusable.
7.1 — Synthesis & Credit Efficiency

Long projects accumulate context — every message adds to the token count Compass must process on the next call. While a session is active, Compass caches the conversation so each new message only processes the recent tail. But that cache expires after about an hour of inactivity. When you pick up a long project after the cache has gone cold, the entire conversation history must be re-loaded at once — which can trigger a dramatic spike in credit usage on that first call.

This is where synthesis pays for itself. A synthesis compresses the full conversation into a small, high-density document. When you resume a cold project, Compass offers a Resume from Synthesis option: instead of re-ingesting the full raw history, it loads the cached synthesis plus your last few messages — keeping the structural understanding without the bloat.

1
Synthesize before you leave

Before stepping away from a long project, hit Synthesize with Librarian and save. This creates the compressed re-entry card that makes a cheap resume possible later.

2
Resume from Synthesis when prompted

When you reopen a large project that's been idle for over an hour, Compass warns you about the credit cost and offers two paths. Choose Resume from Synthesis to load the synthesis as cached context plus your recent messages — a fraction of the token cost of a full reload. A green SYNTH RESUME badge confirms the mode is active.

3
The cache stays warm

Once you've resumed from synthesis, the synthesis document is cached for the rest of the session — so subsequent calls stay cheap even as the conversation grows. You keep the full structural context at a fraction of the credit cost.

[No Synthesis Yet?]
If you reopen a cold project that has no saved synthesis, the full reload is unavoidable for that first call. The warning will suggest synthesizing first — a one-time cost that pays for itself the next time you resume. When in doubt, synthesize before you log off.
8 — Your Library

The Library is your project archive. From there you can:

Continue

Resume a saved project and pick up the conversation where you left off.

View Synthesis

Read the Librarian's re-entry document for any project that has been synthesized.

Compare Analyses

Plot multiple projects on the Signature Maps to compare their structural zones.

9 — Workflow Export (.mmd)

The Workflow Export turns any analysis into a portable .mmd file — a Mermaid flowchart you can edit, share, or paste into any Mermaid-compatible tool (GitHub, Notion, Obsidian, mermaid.live, etc.).

[Where to Find It]
You don't build a workflow by hand — it's generated from an analysis. Send a message in Hierarchics AI, let Compass produce an analysis, then click the WORKFLOW tab inside the analysis result card.
1
Generate an Analysis
Describe your system or architecture in Hierarchics AI. After a few exchanges, Compass produces a structured analysis with scored parent→child links, an Observer Position, and zone classification.
2
Open the WORKFLOW Tab
Inside the analysis result card, switch to the WORKFLOW tab. An inline Mermaid diagram renders immediately — no extra steps.
3
Download the .mmd File
Click Download .mmd to save the Mermaid source. The file is human-readable, editable in any text editor, and re-renders in any tool that supports Mermaid.
What the Diagram Contains
Observer Position
Your project scope — Domain (D), Granularity (G), Variable Set (X), and Intent Vector (I). Always shown when declared.
System Workflow
The validated parent→child links, with edges colored by type: green = internal, blue = external, red = subversive.
Operations & Architecture
Observer notes, architecture notes, and validation roadmaps — so the workflow reflects your operations even when you don't have exact variables.
[Portable & Editable]
The .mmd format is plain text. Open it in any editor, tweak nodes or edges, and re-render it in mermaid.live or any Markdown tool that supports Mermaid.
© 2026 Hierarchics AI LLC · The Binary Principia of Hierarchics
PrivacyTerms