This document provides instructions for AI agents modifying or working within this repository.
When modifying setup scripts, configuration files, or environment configurations, you must verify that your changes are fully idempotent.
- Constraint Validation: Verify that your changes satisfy all technical idempotency invariants defined in ARCHITECTURE.md.
- Execution Test: Run the bootstrap scripts (
bootstrap.shorbootstrap.batdepending on the platform) multiple times in succession to verify no errors occur. - Sourcing Test: Source shell configuration files (e.g.,
bashrc) multiple times in a single session to verify that environment variables (likePATH) remain stable and do not accumulate duplicate entries.