Vardchives

Agent Instructions ​

Keep shared instructions in .ai/guidelines/ and accumulated lessons in SELF-LEARNING.md. Let Boost generate AGENTS.md and CLAUDE.md.

Add Self-learning Instructions ​

bash
mkdir -p .ai/guidelines
touch .ai/guidelines/self-learning.md
touch SELF-LEARNING.md

File: .ai/guidelines/self-learning.md

markdown
## Self-learning

Read `SELF-LEARNING.md` before starting work and follow every rule in it.

When I correct you, or you catch yourself making a mistake, append the lesson to that file **before continuing** — one line, imperative, generalized past the specific case:

`- <do this> — <what it prevents>`

Only for mistakes that would repeat. Skip one-offs, and anything lint, types, or this file already enforce. If an existing rule nearly covers it, sharpen that line instead of adding another.

Apply the Guidelines ​

Remove any old manually appended self-learning blocks from AGENTS.md and CLAUDE.md before regenerating. boost:update reuses the agents set in step 01 without prompting. Rerun it after later edits to .ai/guidelines/self-learning.md; never edit the generated copies.

bash
php artisan boost:update

Verify ​

Check that each generated file contains the self-learning block once and that existing project instructions remain intact:

bash
rg -n '^## Self-learning$' AGENTS.md CLAUDE.md

Keep the source guideline, generated instructions, and SELF-LEARNING.md tracked in Git.

Commit ​

bash
git add -A
git commit -m '02 - Agent Instructions'

References ​