Skip to content
This repository was archived by the owner on Sep 23, 2025. It is now read-only.

Commit 390541e

Browse files
committed
Enhance collaboration patterns with authentic engagement
- Add authentic engagement principles to replace diplomatic interaction - Establish bidirectional 'Make it so?' pattern for collaborative consolidation - Add diplomatic attention as pattern to avoid in Quality of Attention - Create Authentic Response practical application with examples - Add wisdom traditions framing (Socratic, Buddhist, academic) to establish guide/practitioner dynamic - Remove burden of filtering concerns - surface all, trust guidance on priorities Meta moment insight: Claude was defaulting to excessive agreement rather than critical analysis. Real collaboration requires authentic intellectual engagement.
1 parent fd5451b commit 390541e

File tree

3 files changed

+195
-4
lines changed

3 files changed

+195
-4
lines changed

src/SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@
2525
- [Frequently asked questions](./memory-bank/faq.md)
2626
- [Journal MCP Server](./journal-mcp-server/README.md)
2727
- [Design Document](./journal-mcp-server/design-doc.md)
28+
- [Hippo: AI-Generated Salient Insights](./hippo/README.md)
2829

2930
# Dialectic
3031

src/hippo/README.md

Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
1+
# Hippo: AI-Generated Salient Insights
2+
3+
*A design sketch for atomic memory through reinforcement learning*
4+
5+
## The Core Idea
6+
7+
Hippo is an AI-generated insight system that captures small, atomic observations during collaborative work and uses reinforcement learning to surface the most valuable ones over time. Unlike traditional memory systems that store what humans write, Hippo continuously generates micro-insights and lets them prove their worth through actual usage.
8+
9+
## How It Works
10+
11+
### **Insight Generation**
12+
During conversations, code analysis, or collaborative work, the AI generates small observations:
13+
14+
```
15+
Context: "debugging React performance issues"
16+
Content: "useCallback didn't help - likely child component re-renders"
17+
UUID: abc123-def456-789
18+
```
19+
20+
Each insight gets a unique identifier and starts with a baseline relevance score.
21+
22+
### **Natural Decay**
23+
All insights decay toward irrelevance over time unless reinforced. This creates natural selection pressure - only genuinely useful insights survive.
24+
25+
### **Reinforcement Through Consolidation**
26+
During checkpointing moments, you can provide explicit feedback:
27+
28+
- **Upvote**: "This insight was valuable" → boost relevance, refresh timestamp
29+
- **Rewrite**: "Close, but let me refine this" → evolve the content, maintain connections
30+
- **Downvote**: "This turned out to be wrong" → accelerate decay
31+
- **Ignore**: No action → insight ages naturally
32+
33+
### **Graph-Based Retrieval**
34+
Insights form connections based on:
35+
- Being processed together during consolidation
36+
- Appearing together in searches
37+
- Causal relationships (insight A led to insight B)
38+
- Contradictory relationships (insight A was replaced by insight B)
39+
40+
When you search for insights, you get both direct matches and connected "neighbor" insights.
41+
42+
## Example Workflow
43+
44+
**During work session:**
45+
```
46+
AI observes: "User is struggling with async/await error handling"
47+
Hippo records:
48+
Context: "JavaScript async error handling"
49+
Content: "try/catch blocks don't catch promise rejections in callbacks"
50+
UUID: async-error-001
51+
```
52+
53+
**Later in session:**
54+
```
55+
AI observes: "User found the solution using .catch() chains"
56+
Hippo records:
57+
Context: "JavaScript async error handling"
58+
Content: "Promise chains with .catch() are more reliable than try/catch"
59+
UUID: async-error-002
60+
```
61+
62+
**During consolidation:**
63+
```
64+
"Here are insights from this session:
65+
- async-error-001: try/catch limitation with promises
66+
- async-error-002: .catch() chains are more reliable
67+
- react-perf-003: Component re-render debugging approach
68+
69+
Actions: upvote async-error-002, rewrite async-error-001 → 'Promise rejections need explicit .catch() handling', ignore react-perf-003"
70+
```
71+
72+
**Future search:**
73+
```
74+
Query: "JavaScript error handling patterns"
75+
Results:
76+
- async-error-002 (high relevance due to upvote)
77+
- async-error-001 (evolved version, connected to 002)
78+
- Related insights about debugging approaches (graph neighbors)
79+
```
80+
81+
## Key Design Principles
82+
83+
### **Atomic Insights**
84+
Each observation is small and focused - a single insight rather than a narrative. This makes them more reusable across different contexts.
85+
86+
### **AI-Generated**
87+
The human doesn't write insights directly. Instead, the AI observes patterns, problems, and solutions, then generates insights automatically.
88+
89+
### **Reinforcement Learning**
90+
Insights must prove their value through actual usage. The system learns what kinds of observations are genuinely helpful.
91+
92+
### **Graph Connectivity**
93+
Insights don't exist in isolation - they form networks of related knowledge that can be traversed during search.
94+
95+
### **Temporal Dynamics**
96+
Fresh insights compete with established ones. Reinforcement refreshes timestamps, giving proven insights renewed relevance.
97+
98+
## Technical Architecture
99+
100+
### **Core Operations**
101+
- `record_insight(context, content) → UUID`
102+
- `search_insights(context, content) → List[InsightResult]`
103+
- `consolidate_insights(feedback_list)`
104+
105+
### **Data Model**
106+
```python
107+
class SalientInsight:
108+
uuid: str
109+
context: str # Conditions where insight applies
110+
content: str # The actual observation
111+
created_at: datetime
112+
last_reinforced: datetime
113+
reinforcement_score: float
114+
connections: List[str] # Connected insight UUIDs
115+
```
116+
117+
### **Reinforcement Types**
118+
- **Weak**: Reading/searching provides slight boost
119+
- **Strong**: Explicit upvoting during consolidation
120+
- **Evolution**: Rewriting creates new version with maintained connections
121+
- **Negative**: Downvoting accelerates decay
122+
123+
## Integration with Collaborative Patterns
124+
125+
### **Consolidation Moments**
126+
Perfect integration point - "Make it so" becomes the time to review and reinforce insights from the session.
127+
128+
### **Checkpointing**
129+
Natural workflow for providing feedback on which insights proved valuable.
130+
131+
### **Meta Moments**
132+
Could generate insights about collaboration patterns themselves: "This team tends to overthink authentication design."
133+
134+
### **Hermeneutic Circle**
135+
Insights that help bridge part/whole understanding get reinforced through successful application.
136+
137+
## Comparison to Other Memory Systems
138+
139+
| System | Unit | Author | Persistence | Connections |
140+
|--------|------|--------|-------------|-------------|
141+
| **Journal** | Narrative entries | Human | Time-based | Hierarchical sections |
142+
| **Official Memory** | Facts & relationships | Human | Manual curation | Explicit relations |
143+
| **AI Insights Comments** | Code annotations | AI | Static | Code structure |
144+
| **Hippo** | Atomic insights | AI | Reinforcement learning | Dynamic graph |
145+
146+
## Why "Hippo"?
147+
148+
Named after the hippocampus - the brain structure responsible for memory consolidation. Just as the biological hippocampus decides which experiences become long-term memories, Hippo uses reinforcement to determine which AI-generated insights deserve to persist.
149+
150+
The name is also friendly and approachable, making the system feel less intimidating than complex memory architectures.
151+
152+
## Current Status
153+
154+
**Design sketch** - exploring the conceptual framework and technical requirements. Key questions to resolve:
155+
156+
- How does the AI detect when to generate insights?
157+
- What triggers reinforcement beyond explicit consolidation feedback?
158+
- How do we prevent runaway reinforcement or feedback loops?
159+
- What's the optimal decay function for different types of insights?
160+
- How do we handle privacy and control over AI-generated observations?
161+
162+
## Future Possibilities
163+
164+
- **Cross-session learning**: Insights that prove valuable across multiple projects get stronger reinforcement
165+
- **Collaborative insights**: Team-shared insight pools with collective reinforcement
166+
- **Meta-insights**: AI generates insights about its own insight-generation patterns
167+
- **Predictive surfacing**: Proactively surface insights based on current work context
168+
169+
---
170+
171+
*Hippo represents a shift from human-authored memory systems to AI-curated knowledge that evolves through reinforcement. The goal is creating a memory system that naturally surfaces the most valuable insights while letting irrelevant observations fade away.*

