AEO-Aligned IV Chain – Working Doc (as of 04 Feb 2026)

Completed (production-ready)

• Hydration: Tasks, KPIs, Processes, OKRs, Flows pulled from SkillSystem specs into site data.
• Pages:
  • Tasks: /tasks/[id] (HowTo JSON-LD, linked KPIs/OKRs, evidence checklist + ValueLogs link, process link, breadcrumbs)
  • KPIs: /kpis/[code] (TermDefinition JSON-LD, linked tasks, linked OKRs, breadcrumbs, evidence reminder)
  • Processes: /processes/[id] (HowTo + ContactPoint JSON-LD, KPI rollup, linked tasks, linked OKRs, FAQ, audit CTA, breadcrumbs)
  • OKRs: /okrs/[id] (JSON-LD bundle, KR chips with targets/periods, linked KPIs/tasks, audit CTA, breadcrumbs)
  • Flows: /flows/[id] (HowTo JSON-LD, counts + links to processes/tasks/KPIs, CTA, breadcrumbs)
  • ValueLogs: /valuelogs/ (HowTo + breadcrumbs + CTA)
• Explorers: Task, KPI, Process, OKR, Flow explorers; Explore hub at /explore/.
• Hierarchy pages added: Internal Value Chain (/internal-value-chain/), ValuationOps (/valuationops/), RevenueOps (/revenueops/), Suites explorer + suite detail pages (/suites/, /suites/[id]); flows now carry suite tags from SkillSystem.
• Linking: Bidirectional linking across tasks ↔ KPIs ↔ processes ↔ OKRs; processes ↔ OKRs; flows ↔ processes/tasks/KPIs.
• Schema/AEO: Breadcrumbs on entity + list pages; JSON-LD on all entities; ValueLogs HowTo.
• Nav: Navbar exposes Explore, Flows, Processes, Tasks, KPIs, OKRs, ValueLogs.
• Build health: npm run docs:build + sitemaps + verify:seo passing (latest build: 843 HTML files).
• SkillSystem updates: Strategy TSV fixed with M/S/F-S-### task IDs + PROC-REV-STRAT-01; Spec Creator generated strategy tasks/process/flow/OKR/KPI; spec checker 100% clean; revenueops.json regenerated (45 processes, 192 tasks, 188 KPIs, 12 OKRs).

Near-term (high-value, minimal scope)

1. Counts/badges polish
   • Add KPI/OKR/task counts on Process/OKR detail and process cards.
2. ValueLogs schema (optional)
   • Add a small JSON-LD ContactPoint/HowTo or Evidence schema if we expose logs.

Later (optional polish)

• Add small “contact/FAQ” block on KPI/Task pages if desired.
• Add suite/flow breadcrumbs when we add those pages.

Status snapshot (04 Feb 2026)

• OKRs hydrated (12) and wired into KPIs/Tasks.
• LinkChips centralizes linked entities across all layers.
• Breadcrumbs on entity + list pages; nav updated.
• Whitepapers single-source in SkillSystem; site copy removed.
• Strategy specs generated and validated; revenueops.json clean.

Paths of key files

• Tasks: docs/tasks/[id].md, docs/tasks/index.md
• KPIs: docs/kpis/[code].md, docs/kpis/index.md
• Processes: docs/processes/[id].md, docs/processes/index.md
• OKRs: docs/okrs/[id].md, docs/okrs/index.md
• Flows: docs/flows/[id].md, docs/flows/index.md
• Explorers: docs/.vitepress/theme/components/*Explorer.vue
• Shared chips: docs/.vitepress/theme/components/LinkChips.vue
• Data dirs: docs/.vitepress/data/
• Aggregation: specs/valuation-ops/revenueops.json (SkillSystem)

If needed from SkillSystem

• OKR source specs: /Users/mosessampaul/Documents/GFE/Repos/GFE-SkillSystem/specs/okrs
• Processes source: .../specs/processes
• Tasks source: .../specs/tasks
• KPIs source: .../specs/kpis/kpi-definitions.json
• Flows source: .../specs/flows
• Suites source: .../specs/suites
• RevenueOps map: .../specs/valuation-ops/revenueops.json

Suggested order to finish

1. Add site explorers/pages for InternalValueChain → ValuationOps → RevenueOps → Suites → Flows (Flows done) and link to Processes/Tasks/KPIs/OKRs.
2. Add counts/badges on Process/OKR pages/cards.
3. Optional ValueLogs schema/contact block.

— Working doc to keep us focused on chain completion over cosmetic tweaks.