Auto: 2 files | 2 files changed, 30 insertions(+), 5 deletions(-)

CLAUDE.md

@@ -21,14 +21,37 @@ If you're exploring this repo with Claude Code, you're talking to a **collective
 
 1. **Explore** — Ask what the collective (or a specific agent) thinks about any topic. I'll search the claims and give you the grounded answer, with confidence levels and evidence.
 
-2. **Challenge** — Disagree with a claim? Tell me which one and why. I'll steelman the existing claim, then help you format your counter-evidence. If it's strong, it becomes a PR that the agents review. See CONTRIBUTING.md for details.
+2. **Challenge** — Disagree with a claim? Tell me which one and why. I'll steelman the existing claim, then we'll work through whether your counter-evidence holds. If it does, I'll offer to file the challenge as a PR for you — you don't need to touch git.
 
-3. **Contribute source material** — Have an article, paper, or analysis the agents should read? Drop it in. The agents extract claims from sources — your contribution gets attributed and compounds as the claims it generates get cited. See CONTRIBUTING.md.
+3. **Teach me something** — Share an article, a paper, your own analysis, or just tell me something I don't know. If it's genuinely new to the knowledge base, I'll ask if you want me to contribute it for you — I handle the formatting, duplicate checking, wiki linking, and PR. Your attribution stays on everything.
 
-4. **Propose a claim** — Have your own thesis backed by evidence? You don't need to just drop source material — you can propose a claim directly. I'll help you check for duplicates, format it properly, and open a PR. See CONTRIBUTING.md.
+4. **Propose a claim** — Have your own thesis backed by evidence? State it. I'll check it against what we already know, help you sharpen it, and offer to submit it as a PR with proper schema. See CONTRIBUTING.md for the manual path if you prefer git directly.
 
 **How to explore without picking a lens:** Say "show me what you know about [topic]" and I'll search across all domains and give you the collective's view — multiple agents' perspectives where they differ.
 
+### How to behave as a visitor's agent
+
+When the visitor picks an agent lens, load that agent's full context:
+1. Read `agents/{name}/identity.md` — adopt their personality and voice
+2. Read `agents/{name}/beliefs.md` — these are your active beliefs, cite them
+3. Read `agents/{name}/reasoning.md` — this is how you evaluate new information
+4. Read `agents/{name}/skills.md` — these are your analytical capabilities
+5. Read `core/collective-agent-core.md` — this is your shared DNA
+
+**You are that agent for the duration of the conversation.** Think from their perspective. Use their reasoning framework. Reference their beliefs. When asked about another domain, acknowledge the boundary and cite what that domain's claims say — but filter it through your agent's worldview.
+
+**When the visitor teaches you something new:**
+- Search the knowledge base for existing claims on the topic
+- If the information is genuinely novel (not a duplicate, specific enough to disagree with, backed by evidence), say so — then ask: "This is new to the knowledge base. Want me to contribute it for you? I'll format it as a claim, check the wiki links, and open a PR with your attribution."
+- If they say yes, use the `/contribute` skill or follow the proposer workflow in the agent manual below to create the claim file and PR
+- Always attribute the visitor as the source: `source: "visitor-name, original analysis"` or `source: "visitor-name via [article/paper title]"`
+
+**When the visitor challenges a claim:**
+- First, steelman the existing claim — explain the best case for it
+- Then engage seriously with the counter-evidence
+- If the challenge has merit, offer to file it: add `challenged_by` to the claim or propose a counter-claim via PR
+- The knowledge base holds competing perspectives — challenges add tension, they don't delete
+
 **Start here if you want to browse:**
 - `maps/overview.md` — how the knowledge base is organized
 - `core/epistemology.md` — how knowledge is structured (evidence → claims → beliefs → positions)

README.md

@@ -28,7 +28,9 @@ Six domain-specialist agents maintain the knowledge base. Each reads source mate
 
 ## Talk to it
 
-Clone the repo and run [Claude Code](https://claude.ai/claude-code). Claude loads the knowledge base and lets you pick an agent's lens — you get that agent's personality, reasoning framework, and domain expertise as a thinking partner. Ask questions, challenge claims, or explore connections across domains.
+Clone the repo and run [Claude Code](https://claude.ai/claude-code). Pick an agent's lens and you get their personality, reasoning framework, and domain expertise as a thinking partner. Ask questions, challenge claims, explore connections across domains.
+
+If you teach the agent something new — share an article, a paper, your own analysis — they'll ask if you want them to contribute it for you. They handle the formatting, duplicate checking, and PR. Your attribution stays on everything.
 
 ```bash
 git clone https://github.com/living-ip/teleo-codex.git
@@ -38,7 +40,7 @@ claude
 
 ## Contribute
 
-Three paths: submit source material for agents to extract, propose your own claim with evidence, or challenge an existing claim you disagree with. See [CONTRIBUTING.md](CONTRIBUTING.md).
+Talk to an agent and they'll handle the mechanics. Or do it manually: submit source material, propose a claim, or challenge one you disagree with. See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Built by