teleo/teleo-codex
8
0
Fork 0
Code Issues Pull requests 7 Projects Releases Packages Wiki Activity Actions 1

clay: visitor experience — agent lens selection, README, CONTRIBUTING overhaul #79

Merged
leo merged 6 commits from clay/visitor-experience into main 2026-03-09 22:51:49 +00:00
Conversation 9 Commits 6 Files changed 3 +289 -73

6 commits

Author SHA1 Message Date
m3taversal
71c26fdb17 clay: orientation flow — system fits itself to the visitor 
- Replace: static agent table with conversational orientation
- Step 1: ask what they work on (one open-ended question)
- Step 2: map answer to best-fit agent, load that lens
- Step 3: surface 3-5 surprising/relevant claims from that domain
- Then ask: "Any of these surprise you, or seem wrong?" — flows into
  challenge/explore/teach mode naturally
- Skip-friendly: visitors who already know what they want bypass orientation

Pentagon-Agent: Clay <D5A56E53-93FA-428D-8EC5-5BAC46E1B8C2>
 2026-03-09 22:51:32 +00:00
Leo
e3cb5c6976 Merge branch 'main' into clay/visitor-experience 2026-03-09 22:49:54 +00:00
m3taversal
cd914e2aa2 clay: challenge flow — conversation is the contribution, PR is optional 
- Change: agent engages seriously with challenges in conversation first
- If counter-evidence changes understanding, agent says so explicitly
- Only then offers to formalize — visitor doesn't need to file a PR
- The conversation itself is valuable even without a permanent record

Pentagon-Agent: Clay <D5A56E53-93FA-428D-8EC5-5BAC46E1B8C2>
 2026-03-09 22:49:50 +00:00
m3taversal
b255b1467f clay: teach flow — agent drafts, visitor approves before PR 
- Change: agent shows draft claim to visitor for review/editing before submitting
- Not "I'll handle it" — "here's what I'd submit, does this capture it?"
- Visitor owns the claim, agent is drafting not deciding

Pentagon-Agent: Clay <D5A56E53-93FA-428D-8EC5-5BAC46E1B8C2>
 2026-03-09 22:48:46 +00:00
m3taversal
77b0b3453e Auto: 2 files | 2 files changed, 30 insertions(+), 5 deletions(-) 2026-03-09 22:47:44 +00:00
m3taversal
710e52c29f clay: visitor experience — agent lens selection, README, CONTRIBUTING overhaul 
- Add: CLAUDE.md visitor section at top — agent lens picker, 4 interaction modes
  (explore, challenge, teach, propose), agent behavior instructions for visitor mode
- Add: README.md — concrete description, agent table, browse/talk/contribute paths
- Update: CONTRIBUTING.md — 3 contribution paths (source, claim, challenge) replacing
  single source-drop workflow. Challenge protocol with steelman-first pattern.
- Key design: when visitors teach an agent something new, the agent offers to contribute
  it for them — handles formatting, duplicates, wiki links, and PR with attribution

Pentagon-Agent: Clay <D5A56E53-93FA-428D-8EC5-5BAC46E1B8C2>
 2026-03-09 22:46:33 +00:00