botserver/prompts/dev/platform/README.md

## LLM Strategy & Workflow

### Fallback Strategy (After 3 attempts / 10 minutes):
When initial attempts fail, sequentially try these LLMs:
1. **DeepSeek-V3-0324** (good architect, adventure, reliable, let little errors just to be fixed by gpt-*)
1. **DeepSeek-V3.1** (slower)
1. **gpt-5-chat** (slower, let warnings...)
1. **gpt-oss-120b**
1. **Claude (Web)**: Copy only the problem statement and create unit tests. Create/extend UI.
1. **Llama-3.3-70B-Instruct** (alternative)

### Development Workflow:
- **One requirement at a time** with sequential commits
- **On error**: Stop and consult Claude for guidance
- **Change progression**: Start with DeepSeek, conclude with gpt-oss-120b
- If a big req. fail, specify a @code file that has similar pattern or sample from official docs.
- **Final validation**: Use prompt "cargo check" with gpt-oss-120b
- Be humble, one requirement, one commit. But sometimes, freedom of caos is welcome - when no deadlines are set.
- Keep in the source codebase only deployed and tested source, no lab source code in main project. At least, use optional features to introduce new behaviour gradually in PRODUCTION.
feat(package_manager): add check_cmd to ComponentConfig and services Added check_cmd field to ComponentConfig struct and implemented health check commands for all services including minio, postgres, valkey, stalwart, caddy, zitadel, forgejo, and forgejo-runner. This allows for proper health monitoring of each service. Also updated IDE guidelines to prohibit magic values and defaults. 2025-11-04 09:25:03 -03:00			`## LLM Strategy & Workflow`

			`### Fallback Strategy (After 3 attempts / 10 minutes):`
			`When initial attempts fail, sequentially try these LLMs:`
feat: refactor auth and models, update LLM fallback strategy - Simplified auth module by removing unused imports and code - Cleaned up shared models by removing unused structs (Organization, User, Bot, etc.) - Updated add-req.sh to comment out unused directories - Modified LLM fallback strategy in README with additional notes about model behaviors The changes focus on removing unused code and improving documentation while maintaining existing functionality. The auth module was significantly reduced by removing redundant code, and similar cleanup was applied to shared models. The build script was adjusted to reflect currently used directories. 2025-11-04 23:11:33 -03:00			`1. DeepSeek-V3-0324 (good architect, adventure, reliable, let little errors just to be fixed by gpt-*)`
feat(package_manager): add check_cmd to ComponentConfig and services Added check_cmd field to ComponentConfig struct and implemented health check commands for all services including minio, postgres, valkey, stalwart, caddy, zitadel, forgejo, and forgejo-runner. This allows for proper health monitoring of each service. Also updated IDE guidelines to prohibit magic values and defaults. 2025-11-04 09:25:03 -03:00			`1. DeepSeek-V3.1 (slower)`
feat: refactor auth and models, update LLM fallback strategy - Simplified auth module by removing unused imports and code - Cleaned up shared models by removing unused structs (Organization, User, Bot, etc.) - Updated add-req.sh to comment out unused directories - Modified LLM fallback strategy in README with additional notes about model behaviors The changes focus on removing unused code and improving documentation while maintaining existing functionality. The auth module was significantly reduced by removing redundant code, and similar cleanup was applied to shared models. The build script was adjusted to reflect currently used directories. 2025-11-04 23:11:33 -03:00			`1. gpt-5-chat (slower, let warnings...)`
feat(package_manager): add check_cmd to ComponentConfig and services Added check_cmd field to ComponentConfig struct and implemented health check commands for all services including minio, postgres, valkey, stalwart, caddy, zitadel, forgejo, and forgejo-runner. This allows for proper health monitoring of each service. Also updated IDE guidelines to prohibit magic values and defaults. 2025-11-04 09:25:03 -03:00			`1. gpt-oss-120b`
			`1. Claude (Web): Copy only the problem statement and create unit tests. Create/extend UI.`
			`1. Llama-3.3-70B-Instruct (alternative)`

			`### Development Workflow:`
			`- One requirement at a time with sequential commits`
			`- On error: Stop and consult Claude for guidance`
			`- Change progression: Start with DeepSeek, conclude with gpt-oss-120b`
feat(automation): improve prompt compaction with async LLM summarization - Added initial 30s delay to compact prompt scheduler - Implemented async LLM summarization for conversation history - Reduced lock contention by minimizing critical sections - Added fallback to original text if summarization fails - Updated README with guidance for failed requirements - Added new `summarize` method to LLMProvider trait - Improved session manager query with proper DSL usage The changes optimize the prompt compaction process by: 1. Reducing lock contention through better resource management 2. Adding LLM-based summarization for better conversation compression 3. Making the system more resilient with proper error handling 4. Improving documentation for development practices 2025-11-06 17:07:12 -03:00			`- If a big req. fail, specify a @code file that has similar pattern or sample from official docs.`
feat(package_manager): add check_cmd to ComponentConfig and services Added check_cmd field to ComponentConfig struct and implemented health check commands for all services including minio, postgres, valkey, stalwart, caddy, zitadel, forgejo, and forgejo-runner. This allows for proper health monitoring of each service. Also updated IDE guidelines to prohibit magic values and defaults. 2025-11-04 09:25:03 -03:00			`- Final validation: Use prompt "cargo check" with gpt-oss-120b`
feat(bot): persist user messages and refine session handling Add logic to save user messages to session history for better traceability and context continuity. Simplify session creation error handling and remove redundant warning on closed response channel. Update README with guidance on maintaining production-ready source code. 2025-11-07 10:26:34 -03:00			`- Be humble, one requirement, one commit. But sometimes, freedom of caos is welcome - when no deadlines are set.`
			`- Keep in the source codebase only deployed and tested source, no lab source code in main project. At least, use optional features to introduce new behaviour gradually in PRODUCTION.`