Plan: 1. Create docs/ directory with architecture.md and flows.md 2. docs/flows.md: MermaidJS sequence diagrams for all current flows (login, upload, download, download-shared, resolve, share, revoke, ls, rm) 3. docs/architecture.md: crate structure, encryption model detail, design decisions (extracted from README + CLAUDE.md) 4. Update README.md: slim down, link to docs/ for details 5. Update lexicons/README.md: replace ASCII flow descriptions with Mermaid diagrams 6. Review lexicons/EXAMPLES.md for accuracy
Plan: 1. Create docs/ directory with architecture.md and flows.md 2. docs/flows.md: MermaidJS sequence diagrams for all current flows (login, upload, download, download-shared, resolve, share, revoke, ls, rm) 3. docs/architecture.md: crate structure, encryption model detail, design decisions (extracted from README + CLAUDE.md) 4. Update README.md: slim down, link to docs/ for details 5. Update lexicons/README.md: replace ASCII flow descriptions with Mermaid diagrams 6. Review lexicons/EXAMPLES.md for accuracy