Update AGENTS.md

[PolarBearEs]

No description provided.

[greptile-apps]

Greptile Summary

This PR adds a "Design Guidelines" section to AGENTS.md, establishing engineering principles for AI agents working in this repository. The guidelines focus on resilience for slow or constrained networks and correct cache behavior.

• Timeout philosophy: Instructs agents to prefer idle/progress timeouts over absolute timeouts for blob transfers and streaming paths, preventing spurious failures on slow networks.
• Cache coordination: Calls out deduplication, resumability, and cache integrity concerns for concurrent layer fetches.
• Documentation requirement: Asks that any new limits, concurrency controls, or timeouts include rationale and justification for defaults in slow environments.

Confidence Score: 5/5

Documentation-only change; no executable code is modified.

The change adds five well-scoped design principles to the agent guidance file. The guidelines are internally consistent, clearly written, and directly applicable to a container registry tool that handles blob streaming over unreliable networks. Nothing is removed or contradicted in the existing Before Commit or Commit History sections.

No files require special attention.

Important Files Changed

Filename	Overview
AGENTS.md	Adds a new "Design Guidelines" section with five bullet points covering timeout philosophy, cache coordination, flaky-network resilience, and documentation expectations for limits and concurrency controls.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Agent starts task] --> B{Network / blob operation?}
    B -- Yes --> C[Use idle/progress timeout\nnot total-duration timeout]
    B -- No --> D[Proceed normally]
    C --> E{Cache layer requested?}
    E -- Already in progress --> F[Deduplicate: wait / join\nexisting fetch]
    E -- Not in progress --> G[Start fetch with\nresumability support]
    F --> H[Verify cache integrity]
    G --> H
    H --> I{Failure / partial progress?}
    I -- Yes --> J[Retry with backoff\npreserve partial progress]
    I -- No --> K[Complete operation]
    J --> C
    K --> L[Document any new limits\nor concurrency controls\nadded along this path]

Loading

_{Reviews (1): Last reviewed commit: "Update AGENTS.md" | Re-trigger Greptile}