Clarify Repo Turn Documentation Rules
+
+ Updated the repository instructions so Islandflow turn documents are clearly repo-local and styled through impeccable, without inheriting global non-repo computer-task styling.
+
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
impeccablehandles 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
impeccableis 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.mddiff after patching.
+ - Ran
git diff --checkwith 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.
+