Ask & Agent Modes

Documentation Coming Soon

This dual-mode system helps developers create more maintainable, accurate code while reducing iteration time.

Ask Mode: Inquire First

Ask mode is where you and Gamecraft Agent explore what you're trying to build and determine the optimal approach. In this mode, Gamecraft Agent:

• Can analyze your entire codebase to understand the context

• Won't make any modifications to your files

• Focuses on understanding requirements and developing a strategy

• Helps identify potential challenges before you write a single line of code

Agent Mode: Execute It

Once you've established a clear understanding, you switch to Agent mode. Now Gamecraft Agent:

• Has all the development capabilities at its disposal

• Can make modifications to your codebase

• Retains all context from your inquiry session

• Implements the strategy you developed together

Workflow Guide

When working on a new feature or resolving a complex bug, here's one effective strategy:

1. Begin in Ask mode and describe what you want to build with Gamecraft Agent

2. Gamecraft Agent helps you explore the codebase, examining relevant files

3. Together you and Gamecraft Agent determine the best approach, considering edge cases and potential challenges

4. When you're confident in you and the agent's understanding, switch to Agent mode

5. Gamecraft Agent implements the solution based on our inquiry and analysis

1. Start with Ask Mode

Begin every significant development task in Ask mode:

In this mode:

• Share your requirements

• Let Gamecraft Agent analyze relevant files

• Engage in dialogue to clarify objectives

• Develop implementation strategy

2. Switch to Agent Mode

Once you have a clear understanding, switch to Agent mode:

Agent mode allows Gamecraft Agent to:

• Execute against the agreed approach

• Make modifications to your codebase

• Maintain context from inquiry phase

3. Iterate as Needed

Complex projects often require multiple ask-agent cycles:

• Return to Ask mode when encountering unexpected complexity

• Use Agent mode for implementing solutions

• Maintain development momentum while ensuring quality

Best Practices

Inquiry Phase

1. Be comprehensive with requirements

2. Share relevant context upfront

3. Point Gamecraft Agent to relevant files if it hasn't read them

4. Validate approach before implementation

Implementation Phase

1. Follow the established approach

2. Monitor progress against objectives

3. Track modifications and their impact

4. Document significant decisions

Power User Tips

Enhancing Inquiry

• Use Ask mode to explore edge cases before implementation

• Switch back to Ask when encountering unexpected complexity

• Leverage file reading to validate assumptions early

• Have Gamecraft Agent write markdown files of the approach for future reference

Common Patterns

When to Use Each Mode

Ask mode can work best when:

• Starting something new where the approach isn't obvious

• Debugging a tricky issue where you're not sure what's wrong

• Making architectural decisions that will affect multiple parts of the codebase

• Trying to understand a complex workflow or feature

Agent mode is perfect for:

• Implementing a solution you've already explored (with the agent)

• Making routine modifications where the approach is clear

• Following established patterns in the codebase

• Running tests and making minor adjustments

Contributing

Share your experiences and improvements:

• Join our Discord community

• Participate in discussions

• Submit feature requests

• Report issues

---

Remember: The time invested in inquiry pays dividends in implementation quality and maintenance efficiency.