update-claude-mdlisted
Install: claude install-skill pgundlupetvenkatesh/mdb_api_layer
# Keep CLAUDE.md in sync
CLAUDE.md is the single onboarding doc for this repo (see its own sections:
What this is, Commands, Configuration, Architecture, Gotchas). It must keep
matching the actual code. After a significant change, reconcile it.
## What counts as "significant"
Update CLAUDE.md when a change touches any of these:
- **Commands** — new/changed Poetry or pytest invocation, CLI flag
(`pytest_addoption` in `tests/conftest.py`), marker, report command, Docker
or K8s command.
- **Configuration** — new/removed/renamed env var, a changed default in the
`Config` class, a new required credential.
- **Architecture** — new or removed API client / endpoint method, fixture,
Pydantic schema, helper module, or a change to how layers connect
(`api/`, `config/`, `tests/conftest.py`, `tests/contracts/`, `failure_mcp/`).
- **Conventions** — a new pattern tests must follow (validation, data-driven
loading, allure tagging, assertion helpers).
- **Gotchas** — a new flaky endpoint, a registration that must happen in two
places, a non-obvious failure mode.
- **Dependencies** — a package added/removed that changes how the project is
set up or run.
Skip it for: test-data value tweaks, formatting/lint-only diffs, comment
changes, and one-off bug fixes that don't alter structure, commands,
conventions, or gotchas.
## Procedure
1. **See what changed.** Review the diff (`git diff`, `git diff --staged`, or
the change you just made). Identify which of the categories ab