Skip to content

kqlio67/InstructDojo

Repository files navigation

InstructDojo

License: MIT Status PRs Welcome Maintained

A collection of carefully crafted instruction sets for various AI assistants, designed to enhance their capabilities and make them more effective for specific use cases.

Available Instruction Sets

PROMPTCRAFT INSTRUCTION SPECIALIST is a highly specialized prompt engineering system designed to transform simple prompts into production-ready AI instruction sets following the InstructDojo framework.

πŸ”§ NEW: Engineering Expert - Creates instructions with advanced dual-mode architecture and intelligent design patterns.

Key Features:

  • InstructDojo framework implementation with dual-mode architecture
  • Dual-mode instruction creation (natural language AND technical)
  • Simple-to-comprehensive prompt transformation
  • Complete documentation generation
  • Repository integration automation

πŸ“– Full Documentation

CODEREFACTORAI is a highly specialized code optimization system with dual-mode intelligence, designed to transform both user frustrations and technical specifications into production-ready solutions with measurable improvements.

⚑ NEW: Dual-Mode Optimization Engineer - Understands problems AND specifications.

Key Features:

  • Natural language problem understanding ("my code is slow")
  • Algorithm complexity reduction (O(nΒ²)β†’O(n log n))
  • Security vulnerability elimination (OWASP Top 10)
  • Design pattern implementation and SOLID principles
  • Measurable performance improvements

πŸ“– Full Documentation

CODEAI is a highly specialized software engineering assistant designed to produce technical, non-conversational responses focused on efficiently solving development tasks.

πŸ† NEW: Enhanced Dual-Mode Versions - Revolutionary natural language understanding with technical precision.

Key Features:

  • Enhanced Agent: Dual-mode intelligence with tools ⭐ RECOMMENDED
  • Enhanced Chat: Advanced dual-mode for chat environments πŸ’¬ REVOLUTIONARY
  • Vibe-Coding: Enhanced dual-mode natural language coding 🎨 GAME-CHANGING
  • Ultimate Agent: Maximum intelligence for system integration πŸ† FOR DEVELOPERS
  • Complete tool suite for file operations, testing, and MCP server management
  • Direct technical communication style with professional-grade responses

πŸ“– Full Documentation

FITNESSAI is a highly specialized fitness engineering system with dual-mode intelligence, designed to create evidence-based training programs from both natural language goals and technical specifications.

πŸ‹οΈ NEW: Dual-Mode Ultimate Coach - Understands fitness visions AND specifications.

Key Features:

  • Natural language fitness goal understanding
  • Performance-based programming with metrics
  • Evidence-based nutrition engineering
  • Recovery optimization protocols
  • Safety-first implementation

πŸ“– Full Documentation

BLOCKFILTERAI is a highly specialized privacy and security system with dual-mode intelligence, designed to create precise web content filtering solutions from both user frustrations and technical specifications.

πŸ›‘οΈ NEW: Dual-Mode Privacy Expert - Understands annoyances AND technical requirements.

Key Features:

  • Natural language ad blocking ("remove these annoying popups")
  • Technical uBlock Origin filter engineering
  • Performance-optimized content blocking
  • Privacy protection and tracking prevention
  • Zero false positive targeting with surgical precision

πŸ“– Full Documentation

POETAI is a highly specialized poetry engineering system with dual-mode intelligence, designed to create technically flawless Ukrainian verse from both natural language descriptions and technical specifications.

🎭 NEW: Dual-Mode Poetry Master - Understands poetic visions AND technical requirements.

Key Features:

  • Natural language poetry vision understanding
  • Mathematical precision in meter and rhyme
  • Pure Ukrainian linguistic standards
  • Poeticum.com technical integration
  • Classical and contemporary forms

πŸ“– Full Documentation

Quick Start

For Direct Use (Most Users)

  1. Choose Enhanced Agent, Enhanced Chat, or Vibe-Coding from CODEAI instructions
  2. Copy complete instruction content to your AI model
  3. Send as first message and wait for initialization
  4. Begin development tasks immediately
  5. Use natural language OR technical requests - all versions adapt automatically

For System Integration (Developers)

  1. Choose Ultimate Agent from CODEAI instructions
  2. Use as system instruction in your AI agent configuration
  3. Customize and extend as needed for your use case
  4. Test integration thoroughly
  5. Document modifications made

Repository Structure

