Skip to content

Link-check audit: Profile vs Person resolution

Date: 2026-06-04 File checked: docs/products/model/architecture.md Section: ## Profile vs Person resolution Command:

npx --yes markdown-link-check docs/products/model/architecture.md

Raw output

FILE: docs/products/model/architecture.md
  [✖] https://github.com/credinvest/cred-dbt/blob/main/docs/identity/README.md
  [✖] https://github.com/credinvest/cred-agent-rules/blob/main/rules/0017-profile-person-resolution.md
  [✓] https://linear.app/credplatform/issue/COM-37175
  [✖] ../../audits/profile-person-resolution-link-check.md

  4 links checked.

  ERROR: 3 dead links found!
  [✖] https://github.com/credinvest/cred-dbt/blob/main/docs/identity/README.md → Status: 404
  [✖] https://github.com/credinvest/cred-agent-rules/blob/main/rules/0017-profile-person-resolution.md → Status: 404
  [✖] ../../audits/profile-person-resolution-link-check.md → Status: 400

Analysis

Link Result Reason
cred-dbt/docs/identity/README.md 404 Private repo — markdown-link-check has no GitHub auth token; the repo is private and returns 404 to unauthenticated requests. Manual verification required (see below).
cred-agent-rules/rules/0017-profile-person-resolution.md 404 Private repo — same auth/rate-limit constraint as above. Manual verification required.
COM-37175 (Linear) ✓ live Confirmed reachable.
../../audits/profile-person-resolution-link-check.md 400 Bootstrap order — this file did not exist when the first check ran. A second check (after this file is committed) resolves this. See below.

Re-check (after audit file exists)

npx --yes markdown-link-check docs/products/model/architecture.md

Actual output (second run, after this file was created):

FILE: docs/products/model/architecture.md
  [✖] https://github.com/credinvest/cred-dbt/blob/main/docs/identity/README.md
  [✖] https://github.com/credinvest/cred-agent-rules/blob/main/rules/0017-profile-person-resolution.md
  [✓] https://linear.app/credplatform/issue/COM-37175
  [✓] ../../audits/profile-person-resolution-link-check.md

  4 links checked.

  ERROR: 2 dead links found!
  [✖] https://github.com/credinvest/cred-dbt/blob/main/docs/identity/README.md → Status: 404
  [✖] https://github.com/credinvest/cred-agent-rules/blob/main/rules/0017-profile-person-resolution.md → Status: 404

The relative link (../../audits/profile-person-resolution-link-check.md) now resolves ✓. The only remaining failures are the two private GitHub repo links — expected without auth.

The GitHub links cannot be verified by an unauthenticated link checker. A reviewer with repository access should confirm each path manually:

  1. cred-dbt identity models
  2. Repo: credinvest/cred-dbt
  3. Expected path: docs/identity/README.md

  4. If the path differs, update docs/products/model/architecture.md to point to the correct file.

  5. cred-agent-rules rule 0017

  6. Repo: credinvest/cred-agent-rules
  7. Expected path: rules/0017-profile-person-resolution.md
  8. If DOC-2 (fan-out release) has been marked complete, the rule link should be updated to the published/released location.

Anchor check (pre-edit)

Command run before editing architecture.md:

rg -n "^#+ .*Profile|^#+ .*Person|^#+ .*identity" docs/products/model/architecture.md

Output: (no matches) — no existing Profile, Person, or identity headings were present. No duplicate anchor was created.