test-strategy ยท diff
git:20261020.4b7b8f8 to git:20261023.7222665
12 added, 7 removed. Audit A to A.
---
name: test-strategy
- description: Existing tag-only strategy for the embedded-tests service.
+ description: Existing non-intrusive test strategy for the embedded-tests service.
---
# Test Strategy
## Repo ID
`embedded-tests`
## Test Locations
| Location | Repo | Layers | Test files | Full-suite command | Run from |
| --- | --- | --- | --- | --- | --- |
- | . | embedded-tests | Unit, Documentation | src/test_*.py | make test | . |
+ | . | embedded-tests | Unit, Documentation | src/test_*.py; embedded unittest and docstrings in src/*.py | make test | . |
## Layers
| Layer | Status | For | Not for | Location | Example command | Prerequisites |
| --- | --- | --- | --- | --- | --- | --- |
| Unit | configured | Isolated rules | External services | . | python3 -m unittest -v src.account.DiscountTests | Python 3 |
| Documentation | configured | Executable checkout examples | Full user journeys | . | python3 -m doctest -v src/account.py | Python 3 |
## Run Prerequisites
### .
- **Env vars:** None
- **Services:** None
- **Credentials:** None
- **How to start:** None
- **Local run:** yes
## Where New Tests Go
| Layer | Status | Repo | Directory | File naming |
| --- | --- | --- | --- | --- |
| Unit | configured | embedded-tests | src | Checkout tests embedded in account.py::DiscountTests; labels in test_labels.py |
| Documentation | configured | embedded-tests | src | Executable examples in account.py docstrings |
## Coverage Decision Guidance
Checkout rule changes use embedded unit tests. Executable examples are a separate
configured command; make test runs both. Label changes use separate unit tests.
- ## Tag Convention
+ ## Test Map
- Generated legacy guidance: add repo-qualified @covers comments above every test.
+ Shared `.claude/testing/test-map.json` uses schema v1 and evidence-backed
+ relationships for all placements. Never edit source/tests for mapping.
## How to Scan
- Run once per token from the repo root:
- `grep -rlIiE --exclude-dir=.git --exclude-dir=.claude '@covers([[:space:]].*)?[[:space:]]<repo>:<tag>([[:space:]]|$)' src`
- Filter to src/test_*.py.
+ Follow make-it-work docs/test-map-contract.md and scripts/test-map.mjs. Reuse
+ unchanged relationships, refresh changed evidence, and preserve user decisions.
+ Discover separate src/test_*.py, embedded unittest classes in src/account.py and
+ src/experimental.py, and executable docstrings. Use python3 -m unittest -v
+ <selector> for unit tests and python3 -m doctest -v src/account.py for
+ documentation. Keep experimental helper-to-UC relationships unresolved without
+ behavior evidence. A missing map requires in-memory discovery, not source tags.
## Strategy Decisions
SENTINEL: Keep Python unittest and doctest; no third-party setup or refactoring.