From d830a65f0ccbd991b7f70f3f9987998760d213f4 Mon Sep 17 00:00:00 2001 From: Martin Galik Date: Sun, 9 Aug 2026 13:36:51 +0200 Subject: [PATCH] Keep project guides project-specific --- AGENTS.md | 23 +++++++++++++++++++++++ docs/project-contract.md | 5 +++-- templates/PROJECT.md | 14 +------------- 3 files changed, 27 insertions(+), 15 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 65a05c9..c113667 100644 --- a/AGENTS.md +++ b/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. diff --git a/docs/project-contract.md b/docs/project-contract.md index 5b20c29..28a7e66 100644 --- a/docs/project-contract.md +++ b/docs/project-contract.md @@ -5,7 +5,8 @@ Every client AI workspace owns its client context. Keep the project root small, ## Instruction layout - Root `AGENTS.md`: a short, mandatory router. It tells an agent to read the local `PROJECT.md` and this Core `AGENTS.md` before work. -- `PROJECT.md`: client and project facts, local source priority, repository map, raw DDR location, and organization-specific standards. +- `PROJECT.md`: only client and project facts, organization-specific standards, and true project-specific exceptions. +- Core `AGENTS.md`: shared evidence priority, repository map, workflow, and response rules. - Core skills: task-specific procedures read only when relevant. Do not use a filesystem symlink for `PROJECT.md`; track it directly in the client repository. @@ -17,7 +18,7 @@ Do not use a filesystem symlink for `PROJECT.md`; track it directly in the clien - tickets, project notes, and approved analysis - sanitized parsed DDR - FileMaker work scripts and project-specific prompts -- the location and environment names of raw DDR exports +- project-specific raw DDR environments or any deviation from the standard repository map ## Standard workspace map diff --git a/templates/PROJECT.md b/templates/PROJECT.md index c7a9937..82b18fa 100644 --- a/templates/PROJECT.md +++ b/templates/PROJECT.md @@ -5,22 +5,10 @@ - Client: - Project: -## Local source priority - -List the evidence order for this project. Confirmed client decisions and verified current FileMaker evidence should remain above shared guidance. - -## Repository map - -- Raw DDR: `../DDR/` (local only; never commit) -- Parsed DDR: `DDR-Parsed/` -- Tickets: `TICKETS/` -- Cross-ticket notes: `NOTES/` -- Cross-ticket FileMaker scripts: `FMSCRIPTS/` - ## Additional shared standards List any organization-specific shared repository and state exactly when its skills are required. ## Project-specific rules -Add only rules that do not apply to every FileMaker project. +Add only rules or repository-layout deviations that do not apply to every FileMaker project.