Skip to content

[Feature Request] Add Mandatory Pre-commit Cleanup and Screenshot Storage Rules to Standard Workflow #29

@pigochu

Description

@pigochu

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) via chrome-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
*.webp

3. 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_screenshot MUST 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions