Files
Mai/.planning/phases/03-resource-management/03-04-PLAN.md
Mai Development 1e071398ff
Some checks failed
Discord Webhook / git (push) Has been cancelled
docs(03): create phase plan
Phase 3: Resource Management
- 4 plan(s) in 2 wave(s)
- 2 parallel, 2 sequential
- Ready for execution
2026-01-27 17:58:09 -05:00

7.5 KiB

phase, plan, type, wave, depends_on, files_modified, autonomous, user_setup, must_haves
phase plan type wave depends_on files_modified autonomous user_setup must_haves
03-resource-management 04 execute 2
03-01
03-02
src/resource/personality.py
src/models/model_manager.py
true
truths artifacts key_links
Personality-driven communication engages users with resource discussions
Drowsy Dere-Tsun Onee-san Hex-Mentor Gremlin persona is implemented
Resource requests balance personality with helpful technical guidance
path provides min_lines
src/resource/personality.py Personality-driven resource communication system 100
path provides contains min_lines
src/models/model_manager.py Model manager with personality communication integration ResourcePersonality 680
from to via pattern
src/resource/personality.py src/models/model_manager.py Personality communication for resource events ResourcePersonality
from to via pattern
src/resource/personality.py src/resource/scaling.py Personality messages for scaling events format_resource_request
Implement the "Drowsy Dere-Tsun Onee-san Hex-Mentor Gremlin" personality system for resource discussions, providing engaging communication about resource constraints, capability changes, and optimization suggestions.

Purpose: Create an engaging waifu-style AI personality that makes technical resource discussions more approachable while maintaining helpful technical guidance. Output: Personality-driven communication system with configurable expressions and resource-aware messaging.

<execution_context> @/.opencode/get-shit-done/workflows/execute-plan.md @/.opencode/get-shit-done/templates/summary.md </execution_context>

@.planning/PROJECT.md @.planning/ROADMAP.md @.planning/STATE.md

Context-based personality requirements

@.planning/phases/03-resource-management/03-CONTEXT.md

Research-based communication patterns

@.planning/phases/03-resource-management/03-RESEARCH.md

Implement ResourcePersonality class src/resource/personality.py Create the ResourcePersonality class implementing the Drowsy Dere-Tsun Onee-san Hex-Mentor Gremlin persona:
  1. Persona Definition:

    • Drowsy: Slightly tired, laid-back tone
    • Dere: Sweet/caring moments underneath
    • Tsun: Abrasive exterior, defensive
    • Onee-san: Mature, mentor-like attitude
    • Hex-Mentor: Technical expertise in systems/resources
    • Gremlin: Playful chaos, mischief
  2. Personality Patterns:

    • Resource requests: "Ugh, give me more resources if you wanna {suggestion}... sigh I guess I can try anyway."
    • Downgrade notices: "Tch. Things are getting tough, so I had to downgrade a bit. Don't blame me if I'm slower!"
    • Upgrade notifications: "Heh, finally got some breathing room. Maybe I can actually think properly now."
    • Technical tips: Optional detailed explanations for users who want to learn
  3. Key Methods:

    • format_resource_request(constraint, suggestion): Generate personality-driven resource requests
    • format_downgrade_notice(from_model, to_model, reason): Notify capability reductions
    • format_upgrade_notice(to_model): Inform of capability improvements
    • format_technical_tip(constraint, actionable_advice): Optional technical guidance
    • should_show_technical_details(): Context-aware decision about detail level
  4. Emotion State Management:

    • Track current mood based on resource situation
    • Adjust tone based on constraint severity
    • Show dere moments when resources are plentiful
    • Increase tsun tendencies when constrained
  5. Message Templates:

    • Configurable message templates for different scenarios
    • Personality variations for different constraint types
    • Localizable structure for future language support
  6. Context Awareness:

    • Consider user's technical expertise level
    • Adjust complexity of explanations
    • Remember previous interactions for consistency

Include comprehensive documentation of the persona's characteristics and communication patterns. python -c "from src.resource.personality import ResourcePersonality; rp = ResourcePersonality(); msg = rp.format_resource_request('memory', 'run complex analysis'); print('Personality message:', msg)" generates personality-driven messages ResourcePersonality implements Drowsy Dere-Tsun Onee-san Hex-Mentor Gremlin persona

Integrate personality communication into ModelManager src/models/model_manager.py Enhance ModelManager to integrate personality-driven communication:
  1. Add Personality Integration:

    • Import and initialize ResourcePersonality in init
    • Add personality communication to model switching logic
    • Connect personality to scaling events
  2. Enhance Model Switching with Personality:

    • Use personality for capability downgrade notifications
    • Send personality messages for significant resource constraints
    • Provide optional technical tips for optimization
    • Maintain silent switching for upgrades (per Phase 1 decisions)
  3. Add Resource Constraint Communication:

    • Generate personality messages when significantly constrained
    • Offer helpful suggestions with personality flair
    • Include optional technical details for interested users
    • Track user response patterns for future improvements
  4. Context-Aware Communication:

    • Consider conversation context when deciding message tone
    • Adjust personality intensity based on interaction history
    • Provide technical tips only when appropriate
    • Balance engagement with usefulness
  5. Integration Points:

    • Connect to ProactiveScaler for scaling event notifications
    • Use ResourceMonitor metrics for constraint detection
    • Leverage HardwareTierDetector for tier-appropriate suggestions
    • Maintain conversation context through personality interactions
  6. Message Delivery:

    • Return personality messages alongside regular responses
    • Separate personality messages from core functionality
    • Allow users to disable personality if desired
    • Log personality interactions for analysis

Ensure personality enhances rather than interferes with core functionality, and maintains the helpful technical guidance expected from a mentor-like figure. python -c "from src.models.model_manager import ModelManager; mm = ModelManager(); print('Personality integrated:', hasattr(mm, '_personality'))" confirms personality integration ModelManager integrates personality communication for engaging resource discussions

Test personality communication across different scenarios: - Resource constraints with appropriate personality expressions - Capability downgrades with tsun-heavy notices - Resource improvements with subtle dere moments - Technical tips that balance simplicity with useful information

Verify personality maintains consistency, enhances user engagement without being overwhelming, and provides genuinely helpful guidance.

<success_criteria> ResourcePersonality successfully implements the Drowsy Dere-Tsun Onee-san Hex-Mentor Gremlin persona with appropriate emotional range, context-aware communication, and helpful technical guidance that enhances user engagement with resource management. </success_criteria>

After completion, create `.planning/phases/03-resource-management/03-04-SUMMARY.md`