# Improvement Proposal Template

## Proposal ID

EVOLVE-YYYYMMDD-001

## Scope

local-only | project-only | upstream-candidate

## Source Project

Project or repository name

## File To Update

- `./.ai/path/to/file.md`

## Current Problem

Describe the gap, repeated mistake, outdated rule, or missing instruction.

## Evidence

Describe where this was learned.

## Proposed Change

Provide the exact Markdown section to add, remove, or revise.

## Why This Generalizes

Explain why this should stay local, remain project-specific, or be promoted to the reusable boilerplate.

## Benefit

Explain how this improves future agent performance.

## Risk

Explain what could go wrong.

## Rollback Plan

Explain how to undo the change.

## Validation

Explain how the change will be validated in future work.

## Product Owner Approval

Pending | Approved | Rejected

## Promotion Decision

Keep local | Keep project-only | Promote upstream | Rejected

## Applied Date

YYYY-MM-DD

## Baseline Version Impact

None | Patch | Minor | Major