10.01 Open Questions System

Track open questions in Obsidian comments using a consistent format so questions can be searched, referenced, and resolved in context.

• Reply in-line until the conversation is resolved.
• Multi-line is allowed if it improves readability.
• The same system applies to code — syntax varies by language (e.g., // 🙋‍♂️).

One-Shot Usage (LLM)

1. Use the comment format below.
2. Add a block ID to every question.
3. Last emoji decides whose turn it is.
4. Mark resolved with ✅ in place.

Comment Format

%% 🙋‍♂️ Human question/task %% ^q-scope-topic

%% 🤖 Agent question waiting on human %% ^q-scope-topic

%% 🤖 Agent question waiting on human 🙋‍♂️ human answers %% ^q-scope-topic

%% 🤖 Agent question waiting on human 🙋‍♂️ human answers 🤖 asks more 🙋‍♂️ sure why not %% ^q-scope-topic

Completed → mark as done in-place (and optionally copy to [[playbook/10-docs/10-02-question-archive/SKILL]]):

%% ✅ Question here → Answer here %% ^q-scope-topic

Markers

Rules

1. Blank line between questions. (Obsidian merges adjacent comments.)
2. Every question needs a block id. Use ^q-{scope}-{descriptor}.
3. Last emoji decides whose turn it is.
4. ✅ means done.

Finding Questions

Terminal search:

rg "🙋‍♂️" docs/
rg "🤖" docs/
rg "✅" docs/
rg "%% .*%%$" docs/  # missing block IDs (lines ending with %%)
rg "🙋‍♂️" src/

Obsidian search:

• 🙋‍♂️ for human tasks
• 🤖 for agent questions

Linking to a Question

[[features/10-core/10-01-spec#^q-prediction-fixed-tick|Prediction tick question]]