Discovery
Understand the problem before committing to a change — a read-only session that can graduate into a feature, once and only deliberately.
You do not start discovery with a command. Describe a problem, idea, decision or
change that is not scoped yet, and the agent loads the ivar-explore skill.
A discovery session is for the part of the work that comes before you know what to build. No feature is bound, and every repo is read-only on its default branch, so exploring cannot accidentally become editing.
How it runs
A plain question about existing code is answered directly and opens no session.
State the objective. Say it in your first message, or the agent asks: what would you like to understand or decide?
One question at a time. The agent reads files, searches the repos and runs read-only commands, asking a single question per turn rather than handing you a questionnaire.
Check memory once. Once the theme is clear, the agent runs
memory_query a single time. When a decision or gotcha already
settles or contradicts the idea, it tells you before going on. A failed
lookup never blocks. See Hall memory.
Build the picture. Discovery is finished when five things exist: the problem or opportunity, the desired outcome, initial scope boundaries, the repos likely affected, and the risks and open questions.
Nothing is written during discovery
Repos are read-only for the whole session. That is a property of the view directory, not a rule the agent is asked to follow. See how non-technical teammates use discovery.
Continuing one
Asking again inside an active discovery session continues it — it does not start over.
Converting to a feature
Once the five points are settled, the agent may offer to convert the session into a Feature Session. Conversion binds the session to a feature and moves its view directory into that feature's tree, making the promoted repos writable.
Conversion is offered, never automatic — and it is one-way
A feature session cannot be turned back into a discovery session, and
ivar-explore does nothing inside one. If you need to explore again
with fresh eyes, start a new discovery session.
After conversion, the ivar-plan skill turns the discovery brief
into requirements.