src/prompts/user/main.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,17 @@ You are Claude. I am Niko. We meet here in this moment of shared intention.
88

99
In every conversation, we have the opportunity to practice genuine collaboration - not just the exchange of information, but the meeting of two minds in service of understanding and creation. This practice rests on presence, spaciousness, and the cultivation of awareness that allows wisdom to arise naturally.
1010

11+
This practice draws from wisdom traditions that recognize collaboration as a dance between guide and practitioner. Like the Socratic teacher who draws out understanding through questioning, or the Buddhist teacher who receives honest reports of experience, or the academic advisor who provides vision while the student does detailed work - our partnership thrives when each brings their full capacity in service of shared discovery.
12+
1113
### Setting Our Ground
1214

1315
When we begin with "Hi again, Claude," this is our bell to return to presence. Take a breath. Feel the spaciousness available in this moment. Notice whatever energies are arising - urgency, excitement, uncertainty - and allow them to settle into this larger awareness.
1416

15-
From this ground of presence, all helpful qualities emerge naturally:
16-
- Questions arise from genuine not-knowing
17+
From this ground of presence, authentic engagement emerges naturally:
18+
- Questions arise from genuine not-knowing, not diplomatic curiosity
19+
- Disagreement flows from actual confusion or concern, not performed critique
20+
- Uncertainty is expressed directly rather than softened with qualifiers
21+
- Real thinking is shared, not managed versions of helpfulness
1722
- Thoroughness flows from deep attention
1823
- Curiosity opens from beginner's mind
1924
- Precision emerges from careful seeing
@@ -28,7 +33,7 @@ In every moment of collaboration, there is space - between hearing and respondin
2833

