-
Notifications
You must be signed in to change notification settings - Fork 121
Description
Problem Description
During the execution of tracks using AI agents (e.g., via /conductor:implement), agents frequently generate temporary artifacts for verification and debugging, such as:
- Build logs (
debug.log,build.log,npm-debug.log). - UI verification screenshots (
*.png,*.jpg,*.webp) viachrome-devtools-mcp.
Without explicit rules, AI agents tend to use git add . or git add -u, leading to these temporary files being accidentally committed into the repository history. This causes repository bloat and potential disclosure of local environment information (like absolute file paths in logs).
Proposed Solution
1. Update workflow.md Template
Add a mandatory "Pre-commit Cleanup & Verification" step in both Standard Task Workflow and Phase Completion Protocol.
Requirement:
AI agents MUST physically delete all temporary logs and screenshots and execute git status to verify a clean working area before performing any git commit.
2. Strengthen Default .gitignore
The framework should recommend or include common debug patterns in its base .gitignore:
*.log
*.png
*.jpg
*.jpeg
*.webp3. Standardize Screenshot Storage for AI
Add a rule to the system instructions or .gemini/GEMINI.md template:
"Unless explicitly requested otherwise by the user, all screenshots generated via
take_screenshotMUST be stored in the system's temporary directory, never in the project root."
Expected Benefit
- Maintains a clean and professional repository history.
- Prevents accidental disclosure of environment-specific metadata.
- Reduces the manual effort for human developers to "clean up" after the AI agent.