## Description

<!-- Provide a clear description of the specification changes -->

## Type of Change

<!-- Mark the relevant option with an "x" -->

- [ ] Specification clarification (no functional change)
- [ ] New optional field or feature
- [ ] Schema update
- [ ] Example addition or improvement
- [ ] Documentation improvement
- [ ] Breaking change (requires version bump)

## Related Issue/Discussion

<!-- Link to the related issue or discussion -->

Fixes #(issue number)
or
Discussion: [link to discussion]

## Specification Changes

<!-- List specific changes to the format specification -->

**Files modified**:
- 
- 

**Changes made**:
- 
- 

## Backward Compatibility

<!-- Critical: How does this affect existing .faf files? -->

- [ ] Fully backward compatible
- [ ] Requires migration (explain below)
- [ ] Breaking change (justify below)

**Compatibility analysis**:


## Validation

<!-- Demonstrate the changes work correctly -->

### Example .faf File

```yaml
# Paste an example .faf file demonstrating the change
---
faf_version: "1.0"
# ... your example
```

### Schema Validation

- [ ] Schema updated if needed
- [ ] Example validates against schema
- [ ] Existing examples still validate

### Tool Compatibility

Tested with:
- [ ] faf-cli (version: )
- [ ] claude-faf-mcp (version: )
- [ ] Other implementations (specify):

## Implementation Impact

<!-- Which tools/implementations need updates? -->

**Required updates**:
- [ ] faf-cli
- [ ] claude-faf-mcp
- [ ] Chrome Extension
- [ ] Documentation
- [ ] Other:

## IANA Considerations

<!-- Does this affect the IANA registration? -->

- [ ] No IANA impact
- [ ] IANA update required (explain):

## Migration Path

<!-- If this is a breaking change, how do users upgrade? -->

**For breaking changes only**:


## Documentation

<!-- What documentation changes are included? -->

- [ ] Specification text updated
- [ ] Examples added/updated
- [ ] CHANGELOG.md entry added
- [ ] Migration guide included (if breaking)
- [ ] Best practices updated

## Community Feedback

<!-- Summarize discussion feedback if applicable -->

**Discussion summary**:


## Checklist

<!-- Verify all items before submitting -->

- [ ] Follows specification writing standards (RFC 2119 keywords)
- [ ] Backward compatibility analyzed
- [ ] Examples provided and validated
- [ ] Schema updated if needed
- [ ] Documentation complete
- [ ] CHANGELOG.md updated
- [ ] Breaking changes justified
- [ ] Migration path documented (if breaking)
- [ ] Community discussion completed (for major changes)

## Additional Context

<!-- Add any other relevant information -->

---

**For Maintainers**

- [ ] Specification review completed
- [ ] Backward compatibility verified
- [ ] Implementation coordination planned
- [ ] IANA considerations addressed
- [ ] Ready to merge
