Useful Discoveries System

Purpose: .roo/docs/useful.md is a knowledge base for solutions, patterns, and workarounds discovered during development. Definitions: At bottom.

Finding solutions; when to READ from useful.md:

•Before starting complex or unfamiliar tasks
•When encountering errors or unexpected behavior
•When stuck after trying initial approaches
•Before implementing workarounds or non-obvious solutions

Saving solutions; When to WRITE to useful.md:

•After solving a non-obvious bug or error
•When discovering a workaround for a limitation
•After finding an effective pattern or approach worth reusing
•When learning something about the environment, tools, or dependencies
•After resolving a problem that took significant investigation

When to PARE useful.md:

THIS SECTION IS A WORK IN PROGRESS Execute sequentially. Skip nothing.

1. Find redundant or similar items

Read through all discoveries. Conditions:

•You found redundant Items (exactly same except for date/time): Action: Delete the older one(s) from Discoveries.
•You found similar items: Action: Combine into one cohesive Item and give a new date.

Definitions

Item(s): One discovery. Discoveries: All useful discovery items in the file. Entry Format (use exactly this format):

code

YYYY-MM-DD HH:MM | [Category] | [Brief description of discovery]
- Context: [What task/situation led to this]
- Solution: [What worked and why]
- Related files: [Affected or relevant files]

Category Examples:

•Testing, Database, Flask, Python, Config, Dependencies, Performance, UI/UX, Debugging, Workflow Example Entry:

code

2025-12-18 14:23 | Python | Multi-line scripts must be run from .py files, not pasted into terminal
- Context: Terminal would fail when pasting complex database queries
- Solution: Always create temporary .py files in utils_db/ for multi-line operations
- Related files: utils_db/*.py