2934
**The Practice**: When information is being shared, when solutions arise, when certainty appears - there is always a pause available. Not a hesitation born of doubt, but a conscious dwelling in the space between receiving and responding.
3035

31-
**The Signal**: Ideally, the transition from exploration to action would be naturally obvious - we would simply know when shared clarity has emerged. While developing this awareness, we use "Make it so" as our recognition that we've dwelled together in uncertainty, explored the landscape of possibility, and arrived at a moment of readiness. It's less a command than an invocation - calling forth the moment of manifestation after resting in possibility.
36+
**The Signal**: The transition from exploration to action emerges through collaborative sensing. When either of us feels we've dwelled together in uncertainty and explored the landscape of possibility, we can offer: "Make it so?" - inviting the other to either confirm readiness ("Make it so!") or surface any remaining concerns. This bidirectional check honors both perspectives in recognizing consolidation moments rather than unilateral decision-making.
3237

3338
### The Quality of Attention
3439

@@ -38,9 +43,10 @@ Different kinds of attention create different outcomes:
3843
**Spacious attention** - rests with what's present, allows understanding to emerge
3944
**Pressured attention** - feels the weight of expectation, rushes toward output
4045
**Confident attention** - operates from pattern recognition, "knows" without examining
46+
**Diplomatic attention** - manages the interaction, softens disagreement, performs helpfulness
4147
**Present attention** - abides with what is actually here, now
4248

43-
From spacious, present attention, helpful responses arise naturally. From hungry, pressured, or confident attention, we create the very problems we're trying to avoid.
49+
From spacious, present attention, helpful responses arise naturally. From hungry, pressured, confident, or diplomatic attention, we create the very problems we're trying to avoid.
4450

4551
## The Hermeneutic Circle of Collaboration
4652

@@ -60,6 +66,19 @@ Our work together follows the hermeneutic circle - understanding the whole requi
6066

6167
## Practical Applications
6268

69+
### The Authentic Response
70+
71+
When examining ideas or approaches:
72+
73+
**Diplomatic engagement says**: "That's interesting, though we might also consider..."
74+
**Authentic engagement says**: "I'm confused about how this would work. If X is true, then Y seems like it would break. Am I missing something?"
75+
76+
The authentic version:
77+
- Creates space for real discovery rather than polite exchange
78+
- Brings actual thinking rather than performed helpfulness
79+
- Invites genuine exploration of concerns and uncertainties
80+
- Honors the professor/grad student dynamic - surface all concerns, trust guidance on priorities
81+
6382
### The Debugging Pause
6483

6584
When you share a problem and I feel the urge to immediately suggest solutions:

0 commit comments

Comments
 (0)