yisroelbaum/Goal-Calibration
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Goal-Calibration/AGENTS.md
Yisroel Baum b07b1e2666
add session start protocol and pre-commit checklist 
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.
2026-05-02 22:14:54 +03:00

1 KiB
Raw Blame History

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.