Block a user
epic(legibility): big-bang restructure — backend layer→domain, frontend lib→domain
test(legibility): verify e2e suite covers every critical user journey
test(legibility): rewrite tautological tests revealed by TEST-1
test(legibility): mutation-test critical backend service tests; flag tautologies
epic(legibility): pre-flight — make tests trustworthy before big-bang refactor
docs(legibility): migrate CLAUDE.md rules into human docs; mark migrated content
docs(legibility): add per-domain README.md inside every domain package
docs(legibility): write docs/DEPLOYMENT.md (production runtime + env vars)
docs(legibility): write CONTRIBUTING.md with three concrete walkthroughs
docs(legibility): write docs/GLOSSARY.md disambiguating overloaded terms
docs(legibility): write docs/ARCHITECTURE.md with diagram and domain list
docs(legibility): write human-targeted README.md at repo root
epic(legibility): documentation — make the codebase self-explaining
audit(rollup): produce global readiness scorecard from subsystem audits
audit(rest): score infra/, scripts/, root, docs/ against legibility rubric
audit(db): score Flyway migrations + DB schema against legibility rubric
audit(ocr-service): score ocr-service/ against legibility rubric C1–C10
audit(backend): score backend/ against legibility rubric C1–C10
audit(frontend): score frontend/ against legibility rubric C1–C10
epic(legibility): audit — assess current state of every subsystem
Reference inputs for all AUDIT-N child issues
This comment is the source-of-truth reference for every child audit. Audit agents should read this comment before opening their assigned child…