all

wiki/lint-reports/2026-07-18-lint-full-wiki.md

@@ -0,0 +1,66 @@
+# Lint Report — Full Wiki (2026-07-18)
+
+#lint-report
+
+## Scope
+
+Full-wiki health check of all **40 pages** (1 overview · 13 sources · 17 concepts · 6 entities · 1 comparison · 1 query · 1 lint report), the follow-up to the sources-only lint ([[2026-07-18-lint]]). Every concept, entity, comparison, and query page was read in full; link health was checked against a deduped inventory of all `[[…]]` targets across the vault.
+
+Checks: page-type tags · template-section completeness · broken links · orphans / weak linking · cross-page contradiction coverage · stale claims superseded by newer sources · missing evidence links · high-mention concepts lacking pages.
+
+## Verdict
+
+**The wiki is in good structural health.** Tags, templates, links, and orphan-coverage all pass cleanly. The only real findings are **staleness introduced by today's adversarial-source ingest** — three pages still say "the vault has no adversarial source," which is no longer true. Two fixes + one clarification applied; one structural gap (a missing *referrals* page) flagged.
+
+## Passing Checks
+
+- **Page-type tags: 100%.** All 40 pages lead with the correct folder-matching type tag (`#source`/`#concept`/`#entity`/`#comparison`/`#query`/`#overview`/`#lint-report`), topical tags after. No mismatch.
+- **Template sections: complete.** All 17 concepts and 6 entities carry the required Summary / Current Understanding / Evidence / Related Pages / Contradictions-Uncertainty / Next Questions. The query matches the Query template; sources verified in the prior lint.
+- **No broken links.** Every `[[…]]` target resolves to an existing page. (Two `[[…]]` hits are illustrative text inside code spans; one `[[wiki/overview|Overview]]` is a path-style link — resolvable but inconsistent, fixed below.)
+- **No orphans; linking is strong.** Every page has ≥7 inbound references (busiest: [[client-acquisition-channels]] 46, [[methodology-as-moat]] 43, [[2026-07-17-design-the-perfect-offer]] 42; lowest are the query at 7 and this-day's lint at 4 — both expected for their type). The new [[ai-productivity-evidence]] already has 26 references — well-integrated on arrival.
+- **Evidence links present** on every concept/entity page.
+- **Contradiction coverage is thorough.** Every live tension is recorded on the relevant page(s): productize-immediately-vs-after-2–3 ([[productized-service]]), one-package-vs-price-ladder ([[offer-ladder]]), cloning-vs-moat ([[cloning-over-originality]]), online-vs-in-person ([[client-acquisition-channels]]), two-moats ([[methodology-as-moat]]/[[relationships-as-moat]]), and now the foundational AI-capability contradiction ([[ai-productivity-evidence]]). No unrecorded contradiction found.
+
+## Findings
+
+### F1 — `productized-service` still says the vault has no adversarial source (Medium) — ✅ fixed
+
+The page's Contradictions and Next Questions read "still no true adversarial view" / "the vault needs an adversarial source," now contradicted by the day's ingest of [[ai-productivity-evidence]]. It also leans on the "~$200/mo AI substitute" premise that the new evidence contests.
+**Fix:** updated both sections to acknowledge the adversarial source exists and to sharpen the *remaining* gap — the new source tests the **AI-capability premise**, not the **productization model itself**, so a *productization-failure* source is still genuinely missing. Added a "now contested" pointer on the substitution bullet and [[ai-productivity-evidence]] to Related Pages.
+
+### F2 — Query snapshot's "no adversarial source" caveat is now imprecise (Low) — ✅ fixed (dated note)
+
+[[2026-07-17-best-method-first-client]] states "the vault also has no adversarial or failure-case source on any of this." True for its *channel/sales* topic, but the blanket phrasing is now misleading.
+**Fix:** appended a dated lint note (preserving the original per the Update Policy) clarifying that the new adversarial source addresses the AI-capability premise, not these channel claims — which remain un-countered.
+
+### F3 — Inconsistent path-style link in `index.md` (Low) — ✅ fixed
+
+`index.md` used `[[wiki/overview|Overview]]` (path-style) where the vault everywhere else uses the bare `[[overview]]`. Resolvable but inconsistent. **Fix:** changed to `[[overview|Overview]]`.
+
+### F4 — High-mention concept with no page: **referrals** (Medium) — flagged
+
+Referrals appear as a distinct, high-value channel with their own statistics and mechanics across [[2026-06-15-17-ways-first-client]] (91% would refer / 11% asked; highest-converting; ~0 cost; ask-immediately-after-delivery), [[sales-discipline]], [[client-acquisition-channels]], and the query — but have **no dedicated concept page**. This is the clearest structural gap. Recommend creating `wiki/concepts/referrals.md` (inbound from client-acquisition-channels, sales-discipline; the "can't bootstrap client #1" sequencing constraint is its key nuance). Not created in this lint pass (a lint reports; it doesn't author content).
+
+### F5 — Secondary concept candidate: **guarantee / risk-reversal** (Low) — flagged
+
+The guarantee mechanic recurs with an explicit open question across [[pricing-from-value]] (the guarantee test) and [[outcome-based-selling]] ("guarantee mechanics are undefined"). Currently well-covered within those two pages; a dedicated page is optional, lower priority than referrals.
+
+### F6 — Optional enrichment links to the new evidence page (Low) — flagged
+
+[[niche-selection]] ("'go where AI is powerless' assumes LLM capability is static") and [[solution-vs-staff-augmentation]] ("directly substituted by the ~$200/mo alternative") both make claims the new [[ai-productivity-evidence]] speaks to. Not errors — optional cross-links that would tighten the web. Left for a future pass to avoid over-editing during a lint.
+
+## Note — a nuance worth recording (not a defect)
+
+The adversarial ingest was appropriately *surgical*: it added counter-evidence only to the three pages it genuinely contradicts ([[ai-market-shift]], [[seniority-and-ai]], [[future-of-engineering-work]]). It did **not** touch [[relationships-as-moat]] or [[product-ownership]], which rest on the "AI levels skill" premise — correctly, because "novices gain most" *corroborates* leveling rather than contradicting it. So the same source contradicts one Sebastian claim (juniors irrelevant) while supporting another (skill is leveled); the vault currently records the contradiction but not the corroboration. Optional future touch.
+
+## Changes Made This Pass
+
+- [[productized-service]] — F1: adversarial-source acknowledgement + substitution-premise pointer + Related-Pages link.
+- [[2026-07-17-best-method-first-client]] — F2: dated clarifying note.
+- `index.md` — F3: path-style link normalized (plus this report added to the Lint Reports table and counts updated).
+
+## Recommended Next Operations
+
+1. **Create the `referrals` concept page** (F4) — the one real structural gap.
+2. **Ingest a productization-failure-case source** — still the highest-value content gap (the AI-capability premise now has a counter; the *selling model* does not).
+3. Optional tidy: F5 (guarantee page), F6 (enrichment links), the corroboration note above.

wiki/lint-reports/2026-07-18-lint.md

@@ -0,0 +1,57 @@
+# Lint Report — Sources (2026-07-18)
+
+#lint-report
+
+## Scope
+
+Health check of the **12 source summary pages** in `wiki/sources/*` (per user request "run a lint on sources"). Cross-page checks (inbound links, contradiction coverage) were run against the whole vault where a source page is one end of the relationship. This is the vault's **first lint**.
+
+Checks run: raw↔summary coverage · page-type tags · template-section completeness · outbound link validity · inbound linking / orphans · cross-source contradiction coverage · stale/superseded claims · metadata completeness · evidence provenance.
+
+## Verdict
+
+**The source layer is healthy.** No orphans, no broken links, no missing or mismatched tags, complete raw↔summary coverage, and provenance is well-maintained. Five findings, all Low/Info; two were fixed in this pass, three are flagged.
+
+## Passing Checks
+
+- **Coverage is complete and 1:1.** 12 raw files in `raw/sources/` → 12 summaries in `wiki/sources/`. No un-ingested raw source; no summary without a backing raw file.
+- **Page-type tags correct.** All 12 pages open with `#source` as the first tag; topical tags follow. No folder/tag mismatch.
+- **Template sections present.** All 12 carry Source Metadata, Core Claims, Key Evidence / Details, Connections, Open Questions, and Change Impact on Wiki. (`konspekt-aphorisms` uses "Core Claims (the aphorisms)" — compliant.)
+- **No broken outbound links.** Every `[[…]]` target in every source page resolves to an existing page.
+- **No orphan sources.** Every source has ≥1 inbound link from a content page (concept/entity/comparison/query/overview), plus index/overview catalog links.
+- **Provenance chain intact.** The primary→secondary demotion of [[2026-06-15-selling-development-services-in-the-ai-era]] is recorded on the page and reflected in concept-page citations; its resolved open question is struck through, not deleted (history preserved). Primaries carry accurate "provenance role" notes. The `konspekt-aphorisms` "Indian dev" stereotype is quoted for fidelity with an explicit non-reuse caveat — compliant with the citation policy.
+
+## Findings
+
+### F1 — Content-marketing-timing contradiction was under-recorded (Low) — ✅ fixed
+
+The new source [[2026-07-18-information-is-free-implementation-is-paid]] makes organic content the *primary* lead engine from day one — a third, most-aggressive position on content timing. [[client-acquisition-channels]] still recorded the split as two-way (Tony vs AB Analytics). Non-negotiable rule #5 requires contradictions be recorded explicitly.
+**Fix:** upgraded the Contradictions bullet in [[client-acquisition-channels]] to the three-way split, noting the "audience-dependent" escape is weaker here (all three are US SMB coaching sources).
+
+### F2 — Missing reciprocal link + inaccurate Change Impact on the LinkedIn template (Low) — ✅ fixed
+
+[[2026-06-15-linkedin-mail-template]]'s Change Impact claims it is "linked from [[client-acquisition-channels]] and [[sales-discipline]]," but `sales-discipline` did **not** link it — leaving the template inbound-linked from only one content page (its weakest link in the vault).
+**Fix:** added the link from [[sales-discipline]] ("customize every first touch" → the concrete instance is the template), making the claim true and strengthening the weak link.
+
+### F3 — `meta-analysis` is the most weakly inbound-linked source (Low) — flagged
+
+[[2026-06-15-meta-analysis-selling-dev-in-ai-era]] is inbound-linked from only [[overview]] among content pages (plus index/log). Acceptable for a second-order map that mostly *points at* the primaries, but it is the least-connected source. Optional future strengthening: cite it from the concept pages whose contradictions it first surfaced (content-timing, team-size).
+
+### F4 — Filename date-prefix convention is inconsistent for undated videos (Info) — flagged
+
+Three conventions are in use for the date prefix: **ingestion date** for the two US anchors (`2026-07-17-design…`, `2026-07-18-information…`), **batch date** for the June-15 set, and **file date** for `2026-07-06-sebastian…`. Each page documents its own date in metadata, so nothing is misleading — but the naming rule doesn't specify which date to use when a source is undated. Consider codifying: "undated source → use ingestion date." No file renames recommended now (links would churn).
+
+### F5 — Corpus remains single-school and unverified (Info) — flagged (standing gap)
+
+The 12th source adds no statistics but also no verification and no dissent: 11 of 12 sources are the same "sell dear / give-value / productize" school; all quantitative claims across the corpus remain attributable-but-unverified (promotional videos). Already tracked in [[overview]] and [[index]]. The highest-value next ingest is still an **adversarial / failure-case** source; a warm partial-dissent already exists in [[sebastian]] (channels only).
+
+## Changes Made This Pass
+
+- [[client-acquisition-channels]] — content-timing contradiction upgraded to three-way (F1).
+- [[sales-discipline]] — added reciprocal link to [[2026-06-15-linkedin-mail-template]] (F2).
+
+## Recommended Next Operations
+
+1. Ingest an **adversarial source** (F5) — the one gap that materially changes vault confidence.
+2. A **full-wiki lint** (this pass covered sources only) — to check concept/entity pages for the same categories, plus high-mention concepts lacking pages (e.g. *referrals* is a high-value channel with metrics but no dedicated page).
+3. Optional low-priority tidy: F3 (link meta-analysis from concept pages), F4 (codify the date-prefix rule).