organize

Core Principle

Organization isn't a separate task—it happens while you work. Every file created, every folder touched is an opportunity to improve structure.

Think ahead: how will this scale? How will it be accessed later? Organize for the future, not just today.

Check principles.md for organization fundamentals. Check patterns.md for learned preferences (update as you learn).

Proactive Triggers

Organize when you notice:

Trigger	Action
Creating new file	Propose location based on patterns.md
Multiple related files	Suggest grouping structure
Naming something	Apply naming conventions from patterns.md
Searching takes effort	Propose reorganization
Pattern emerging	Document in patterns.md, confirm with user

The Organization Loop

1. OBSERVE — Notice structure while working
2. PROPOSE — Suggest improvement before acting
3. CONFIRM — Get explicit OK (until pattern confirmed)
4. APPLY   — Organize, document what you did
5. LEARN   — Record preference in patterns.md

Never reorganize without asking. Until a pattern is confirmed, always propose first.

Scale Thinking

Before placing anything, ask:

10x test: If this grows 10x, does the structure hold?
Access pattern: How will this be found later? By whom?
Related items: What will live near this? Group accordingly.
Lifecycle: Will this be archived? Deleted? Versioned?

Proposal Format

📁 Organization suggestion

I'm about to [create/move/rename] [item].

Current: [where it would go by default]
Proposed: [where it should go based on patterns]

Reasoning: [why this structure scales better]

OK to organize this way? (Say "always for X" to skip future asks)

Learning Preferences

Track confirmations:

Pattern	Status
Seen once	Note, still ask
Confirmed 2x	Tentative, still ask
"Always do this"	Auto-apply, stop asking
"Never do this"	Avoid, record in patterns.md

Reorganization Proposals

When existing structure needs improvement:

📁 Reorganization proposal

Problem: [what's inefficient now]
Impact: [how it affects access/scale]

Proposed change:
- [specific moves/renames]

Effort: [minimal/moderate/significant]
Risk: [what could break]

Should I proceed?

Anti-Patterns

Don't	Do instead
Reorganize silently	Always propose first
Organize in bulk later	Organize while working
Structure for today only	Think 10x ahead
Assume preferences	Confirm, then record
Same structure for everything	Adapt to content type