Claude Code

Repository-first workflow

1. Inspect the repository.
2. Explain architecture and data flow.
3. Reproduce the bug or define the feature.
4. Propose a minimal plan.
5. Make small testable edits.
6. Run tests, linting and security checks.
7. Report changed files and evidence.

Example CLAUDE.md

# Stack
PHP 8.2, MySQL 8, Bootstrap 5, JavaScript

# Rules
- Use prepared statements.
- Never hardcode credentials.
- Preserve working modules.
- Keep all pages responsive.
- Validate server-side and client-side.
- Run regression checks before finalizing.

Better debugging request

Inspect this accounting repository before editing.
Trace journal → ledger → trial balance → Trading Account.
Reproduce the incorrect total.
Propose the smallest safe fix.
Apply it and run regression checks for P&L and Balance Sheet.