# spool Design Docs

This directory stores product and architecture decisions for the long-term evolution of `spool`.

## Reading Order

1. [PRODUCT.md](/Users/long/Work/spool/docs/PRODUCT.md)
2. [ARCHITECTURE.md](/Users/long/Work/spool/docs/ARCHITECTURE.md)
3. [OBSIDIAN_SCHEMA.md](/Users/long/Work/spool/docs/OBSIDIAN_SCHEMA.md)
4. [WAKEUP_PACKET.md](/Users/long/Work/spool/docs/WAKEUP_PACKET.md)
5. [ROADMAP.md](/Users/long/Work/spool/docs/ROADMAP.md)
6. [NEXT_STEPS.md](/Users/long/Work/spool/docs/NEXT_STEPS.md)
7. [DESKTOP_HOST_ROUND_13_PLAN.md](/Users/long/Work/spool/docs/DESKTOP_HOST_ROUND_13_PLAN.md)
8. [DESKTOP_RUNBOOK.md](/Users/long/Work/spool/docs/DESKTOP_RUNBOOK.md)
9. [DESKTOP_PRODUCT_REFOCUS_PLAN.md](/Users/long/Work/spool/docs/DESKTOP_PRODUCT_REFOCUS_PLAN.md)
10. [TERMINAL_AI_INTEGRATION.md](/Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md)
11. [TASK_EXECUTION_GUIDE.md](/Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md)
12. [NEW_WINDOW_KICKOFF_PROMPTS.md](/Users/long/Work/spool/docs/NEW_WINDOW_KICKOFF_PROMPTS.md)
13. [PLANNING_ALIGNMENT.md](/Users/long/Work/spool/docs/PLANNING_ALIGNMENT.md)
14. [SESSION_HANDOFF.md](/Users/long/Work/spool/docs/SESSION_HANDOFF.md)
15. [adr/0001-local-developer-memory-os.md](/Users/long/Work/spool/docs/adr/0001-local-developer-memory-os.md)
16. [adr/0002-wakeup-packet-v1.md](/Users/long/Work/spool/docs/adr/0002-wakeup-packet-v1.md)

## Purpose

These docs define:

- what product `spool` is actually becoming
- which problems it will and will not solve
- how Obsidian should be structured as the knowledge source of truth
- how memory capture, retrieval, and security should work
- how to preserve decisions for future iterations

## Maintenance Rule

When product direction, memory structure, or security assumptions change:

1. update the relevant design doc
2. add or amend an ADR under `docs/adr/`
3. reflect user-facing changes in the top-level [README.md](/Users/long/Work/spool/README.md)
