Skip to content
This repository was archived by the owner on Feb 24, 2026. It is now read-only.

Commit 4c621a5

Browse files
fix: add pre-flight check and issue-filing guidance to AGENTS.md (#36)
* fix: add pre-flight check rule to prevent edits in main/ Closes #35 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add section encouraging agents to file issues for unclear instructions Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 9f73aec commit 4c621a5

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

template/AGENTS.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,9 @@ This project uses a **bare repo + worktree** structure. Read this before making
2525
is correct. Always `cd` into a worktree to do git operations on that branch.
2626
4. **Files at the project root** (outside worktrees) are not tracked by git. The `justfile`,
2727
`AGENTS.md`, and config directories live here intentionally.
28+
5. **Before editing ANY file**, verify you are in a feature worktree directory, not `main/`.
29+
If no feature worktree exists for your current task, create one with `just wt-add <name>`
30+
before making any changes.
2831

2932
## Developing with worktrees
3033

@@ -163,3 +166,8 @@ chore: bump FastAPI dependency
163166

164167
Each worktree has its own `.gitignore`. Use `.git/info/exclude` for patterns that should
165168
apply across all worktrees.
169+
170+
## Improving these instructions
171+
172+
If anything in this document is unclear, incomplete, or caused you to make a mistake,
173+
file an issue at https://github.com/alltuner/projectuner so we can fix it.

0 commit comments

Comments
 (0)