Create Your First Research Space¶

This walkthrough creates a small research chain without allowing AI to write canonical conclusions.

1. Verify the repository¶

qlens doctor
qlens validate
qlens events verify
qlens registry --check

2. Inspect available object types¶

qlens new --help
qlens list --json

The example repository already includes RSP-000001. Use it for practice or create records in another validated Research Space.

3. Create a question¶

qlens new question "What relationship does بِ express in بِسْمِ اللَّهِ?"   --space RSP-000001

The command prints the new OID and path. Open the YAML record and replace template fields with the exact research question, scope, and status.

4. Create evidence and observation records¶

qlens new evidence "Quran 1:1 — بِسْمِ اللَّهِ" --space RSP-000001
qlens new observation "بِ is directly attached to اسم in 1:1" --space RSP-000001

Evidence records preserve the source. Observation records state what is visibly present before explanation.

5. Create reasoning and current understanding¶

qlens new reasoning "Relational function of بِ" --space RSP-000001
qlens new current_understanding "Working understanding of بِ" --space RSP-000001

Edit the records so reasoning cites evidence OIDs and the current understanding cites reasoning OIDs. Keep provisional language when status is working.

6. Validate and rebuild derived views¶

qlens validate
qlens events verify
qlens registry
qlens render

7. Inspect the chain¶

qlens graph QST-000001 --depth 4
qlens rql 'FROM RSP-000001 FIND * RETURN oid,type,title,status' --json

Use the actual OID printed by qlens new when it differs from the example.