Menu

#106 site(insights): add in-body concept links to intent-debt article

open
nobody
enhancement (5)
2026-05-17
2026-05-17
Anonymous
No

Originally created by: TheoV823

Problem

/insights/ai-native-engineering-intent-debt/ has zero in-body links to specific concept pages. The only /concepts/ reference is the breadcrumb (/concepts/). This means the article contributes no authority to individual concept nodes via the knowledge graph.

Finding

Discovered during Task 2b of the post-launch cleanup runbook (2026-05-17) via scripts/graph_metrics.py. The article is well-linked to (9 inbound links from 7 pages), but does not link out to concept nodes. Per ADR-012 (conceptual authority discipline), insights pages should wire into the concept graph to reinforce authority scores.

Top-authority concept nodes most relevant to this article (by current authority score):

  • /concepts/governance-before-generation/ (score: 29)
  • /concepts/architectural-governance/ (score: 27)
  • /concepts/governance-infrastructure/ (score: 25)

Proposed fix

Add 2–4 in-body <a href=/concepts/...> links within site/insights/ai-native-engineering-intent-debt/index.html at semantically appropriate points in the article body. Do not force links — only add where the concept genuinely applies to the surrounding sentence.

Scope

  • Modify site/insights/ai-native-engineering-intent-debt/index.html only
  • No structural or layout changes
  • Run scripts/seo_check.py --only insights/ai-native-engineering-intent-debt after to confirm no regressions
  • Re-run scripts/graph_metrics.py to confirm outbound-to-concept count increases

Discovered during post-launch cleanup runbook (2026-05-17).

Discussion


Log in to post a comment.

Auth0 Logo