1 files changed, 4 insertions, 7 deletions

diff --git a/README.md b/README.md
index ceac0f3..07d3839 100644
--- a/README.md
+++ b/README.md
@@ -14,15 +14,12 @@ At each phase, edit the document to add notes (`// REVIEW:`, `// NOTE:`), click
 
 ## Sessions
 
-Each session has isolated artifacts:
+Each session has isolated artifacts stored in `~/.claude-flow/projects/{projectId}/sessions/{sessionId}/`:
 
-```
-.claude-flow/sessions/{sessionId}/
-├── research.md    # Session research
-└── plan.md        # Session plan
-```
+- `research.md` — Session research
+- `plan.md` — Session plan
 
-Concurrent sessions supported — switch between them freely.
+Concurrent sessions supported — switch between them freely. Artifacts live outside your repo so they never get accidentally committed.
 
 ## Setup