Problem
The pre-commit memory cross-reference hook automatically adds ## Related sections to memory index files in .serena/memories/. However, ADR-017 specifies that index files should contain ONLY table content - no additional sections.
This creates a circular validation problem:
- Developer updates memory observation file
- Pre-commit hook runs and adds
## Related section to index
- Pre-commit validation runs and fails because of the non-table content
- Developer must use
git commit --no-verify to bypass
Expected Behavior
Memory cross-reference hook should either:
- NOT add
## Related sections to index files (preferred), OR
- ADR-017 validation should allow
## Related sections in indexes
Actual Behavior
Hook adds sections that violate the validation rules enforced by the same commit process.
Impact
- Forces developers to bypass pre-commit validation with
--no-verify
- Reduces confidence in validation process
- Creates inconsistent index file formats
Reproduction
- Edit any file in
.serena/memories/ that's referenced in an index
- Run
git add and git commit
- Observe hook adds
## Related section
- Observe validation fails on the added section
Related
- ADR-017: Memory index format specification
- Pre-commit hook: Memory cross-reference automation
- Validation script:
Validate-MemoryIndex.ps1
Problem
The pre-commit memory cross-reference hook automatically adds
## Relatedsections to memory index files in.serena/memories/. However, ADR-017 specifies that index files should contain ONLY table content - no additional sections.This creates a circular validation problem:
## Relatedsection to indexgit commit --no-verifyto bypassExpected Behavior
Memory cross-reference hook should either:
## Relatedsections to index files (preferred), OR## Relatedsections in indexesActual Behavior
Hook adds sections that violate the validation rules enforced by the same commit process.
Impact
--no-verifyReproduction
.serena/memories/that's referenced in an indexgit addandgit commit## RelatedsectionRelated
Validate-MemoryIndex.ps1