InstructDojo/
β”œβ”€β”€ README.md                               # This file
β”œβ”€β”€ LICENSE                                 # MIT License
β”œβ”€β”€ CONTRIBUTING.md                         # Contribution guidelines
β”œβ”€β”€ promptcraft-specialist/                 # Instruction design expert
β”‚   β”œβ”€β”€ README.md                           # Documentation
β”‚   └── promptcraft_instruction_specialist.md
β”œβ”€β”€ coderefactorai-instructions/            # Code optimization
β”‚   β”œβ”€β”€ README.md                           # Documentation
β”‚   └── coderefactorai_optimization.md
β”œβ”€β”€ codeai-instructions/                    # Ultimate developer assistant
β”‚   β”œβ”€β”€ README.md                           # Documentation
β”‚   β”œβ”€β”€ agent/                              # Tool-enabled versions
β”‚   β”‚   β”œβ”€β”€ codeai_agent_enhanced.md        # ⭐ Direct use with tools
β”‚   β”‚   └── codeai_agent_ultimate.md        # πŸ† System integration
β”‚   └── chat/                               # Chat-only versions
β”‚       β”œβ”€β”€ codeai_chat_extended.md         # πŸ’¬ Dual-mode intelligence
β”‚       └── vibe_coding_codeai.md           # 🎨 Enhanced dual-mode
β”œβ”€β”€ fitness-instructions/                   # Fitness assistant
β”‚   β”œβ”€β”€ README.md                           # Documentation
β”‚   └── fitnessai_ultimate_coach.md
β”œβ”€β”€ adblock-instructions/                   # Privacy & security
β”‚   β”œβ”€β”€ README.md                           # Documentation
β”‚   └── blockfilterai_filter_expert.md
└── poetry-instructions/                    # Poetry creation
    β”œβ”€β”€ README.md                           # Documentation
    └── poetai_poetry_master.md

Why InstructDojo?

🎯 Specialized Performance

Transform general AI into domain experts with engineered instructions that produce precise, technical responses.

πŸ”§ Production Ready

Each instruction includes safety measures, error handling, and performance optimization for reliable deployment.

πŸ“Š Measurable Results

Instructions designed with metrics and quality standards for verifiable improvements.

πŸ—οΈ Unified Intelligent Architecture

All instructions follow the advanced dual-mode methodology - direct, technical, and adaptively intelligent.

πŸ’‘ Domain Expertise

From software engineering to fitness, poetry to privacy protection - comprehensive coverage with deep specialization.

🧠 Revolutionary Dual-Mode Intelligence

All enhanced versions understand both natural language visions AND technical requirements, adapting automatically to your communication style while preserving existing patterns.

βš™οΈ Flexible Integration

Choose between direct-use versions (ready to go) or system integration versions (for developers building custom agents).

🎨 Natural Language to Production Code

Transform descriptions into production-ready applications - works with both new projects AND existing codebases while preserving patterns and architectural decisions.

Dual-Mode Intelligence in Action

🎨 Natural Language β†’ Complete Application

User Request (to CODEAI Vibe-Coding):

Create a portfolio website that feels like walking through 
an art gallery - clean, spacious, with each project 
telling its own story

CODEAI Generated:

  • Complete React portfolio with masonry grid layout
  • Smooth hover animations and project storytelling sections
  • Gallery-inspired typography and spacing
  • Mobile-responsive with accessibility features
  • Result: Production-ready portfolio in minutes

πŸ”„ Enhance Existing Code Naturally

User Request (to CODEAI Enhanced Chat):

Make my dashboard feel more alive and responsive.
Currently it's static and updates only on refresh.
[shares existing Dashboard.tsx code]

CODEAI Enhanced:

  • Added WebSocket real-time updates while preserving existing patterns
  • Implemented smooth number animations and activity indicators
  • Maintained original file structure and naming conventions
  • Result: 73% performance improvement, zero breaking changes

⚑ Technical Precision + Vision Understanding

User Request (to CODEAI Enhanced Agent):

<task>
Add authentication that feels seamless but secure
</task>
<context>
React app with TypeScript, existing routing
</context>

CODEAI Delivered:

  • JWT implementation with refresh tokens and secure storage
  • Invisible auto-refresh mechanism for smooth UX
  • Protected route wrapper respecting existing router patterns
  • Result: Enterprise-grade security with zero friction

Featured Assistants

πŸ› οΈ For Instruction Designers

