Keep project guides project-specific

AGENTS.md

@@ -8,6 +8,29 @@ This repository provides reusable, client-neutral guidance for FileMaker AI work
 - Read the consuming project's `PROJECT.md` before applying this guidance. Its confirmed client decisions, documented conventions, and verified current FileMaker evidence take priority over this core.
 - Preserve established legacy patterns unless a confirmed requirement deliberately changes them.
 
+## Evidence priority
+
+When sources conflict, use this order unless the project's `PROJECT.md` documents a stricter project-specific rule:
+
+1. Confirmed current client decision in the ticket or project record
+2. Verified current FileMaker behavior or current parsed DDR evidence
+3. Other confirmed project documentation
+4. An organization-specific shared standard explicitly selected by the project
+5. This FileMaker Core guidance
+
+Report meaningful conflicts instead of silently resolving them.
+
+## Standard repository map
+
+Use these locations for a workspace that follows the standard project layout. A project may document only deviations in `PROJECT.md`.
+
+- `../DDR/`: local raw FileMaker DDR input. Never copy it into the repository or commit it; move it only as part of an explicitly approved filesystem migration.
+- `TICKETS/`: one folder per ticket or workstream. Keep its source requests, handoffs, analysis, questions, reports, assets, and ticket-specific scripts together.
+- `FMSCRIPTS/`: tracked complete `.fmscript` files that are not clearly ticket-specific or apply across several workstreams.
+- `NOTES/`: confirmed knowledge and business rules that apply across more than one ticket.
+- `DDR-Parsed/`: tracked generated FileMaker reference material. Do not edit it manually.
+- `ddr-parse.sh`: run `zsh ddr-parse.sh` from the project root to parse the latest DDR into `DDR-Parsed/` when an up-to-date reference is needed.
+
 ## Select the relevant skill
 
 Read only the skill that matches the work; do not load every shared reference by default.