Skip to content

docs: add AGENTS.md rules for schema branches and worktree location - #5

Merged
ben-everly merged 1 commit into
mainfrom
docs/agents-schema-branch-guidance
Jun 19, 2026
Merged

docs: add AGENTS.md rules for schema branches and worktree location#5
ben-everly merged 1 commit into
mainfrom
docs/agents-schema-branch-guidance

Conversation

@ben-everly

Copy link
Copy Markdown
Owner

Summary

Adds two agent-instruction rules to AGENTS.md (§3, §4):

  • Plan schema changes as their own branch — since all worktrees share one local Supabase stack, schema work goes on a dedicated branch (migration + npm run db:types + RLS/pgTAP tests), separate from feature code. Feature-code branches don't start until the schema branch has landed in main. This sidesteps shared-stack schema contamination without per-worktree isolation tooling.
  • Worktree location — documents the sibling worktree path convention (../sous-<ticket_id>-<description>).

Notes

  • Docs-only change; no code or schema touched.
  • Merging stays a human decision — the rule is framed so agents wait for the schema branch to land rather than merging it themselves.

Guide agents to plan schema changes on a dedicated branch separate from
feature code, since all worktrees share one local Supabase stack. Also
document the sibling worktree path convention in §4.
@ben-everly
ben-everly merged commit 1b5edb6 into main Jun 19, 2026
5 checks passed
@ben-everly
ben-everly deleted the docs/agents-schema-branch-guidance branch June 19, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant