Research Roadmap
> Questions worth exploring, not yet ready for content production.
> Last updated: 2026-07-24
---
Active Investigations
Agent Programming Conventions Format
What format should an agent-ready codebase conventions guide take?
The Interface Notions document is a human-readable catalog. For agents, it may need to be a structured prompt template, a TypeScript type system, a JSON Schema, or all three.
Status: Exploring — need to test with actual coding agents
Next: Try feeding the Interface Notions doc to an agent and measure code quality vs. a baseline
Document Machine Extractability
What is the boundary between app-specific and generic in the document machine?
The machine touches daemon state, vault delegation, IndexedDB, WebCrypto, and XState v5 internals. A clean extraction requires understanding which parts are Seed-specific and which are generally useful.
Status: Scoping — need to audit machine dependencies
Next: Map every actor/state to its dependency category
Path Quality in Trust Graphs
How should EigenTrust-style weighting work with Seed's contact system?
The Graduated Trust proposal mentions EigenTrust-style path quality weighting but doesn't specify how it maps to Seed's directional, scoped, revocable contacts.
Status: Conceptual — not yet formalized
Next: Prototype a hop-distance calculation over the contact graph
---
Backburner
| Question | Why It Matters | Trigger |
|---|---|---|
| How should document embeds affect the All Documents directory tree? | Embed-as-reference vs embed-as-inclusion changes how we model documents | All Documents Directory mockup |
| Can commenting state also be modeled as a state machine? | Extends the state machine pattern to a new domain | Commenting UX doc |
| What is the right proof-of-work at each trust hop? | Needed before Graduated Trust can be implemented | Graduated Trust proposal |
| How does the State Machines content audience overlap with the Seed audience? | Determines whether cross-promotion is viable | Content hub traffic data |---
Recently Concluded
| Question | Conclusion | Evidence |
|---|---|---|
| Should heading spacing scale by level? | Yes — implemented 2:1 top-to-bottom ratio | Editor rendering fix PR |
| Should nested text shrink by depth? | No — removed relative font scaling | Same PR |
| Is electron-trpc right for simple getters? | No — 42 procedures should migrate to direct IPC | Electron tRPC analysis |Do you like what you are reading? Subscribe to receive updates.
Unsubscribe anytime