---
title: Instruction File Policy
type: note
permalink: opencode-config/decisions/instruction-file-policy
tags:
- instructions
- convention
---

# Instruction File Policy

## Decision
- [decision] `AGENTS.md` is the only instruction file maintained in this repo. #convention
- [decision] Do not create or maintain mirrored instruction files or symlinks for other agent tools. #convention
- [decision] If a tool needs repo instructions, point it at `AGENTS.md` directly. #convention

## Rationale
- [lesson] Keeping a single source of truth removes cross-tool instruction maintenance overhead and avoids duplicated or stale guidance. #lesson