AGENTS.md gains a non-negotiable session start protocol that forces reading the context files and checking the current branch before any edits. shared.md gains a pre-commit checklist covering branch/scope, code rules, mechanical checks, and commit metadata. both additions exist because this branch's history shows what happens when the rules are treated as background information rather than active checklists.
25 lines
1 KiB
Markdown
25 lines
1 KiB
Markdown
# Project context
|
|
|
|
Read these on every session. Rules in them override defaults.
|
|
|
|
@ai/shared.md
|
|
@ai/backend-context.md
|
|
@ai/frontend-context.md
|
|
|
|
## Session start protocol
|
|
|
|
Before responding to the first user message in a session, you MUST:
|
|
|
|
1. Read `ai/shared.md`, `ai/backend-context.md`, `ai/frontend-context.md` in
|
|
full. Do not skim. Do not skip on the assumption they were read in a
|
|
prior session - context is not preserved.
|
|
2. Run `git status` and `git branch --show-current`. If on `master` or
|
|
`main`, do NOT make any edits until a feature branch exists, even if
|
|
the user's first message looks like a quick read-only question. Many
|
|
"quick questions" turn into edits.
|
|
3. Confirm in your first response that the rules were read and the branch
|
|
was checked. Do not narrate the contents - just acknowledge.
|
|
|
|
Skipping this protocol caused real bugs and rework in past sessions
|
|
(work landed on master, TDD order was lost, formatter not run, banned
|
|
constructs slipped in). Treat the protocol as non-negotiable.
|