BMAD-METHOD/bmad-core/tasks
James (Claude Code) 6e97ddcbd1 feat: Implement Gemini's universal environment-adaptive solution with .bmad_env state file
Collaborative solution with Gemini to resolve bash approval prompts by shifting from
shell conditionals to agent guidance with persistent state management.

## Key Changes Based on Gemini's Analysis

### 1. Universal State Persistence (.bmad_env file)
- Updated lightweight-ide-detection.md to write IDE environment vars to .bmad_env
- Updated auto-language-init.md to append language environment vars to .bmad_env
- Each Bash tool call can now 'source .bmad_env' to load persistent state
- Supports all IDEs: Claude Code CLI, Cursor AI, Windsurf, Cline, Roo, Trae, Gemini, GitHub Copilot, CLI

### 2. Agent Guidance vs Shell Conditionals
- Restructured reality-audit-comprehensive.md Phase 2 from shell conditionals to agent instructions
- Replaced shell logic with clear procedural guidance for agents
- Task files now provide instructions FOR agents rather than literal bash scripts to execute

### 3. Universal Dev Agent Adaptive Tool Selection
- Added adaptive_tool_selection section to dev.md agent configuration
- Core directive: environment-adaptive tool selection based on detected IDE and language
- Universal compatibility: detects and optimizes for any supported IDE environment
- Language agnostic: supports C#, TypeScript, JavaScript, Java, Rust, Go, Python, Ruby, PHP

### 4. Environment Context Loading Pattern
- All environment-dependent operations start with 'source .bmad_env'
- Agent instructions specify when to use native vs CLI tools based on loaded environment
- Eliminates stateless environment variable issues across separate Bash tool calls
- Universal approach works across all IDE environments automatically

## Expected Results
- No more bash approval prompts in Claude Code CLI environments
- Native tool optimization in Cursor AI, Windsurf, and other supported IDEs
- Agents load environment state and make conscious tool selection decisions
- Graceful fallback to CLI batch mode when appropriate
- Universal language and IDE compatibility

## Collaboration Credit
This solution resulted from collaborative analysis with Gemini AI, identifying that
agents were interpreting shell conditionals as literal commands rather than guidance.

Key insight: shift from 'execute this shell logic' to 'read the state and decide what to do'.
2025-07-24 08:49:20 -04:00
..
advanced-elicitation.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
auto-language-init.md feat: Implement Gemini's universal environment-adaptive solution with .bmad_env state file 2025-07-24 08:49:20 -04:00
brownfield-create-epic.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
brownfield-create-story.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
build-context-analysis.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
context-aware-execution.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
correct-course.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
create-brownfield-story.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
create-deep-research-prompt.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
create-doc.md feat: Complete dev.md agent restoration with full quality framework integration 2025-07-24 00:01:51 -04:00
create-next-story.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
create-remediation-story.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
document-project.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
execute-checklist.md feat: Complete dev.md agent restoration with full quality framework integration 2025-07-24 00:01:51 -04:00
facilitate-brainstorming-session.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
generate-ai-frontend-prompt.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
incremental-story-mapping.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
index-docs.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
kb-mode-interaction.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
lightweight-ide-detection.md feat: Implement Gemini's universal environment-adaptive solution with .bmad_env state file 2025-07-24 08:49:20 -04:00
lightweight-reality-audit.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
loop-detection-escalation.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
reality-audit-comprehensive.md feat: Implement Gemini's universal environment-adaptive solution with .bmad_env state file 2025-07-24 08:49:20 -04:00
review-story.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00
shard-doc.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
smart-build-context.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
story-to-code-audit.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
tiered-remediation.md feat: Implement universal environment-adaptive detection across BMAD tasks 2025-07-24 07:56:50 -04:00
validate-next-story.md fix: Add all missing files from quality-framework-enhancements branch 2025-07-23 20:59:37 -04:00