Shared agent instructions¶
This directory (.agents/) is the current shared instruction source for agents working in HDT-AF. The repository-root AGENTS.md, CLAUDE.md, Copilot instructions, and codex/ files are entry points; keep their links aligned with this directory.
Reading order¶
project-context.md: project purpose, build layout, runtime facts, and invariants.shared-rules.md: required architecture, security, and development constraints.workflow.md: backlog, documentation, validation, and commit process.review-checklist.md: final review checklist.- Root
backlog.md: planned and completed work.
Source-of-truth rule¶
Update these shared files first when project rules or architecture change. Then update entry points and technical documentation as needed. Do not create a parallel agent/ directory; the repository uses .agents/.