tools-only Tiling Tree
Implements the MIT Synthetic Neurobiology tiling tree method: recursively partition a problem space into non-overlapping, collectively exhaustive subsets until reaching actionable leaf ideas, then evaluate those leaves.
Core Concept
The method's power comes from MECE splits forcing exploration of unfamiliar territory. A split is only valid when you can state precisely what each branch excludes — if you can't, the criterion is too vague and branches will overlap.
Key insight from the source method: always look for the "third option" that falls outside an obvious binary split. The bloodstream-secretion approach to neural recording only emerged because "wired vs. wireless" was defined precisely enough to reveal it covered neither case.
When to Use
- "What are all the ways we could solve X?"
- "Apply the tiling tree method to Y"
- "Exhaustively map the solution space for Z"
- Any request for MECE decomposition of a problem domain
Setup
Requires orchestrating-agents skill to be installed. Load it first:
import sys
sys.path.insert(0, '/mnt/skills/user/orchestrating-agents/scripts')
sys.path.insert(0, '/home/claude') # for muninn_utils shim if needed
import claude_client as cc
# Apply API key shim if credentials aren't in ANTHROPIC_API_KEY env var:
# from muninn_utils.orchestrating_agents_shim import patch_orchestrating_agents
# patch_orchestrating_agents(cc)
Running the Tiling Tree
# Basic usage
python3 /mnt/skills/user/tiling-tree/scripts/tiling_tree.py "Your problem here"
# With options
python3 /mnt/skills/user/tiling-tree/scripts/tiling_tree.py \
"How can we record neural activity?" \
--depth 3 \
--criteria "impact,novelty,feasibility" \
--output /mnt/user-data/outputs/neural_recording_tree.md
Parameters
| Parameter | Default | Notes |
|---|---|---|
problem |
required | Natural language problem statement |
--depth |
2 | Max recursion depth. Depth 2 ≈ 16 leaves, depth 3 ≈ 64 leaves |
--criteria |
impact,novelty,feasibility |
Comma-separated evaluation dimensions |
--output |
tiling_tree.md |
Output markdown path |
Depth guidance: Start with depth 2 to validate the problem framing. Increase to 3 only when the domain genuinely warrants it — depth 3 generates ~64 leaves and ~40 API calls.
Architecture
- Orchestrator (this script): builds tree skeleton, dispatches parallel split jobs per level, merges results, detects gaps
- Branch agents (
invoke_parallel): each receives one node to split, returns MECE branches with explicit exclusion statements - Evaluator (
invoke_claude): single agent scores all leaves for cross-leaf consistency
Parallel splitting happens level-by-level (not node-by-node), so a depth-2 tree makes only 2 API round-trips for the splitting phase regardless of branching factor.
Output
A markdown file containing:
- Full tree diagram with split criteria and evaluation scores at leaves
- Ranked leaf table sorted by overall score
JSON Parsing Note
Branch agents return JSON. Claude frequently wraps JSON in markdown fences despite instructions. The script handles this with _parse_json(). When issue #312 is resolved and parse_json_response() is added to orchestrating-agents, update the import accordingly.
Interpreting Results
Good trees have:
- Split criteria that are definitions, not questions ("energy source type" not "is it renewable?")
- Leaf exclusions that confirm non-overlap
- A "surprising" branch — something you wouldn't have thought of without the tree
If all leaves feel obvious, the split criteria were too coarse. Redo the tree with more precise definitions at the branch level where it went flat.