Add Aegis contracts failing CI response guide

[El-swaggerito]

Description

Difficulty: Hard

Type: Documentation

Summary

Create guidance for handling failing Aegis contract CI checks.

Current Behaviour

Some PRs may include tests but still have failing checks.

Expected Behaviour

The contracts repo should explain how to reproduce and fix Rust, Soroban, Makefile, dependency, and workflow failures.

Suggested Implementation

Document common failures and commands.

Files or Areas Likely Affected

• docs/
• README.md
• .github/
• Makefile

Acceptance Criteria

• Guide explains failing CI can affect approval.
• Rust failures are covered.
• Soroban failures are covered.
• Makefile issues are covered.
• Local commands are included.
• README links to guide.

Additional Notes

This addresses failing checks.

[deepak0x]

Hi, I'd like to take this one. I'm comfortable with the area this issue touches. I'll review the current code, implement the change to meet the acceptance criteria, add tests for the success and failure paths, and link the PR with Closes #ISSUE. Could you assign it to me?

[grantfox-oss]

🦊 GrantFox — @deepak0x has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #100)
2. Your PR will be reviewed by the Axionvera maintainers

Good luck! Track your progress on GrantFox.

[El-swaggerito]

Assigned to @deepak0x. Please follow the acceptance criteria and submit a clean PR linked to this issue.