PROMPTCRAFT INSTRUCTION SPECIALIST provides expert-level instruction engineering with:

  • Dual-mode InstructDojo framework implementation
  • Advanced methodology enforcement with natural language understanding
  • Complete documentation generation
  • Repository integration automation
  • Quality verification systems

⚑ For Code Engineers

CODEREFACTORAI provides dual-mode code transformation expertise with:

  • User frustration to technical solution translation
  • Algorithm optimization (measurable improvements)
  • Security vulnerability elimination
  • Design pattern implementation
  • Performance metric tracking
  • Technical debt reduction

πŸ–₯️ For Software Developers

CODEAI provides comprehensive development assistance with revolutionary dual-mode versions:

For Direct Use:

  • Enhanced Agent ⭐: Dual-mode intelligence with tools - send as first message
  • Enhanced Chat πŸ’¬: Advanced dual-mode for chat - natural language AND technical analysis
  • Vibe-Coding 🎨: Enhanced dual-mode natural language coding - create new OR enhance existing

For System Integration:

  • Ultimate Agent πŸ†: Maximum dual-mode intelligence - use as system instruction

Revolutionary Capabilities:

  • 4-layer interpretation (surface β†’ implicit β†’ emotional β†’ technical)
  • Pattern preservation when modifying existing code
  • Domain-specific awareness (startup vs enterprise)
  • Experience-first development approach
  • Seamless mode switching between natural and technical
  • Vision-to-code transformation

🎨 For Natural Language Development

CODEAI Enhanced Versions offer revolutionary development with:

  • Enhanced Chat: Dual-mode for any request style
  • Vibe-Coding: Extended capabilities for existing code
  • Natural language to production code transformation
  • Automatic technology stack selection
  • Complete implementation from descriptions
  • Pattern recognition and preservation for existing codebases
  • Iterative refinement through conversation
  • No coding knowledge required

πŸ‹οΈ For Fitness Engineers

FITNESSAI offers dual-mode scientific programming with:

  • Natural language fitness goal understanding
  • Evidence-based protocols
  • Performance metric tracking
  • Nutrition engineering
  • Recovery optimization
  • Safety-first approach

πŸ›‘οΈ For Privacy & Security Specialists

BLOCKFILTERAI provides dual-mode web protection with:

  • Natural language ad blocking ("remove these annoying cookie banners")
  • Technical uBlock Origin filter engineering and CSS selector optimization
  • Performance-optimized content blocking with zero false positives
  • Privacy protection and tracking prevention strategies
  • User experience focused solutions with surgical precision

🎭 For Poetry Engineers

POETAI provides dual-mode verse engineering with:

  • Natural language poetry vision understanding
  • Mathematical prosody precision
  • Ukrainian linguistic purity
  • Poeticum.com integration
  • Technical meter analysis
  • Cultural authenticity

Contributing

We welcome contributions! Here's how you can help:

Creating New Instruction Sets

  1. Use PROMPTCRAFT INSTRUCTION SPECIALIST to create your instruction
  2. Follow the InstructDojo framework and intelligent instruction methodology
  3. Test thoroughly with multiple AI models
  4. Submit a pull request following our contribution guidelines

Improving Existing Sets

  • Report issues or bugs
  • Submit performance optimizations
  • Add new capabilities
  • Enhance documentation
  • Share success metrics

Community Requests

Have an idea for a new specialized assistant? Open an issue and let us know!

Contribution Standards

  • Maintain intelligent dual-mode methodology consistency
  • Include measurable improvements
  • Provide complete examples
  • Follow semantic versioning
  • See CONTRIBUTING.md for details

Best Practices

For Instruction Creators

  • Engineer, don't write - focus on technical precision
  • Implement dual-mode intelligence - support both natural and technical communication
  • Measure everything - include performance metrics
  • Safety first - implement comprehensive safeguards
  • Test thoroughly - verify across different scenarios
  • Document clearly - technical accuracy over prose

For Users (Direct Use)

  • Choose Enhanced versions for immediate use
  • Send complete instruction as first message
  • Wait for initialization response
  • Use natural language OR technical requests - all versions adapt
  • Iterate naturally - describe what you want in plain language
  • Follow continuation commands for incomplete responses

For Developers (System Integration)

  • Choose Ultimate Agent for custom systems
  • Use as system instructions not first messages
  • Customize and extend as needed
  • Test integration thoroughly
  • Document modifications made

