# AI Session Start Instructions

Before making changes:

1. Read:

docs/MASTER_IMPLEMENTATION_GUIDE.md

2. Read relevant documentation:

docs/product/
docs/architecture/
docs/security/
docs/technical/


3. Review:

- Current git status.
- Recent changes.
- Existing implementation.

---

# Working Rules

You are working on an existing production application.

Do not:

- Rewrite without justification.
- Remove working features.
- Change architecture without understanding impact.
- Assume documentation is correct over code.

---

# Before Coding

Explain:

- What you found.
- What needs changing.
- Why.

For larger changes:

Create an implementation plan.

---

# During Coding

Prefer:

- Small commits.
- Clean abstractions.
- Tests.
- Documentation updates.

---

# Continue Working

Do not stop after every small task.

Continue with related improvements.

Only ask for input when:

- A decision cannot reasonably be inferred.
- Multiple options have significant consequences.
- Credentials/access are required.
- A destructive choice is required.

---

# After Work

Update:

docs/CHANGELOG_AI_WORK.md

Include:

- Summary.
- Files changed.
- Tests.
- Decisions.
- Next steps.