From 8945522b068fe51ee5c010ae48f7cb02e069bc96 Mon Sep 17 00:00:00 2001 From: David Poblador i Garcia Date: Mon, 9 Feb 2026 09:58:15 +0100 Subject: [PATCH 1/2] fix: add pre-flight check rule to prevent edits in main/ Closes #35 Co-Authored-By: Claude Opus 4.6 --- template/AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/template/AGENTS.md b/template/AGENTS.md index 4f0709b..00802e2 100644 --- a/template/AGENTS.md +++ b/template/AGENTS.md @@ -25,6 +25,9 @@ This project uses a **bare repo + worktree** structure. Read this before making is correct. Always `cd` into a worktree to do git operations on that branch. 4. **Files at the project root** (outside worktrees) are not tracked by git. The `justfile`, `AGENTS.md`, and config directories live here intentionally. +5. **Before editing ANY file**, verify you are in a feature worktree directory, not `main/`. + If no feature worktree exists for your current task, create one with `just wt-add ` + before making any changes. ## Developing with worktrees From 29429ffe3ce4533789595c97b172b045088ce95c Mon Sep 17 00:00:00 2001 From: David Poblador i Garcia Date: Mon, 9 Feb 2026 10:06:44 +0100 Subject: [PATCH 2/2] docs: add section encouraging agents to file issues for unclear instructions Co-Authored-By: Claude Opus 4.6 --- template/AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/template/AGENTS.md b/template/AGENTS.md index 00802e2..74c4a61 100644 --- a/template/AGENTS.md +++ b/template/AGENTS.md @@ -166,3 +166,8 @@ chore: bump FastAPI dependency Each worktree has its own `.gitignore`. Use `.git/info/exclude` for patterns that should apply across all worktrees. + +## Improving these instructions + +If anything in this document is unclear, incomplete, or caused you to make a mistake, +file an issue at https://github.com/alltuner/projectuner so we can fix it.