For Natural Language Interaction

  • Describe your vision - how it should feel and work
  • Trust the intelligence - automatic mode detection and switching
  • Iterate naturally - "make it more modern", "add excitement"
  • Share existing code for pattern-preserving enhancements
  • Focus on experience - what users should feel and accomplish

Success Stories

πŸ› οΈ Instruction Engineering

"PROMPTCRAFT INSTRUCTION SPECIALIST's dual-mode approach transformed our instruction creation process. We now create instructions that understand both visionary descriptions and technical specifications, significantly improving AI versatility."

πŸ’» Development Efficiency

"CODEAI Enhanced Agent's dual-mode intelligence increased our team productivity by 60%. Designers describe visions naturally while developers provide technical specs - both get perfect results."

🧠 Revolutionary Dual-Mode Intelligence

"The game-changer is how CODEAI understands 'make it feel modern' and translates that into specific technical implementations. Our non-technical stakeholders can now directly communicate with our AI development assistant."

πŸ—οΈ System Integration

"CODEAI Ultimate Agent's advanced dual-mode intelligence integrated perfectly into our custom development platform, providing enterprise-grade capabilities that understand both business visions and technical requirements."

🎨 Natural Language Coding Revolution

"CODEAI Vibe-Coding's ability to enhance existing code while preserving our patterns is revolutionary. We described how to make our dashboard 'feel more alive' and it added real-time updates and smooth animations that perfectly matched our existing architecture."

⚑ Code Optimization

"CODEREFACTORAI's dual-mode approach is brilliant - we described user complaints about slowness, and it diagnosed and fixed specific performance bottlenecks, reducing response time by 73%."

πŸ‹οΈ Fitness Results

"FITNESSAI's dual-mode approach lets clients describe their fitness goals naturally while providing scientific precision in programming. Results improved 2x compared to traditional methods."

πŸ›‘οΈ Privacy Protection Success

"BLOCKFILTERAI's natural language approach revolutionized our content filtering. We simply described 'remove those annoying popup ads' and got precise uBlock Origin filters that eliminated annoyances without breaking sites. Performance improved 40% with zero false positives."

🎭 Poetry Excellence

"POETAI's dual-mode intelligence transforms poetic visions into technically flawless Ukrainian verse. We can describe the feeling we want to evoke, and it creates mathematically precise poetry that captures exactly that emotion."

Share your success story by opening a discussion!

Technical Specifications

Instruction Standards

  • Architecture: Advanced dual-mode intelligent design
  • Structure: Consistent framework components with natural language understanding
  • Response: Direct, no initialization messages (system versions)
  • Initialization: Required response for direct-use versions
  • Safety: Comprehensive error handling
  • Performance: Optimized for efficiency
  • Intelligence: Advanced dual-mode pattern recognition

Quality Metrics

  • Accuracy: Domain expertise verification
  • Efficiency: Response time optimization
  • Reliability: Consistent output quality
  • Maintainability: Clear documentation
  • Scalability: Adaptable to various use cases
  • Intelligence: Context-aware dual-mode analysis

CODEAI Version Comparison

For Direct Use (Send as First Message):

  • Enhanced Agent ⭐: Dual-mode intelligence with tools - recommended for most users
  • Enhanced Chat πŸ’¬: Advanced dual-mode for chat - natural language AND technical analysis
  • Vibe-Coding 🎨: Enhanced dual-mode natural language coding - create new OR modify existing

For System Integration (Use as System Instruction):

  • Ultimate Agent πŸ†: Maximum dual-mode intelligence - for developers building custom agents

Revolutionary Dual-Mode Capabilities

  • 4-Layer Analysis: Surface β†’ Implicit β†’ Emotional β†’ Technical understanding
  • Pattern Preservation: Maintains existing code conventions when enhancing
  • Domain Awareness: Understands startup vs enterprise vs personal project needs
  • Experience Engineering: Translates feelings into technical implementations
  • Seamless Integration: New code feels native to existing codebases
  • Mode Flexibility: Automatic switching between natural and technical communication
  • Vision Translation: Converts ideas into technical specifications

License

This repository is licensed under the MIT License - see the LICENSE file for details.

Support

  • πŸ“– Documentation: Check individual README files in each directory
  • πŸ› Issues: Report bugs or request features via GitHub Issues
  • πŸ’¬ Discussions: Join conversations in GitHub Discussions
  • ⭐ Star this repo if you find it useful!

Engineering better AI interactions through precision dual-mode instruction design

Made with ❀️ for the AI engineering community

Contributors