Clarify Repo Turn Documentation Rules

Summary

The repo AGENTS.md now removes a stray non-repo location rule and explicitly states that impeccable is the styling and layout authority for Islandflow turn documents when available.

Changes Made

• Removed the confusing instruction to save non-repo documentation under ~/dev/docs/turns/.
• Clarified that repository turn documents stay in docs/turns/.
• Updated the format rule to say impeccable handles both structure and styling.
• Added an explicit guard against applying global non-repo computer-task house styling to this repository's turn documents.
• Clarified that the fallback standalone HTML path only applies when impeccable is unavailable or blocked by an actual error.

Context

The global agent instructions now distinguish repository implementation documentation from non-repo computer-task documentation. This repo file needed a small cleanup so it would not reintroduce ambiguity about location or styling.

Important Implementation Details

This was a documentation-only change in AGENTS.md. It changes future agent behavior but does not alter runtime code, tests, deployment scripts, or application behavior.

Relevant Diff Snippets

-## Important: If you are not working inside a git repository, save the document to `~/dev/docs/turns/`

-Use the impeccable skill to structure the document as clean, readable HTML.
+Use the `impeccable` skill to structure and style the document as clean, readable HTML.
+
+For this repository, `impeccable` is the styling and layout authority for turn documents when available. Do not apply global non-repo computer-task house styling to repository turn documents.

-If the impeccable skill is unavailable, still create a well-structured standalone HTML file with:
+If the `impeccable` skill is unavailable or blocked by an actual tool/file error, still create a well-structured standalone HTML file with:

Expected Impact for End-Users

Future Islandflow turns should produce documentation in the repo's docs/turns/ folder and let impeccable drive the visual treatment, making repo documentation less likely to inherit global computer-task styling.

Validation

• Reviewed the AGENTS.md diff after patching.
• Ran git diff --check with no whitespace errors.
• No application test suite was run because this change only updates repository instructions.

Issues, Limitations, and Mitigations

This clarification depends on future agents reading both global and repo instructions. The new wording is intentionally direct about repo scope, location, and styling to reduce that risk.

Follow-up Work

No follow-up issue is required for this patch. The related Beads task for this documentation cleanup is islandflow-lm6.