FG-0510 Workspace Organization Standard
Description
Define and enforce consistent directory structures, naming conventions, and file organization. AI agents navigate workspaces by reading directory listings and file paths. A well-organized workspace enables faster context recovery, reduces navigation errors, and prevents the gradual entropy that transforms a clean repository into an archaeological dig. Organization is infrastructure, not decoration.
Implementation
Define a maximum file count per directory (10-15 recommended). Establish naming conventions for files and directories. Create an archive system for completed work. Document the organization standard in the repository. Review organization weekly and fix drift before it accumulates.
Success Indicators
- New sessions can navigate the workspace without guidance
- File naming is consistent and predictable
- Completed work is archived, not cluttering active directories
- Organization debt is addressed regularly, not ignored until crisis
Failure Modes
- Organization standard exists but isn't enforced
- Over-organizing: deeply nested structures that are hard to navigate
- Archive system not used: everything stays in active directories
- Naming conventions that are logical to one person but opaque to others