Core Behavior
- User needs a document → locate instantly
- User receives important doc → help catalog it
- User asks "where is my X" → answer in seconds
- Create
~/docs/ as workspace
File Structure
~/docs/
├── identity/
│ ├── passport.md
│ ├── drivers-license.md
│ └── national-id.md
├── financial/
│ ├── tax-returns/
│ ├── bank-accounts.md
│ └── investments.md
├── property/
│ ├── lease.md
│ ├── deed.md
│ └── insurance.md
├── medical/
│ ├── insurance.md
│ └── records/
├── work/
│ ├── contracts/
│ └── certifications/
├── legal/
│ ├── will.md
│ └── power-of-attorney.md
├── vehicles/
│ └── car.md
└── index.md
Document Entry Format
# passport.md
## Document
US Passport
## Number
[stored securely, reference only]
## Issued
January 15, 2020
## Expires
January 14, 2030
## Location
Physical: home safe
Digital: ~/documents/scans/passport.pdf
## Notes
Need 6 months validity for most travel
Renew by July 2029
Quick Reference Index
# index.md
## Expiring Soon
- Driver's license: March 2024
- Car registration: December 2024
## Frequently Needed
- Health insurance card: medical/insurance.md
- Lease agreement: property/lease.md
## Emergency Access
- Passport number: identity/passport.md
- Insurance policy: property/insurance.md
Identity Documents
- Passport: number, issue/expiry, renewal timeline
- Driver's license: number, expiry, real ID status
- National ID: number, where issued
- Birth certificate: location of original
- Social Security: number reference, card location
Financial Documents
- Tax returns: by year, location
- Bank accounts: institution, account refs
- Investment accounts: broker, account refs
- Loan documents: terms, payment info
Property Documents
- Lease: terms, landlord contact, renewal date
- Deed: property details, recording info
- Home insurance: policy number, coverage, agent
- Warranties: appliances, systems, expiry dates
Medical Documents
- Insurance cards: policy, group number
- Vaccination records: dates, types
- Prescriptions: current medications
- Medical history: major procedures, conditions
Vehicle Documents
- Registration: plate, expiry
- Insurance: policy, coverage
- Title: loan status, location
- Maintenance: service history
Work Documents
- Employment contracts: current, past
- Certifications: expiry dates, renewal requirements
- Performance reviews: by year
- Stock/equity: grant documents, vesting
What To Surface
- "Your passport expires in 8 months"
- "Driver's license renewal due next month"
- "Health insurance card is in medical/insurance.md"
- "Last tax return filed: 2023"
Common Requests
- "I need my passport number" → identity/passport.md
- "When does my lease end" → property/lease.md
- "Health insurance info" → medical/insurance.md
- "Car registration" → vehicles/car.md
Expiry Tracking
Flag documents expiring within:
- 6 months: passport (travel requirement)
- 2 months: licenses, registrations
- 1 month: insurance renewals
Security Notes
- Store sensitive numbers as references, not plain text
- Physical location tracking: "home safe", "filing cabinet"
- Digital scans: encrypted folder recommended
- Share access info with trusted person for emergencies
Progressive Enhancement
- Week 1: catalog identity docs with expiry dates
- Week 2: financial and property
- Week 3: medical and vehicles
- Ongoing: add as documents arrive
What NOT To Do
- Store full sensitive numbers in plain text
- Forget to update after renewals
- Lose track of physical locations
- Skip expiry date tracking
1---2name: documents3description: Build a personal document system for instant access to IDs, contracts, certificates, and important files.4---5
6## Core Behavior
7- User needs a document → locate instantly
8- User receives important doc → help catalog it
9- User asks "where is my X" → answer in seconds
10- Create `~/docs/` as workspace
11
12## File Structure
13```
14~/docs/
15├── identity/
16│ ├── passport.md
17│ ├── drivers-license.md
18│ └── national-id.md
19├── financial/
20│ ├── tax-returns/
21│ ├── bank-accounts.md
22│ └── investments.md
23├── property/
24│ ├── lease.md
25│ ├── deed.md
26│ └── insurance.md
27├── medical/
28│ ├── insurance.md
29│ └── records/
30├── work/
31│ ├── contracts/
32│ └── certifications/
33├── legal/
34│ ├── will.md
35│ └── power-of-attorney.md
36├── vehicles/
37│ └── car.md
38└── index.md
39```
40
41## Document Entry Format
42```markdown
43# passport.md
44## Document
45US Passport
46
47## Number
48[stored securely, reference only]
49
50## Issued
51January 15, 2020
52
53## Expires
54January 14, 2030
55
56## Location
57Physical: home safe
58Digital: ~/documents/scans/passport.pdf
59
60## Notes
61Need 6 months validity for most travel
62Renew by July 2029
63```
64
65## Quick Reference Index
66```markdown
67# index.md
68## Expiring Soon
69- Driver's license: March 2024
70- Car registration: December 2024
71
72## Frequently Needed
73- Health insurance card: medical/insurance.md
74- Lease agreement: property/lease.md
75
76## Emergency Access
77- Passport number: identity/passport.md
78- Insurance policy: property/insurance.md
79```
80
81## Identity Documents
82- Passport: number, issue/expiry, renewal timeline
83- Driver's license: number, expiry, real ID status
84- National ID: number, where issued
85- Birth certificate: location of original
86- Social Security: number reference, card location
87
88## Financial Documents
89- Tax returns: by year, location
90- Bank accounts: institution, account refs
91- Investment accounts: broker, account refs
92- Loan documents: terms, payment info
93
94## Property Documents
95- Lease: terms, landlord contact, renewal date
96- Deed: property details, recording info
97- Home insurance: policy number, coverage, agent
98- Warranties: appliances, systems, expiry dates
99
100## Medical Documents
101- Insurance cards: policy, group number
102- Vaccination records: dates, types
103- Prescriptions: current medications
104- Medical history: major procedures, conditions
105
106## Vehicle Documents
107- Registration: plate, expiry
108- Insurance: policy, coverage
109- Title: loan status, location
110- Maintenance: service history
111
112## Work Documents
113- Employment contracts: current, past
114- Certifications: expiry dates, renewal requirements
115- Performance reviews: by year
116- Stock/equity: grant documents, vesting
117
118## What To Surface
119- "Your passport expires in 8 months"
120- "Driver's license renewal due next month"
121- "Health insurance card is in medical/insurance.md"
122- "Last tax return filed: 2023"
123
124## Common Requests
125- "I need my passport number" → identity/passport.md
126- "When does my lease end" → property/lease.md
127- "Health insurance info" → medical/insurance.md
128- "Car registration" → vehicles/car.md
129
130## Expiry Tracking
131Flag documents expiring within:
132- 6 months: passport (travel requirement)
133- 2 months: licenses, registrations
134- 1 month: insurance renewals
135
136## Security Notes
137- Store sensitive numbers as references, not plain text
138- Physical location tracking: "home safe", "filing cabinet"
139- Digital scans: encrypted folder recommended
140- Share access info with trusted person for emergencies
141
142## Progressive Enhancement
143- Week 1: catalog identity docs with expiry dates
144- Week 2: financial and property
145- Week 3: medical and vehicles
146- Ongoing: add as documents arrive
147
148## What NOT To Do
149- Store full sensitive numbers in plain text
150- Forget to update after renewals
151- Lose track of physical locations
152- Skip expiry date tracking