New users were confused about which files they write vs. which Ralph
manages, and how PROMPT.md, specs/, and fix_plan.md relate to each other.
Added:
- docs/user-guide/ with quick start tutorial, file reference, and
requirements writing guide
- examples/simple-cli-tool/ showing minimal Ralph configuration
- examples/rest-api/ demonstrating when to use specs/
- README section explaining Ralph files and their relationships
Also documents specs/stdlib/ purpose for reusable patterns.
- Add .gitkeep files to ensure all essential directories are tracked by git
- Update .gitignore to allow .gitkeep files in logs/ and docs/generated/
- Preserve directory structure for Ralph project template system
- Directories added: src/, examples/, specs/stdlib/, templates/specs/,
logs/, docs/generated/
This ensures the complete Ralph project structure is available when
cloning the repository, even before any actual project files are created.