Turn document · 2026-05-19 08:05 America/New_York

# 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 `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`.