Skip to content

docs: align top-level positioning with Agentic Adjudication Layer narrative#409

Merged
MuncleUscles merged 1 commit into
mainfrom
docs/agentic-adjudication-narrative
May 13, 2026
Merged

docs: align top-level positioning with Agentic Adjudication Layer narrative#409
MuncleUscles merged 1 commit into
mainfrom
docs/agentic-adjudication-narrative

Conversation

@MuncleUscles
Copy link
Copy Markdown
Member

Summary

Aligns the docs site with the GenLayer DNA narrative. The old positioning ("intelligence layer of the Internet" / "Trust Infrastructure for the AI Age" / "Trustless Decision-Making") is replaced with the new framing: The Adjudication Layer for the Agentic Economy.

Scoped to top-level positioning surfaces — does not touch dev-facing technical content, code examples, or APIs. The deeper narrative material (manifesto, trust-history, strategic pillars, Foundation self-dissolution) is intentionally left out of the docs and belongs on the marketing site / blog.

Changes

  • theme.config.tsx — Site title, SEO description, OG metadata.
  • pages/index.mdx — New tagline. Trinity updated to Money / Computation / Adjudication. Added a paragraph name-checking the agentic-commerce stack (Coinbase x402, ERC-8004, A2A, plus Stripe/OpenAI ACP, Visa TAP, Google AP2, Mastercard Agent Pay) for SEO/AEO.
  • pages/understand-genlayer-protocol/what-is-genlayer.mdx — New headline + opening. New "The Missing Layer" section with a comparison table over the agentic-commerce stack and the gap they all defer. Equivalence Principle name-checked at top level.
  • pages/understand-genlayer-protocol/typical-use-cases.mdx — Rewritten around the two GTM wedges: (1) Performance & milestone adjudication, (2) Adjudication inside the agentic-commerce stack. Adjacent surfaces (insurance, content, compliance, etc.) kept but moved below.
  • pages/FAQ.mdx — Tightened the "What is GenLayer" answer. Added "Is GenLayer trying to replace courts?" and "Where does GenLayer fit in the agentic-commerce stack?".
  • pages/glossary.cmdx — Added Adjudication, Agentic economy, Intelligent Contract, Equivalence Principle, GenVM, Ghost contract entries.
  • pages/understand-genlayer-protocol/optimistic-democracy-how-genlayer-works.mdx — One-line link from Optimistic Democracy to the adjudication framing.

Choices

  • Tagline tone: kept marketing-ier lines (e.g. "Justice in minutes, not months.") out of headlines; used the phrase once, in a bullet at the bottom of the use-cases page.
  • No nav or URL changes, no broken anchor links (verified #how-it-compares still resolves).
  • Year framing: avoided putting concrete years (2030 / 2034) in the docs — the DNA doc itself is inconsistent on this and docs decay fast.

Test plan

  • pnpm dev, check homepage, What is GenLayer, Use Cases, FAQ, Glossary
  • Verify SEO <title> and meta description on both home and a sub-page
  • Verify the link from FAQ to #how-it-compares still resolves

…rative

Updates docs positioning from "intelligence layer of the Internet" /
"Trust Infrastructure for the AI Age" to "The Adjudication Layer for
the Agentic Economy" — matching the GenLayer DNA narrative.

Highlights:
- New tagline + SEO/OG metadata across the site (theme.config.tsx).
- Homepage and What is GenLayer reframed around adjudication, with the
  Bitcoin/Ethereum/GenLayer trinity updated to Money / Computation /
  Adjudication. Adds a "Missing Layer" section name-checking the
  agentic-commerce stack (x402, ERC-8004, A2A) plus Stripe/OpenAI ACP,
  Visa TAP, Google AP2, Mastercard Agent Pay for SEO/AEO coverage.
- Use cases reordered around the two GTM wedges: performance/milestone
  adjudication first, agentic-commerce-stack adjudication second.
- FAQ: tightened the "What is GenLayer" answer and added two new Qs
  (court-replacement framing, fit in the agentic-commerce stack).
- Glossary: added Adjudication, Agentic economy, Intelligent Contract,
  Equivalence Principle, GenVM, Ghost contract.
- Optimistic Democracy intro: one-line link to the adjudication frame.

No anchor links broken; no nav changes.
@netlify
Copy link
Copy Markdown

netlify Bot commented May 13, 2026

Deploy Preview for genlayer-docs ready!

Name Link
🔨 Latest commit cee4684
🔍 Latest deploy log https://app.netlify.com/projects/genlayer-docs/deploys/6a046452d6b18f00086a507e
😎 Deploy Preview https://deploy-preview-409--genlayer-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 13, 2026

Warning

Rate limit exceeded

@MuncleUscles has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 16 minutes and 11 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f505281d-c1c7-46fe-864d-70203e1c40cf

📥 Commits

Reviewing files that changed from the base of the PR and between 8940354 and cee4684.

📒 Files selected for processing (7)
  • pages/FAQ.mdx
  • pages/glossary.cmdx
  • pages/index.mdx
  • pages/understand-genlayer-protocol/optimistic-democracy-how-genlayer-works.mdx
  • pages/understand-genlayer-protocol/typical-use-cases.mdx
  • pages/understand-genlayer-protocol/what-is-genlayer.mdx
  • theme.config.tsx
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/agentic-adjudication-narrative

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@MuncleUscles MuncleUscles merged commit fa7b35a into main May 13, 2026
8 checks passed
@MuncleUscles MuncleUscles deleted the docs/agentic-adjudication-narrative branch May 13, 2026 12:58
MuncleUscles added a commit that referenced this pull request May 13, 2026
…oint

GenLayer Skills (https://skills.genlayer.com/) is the recommended path
for both contract development (genlayer-dev) and validator operations
(genlayernode), but it was previously only mentioned in two places —
one of them buried inside an "Agent-Assisted Development" section
near the bottom of the tooling-setup page — and the canonical URL
(skills.genlayer.com) was not linked anywhere in the docs.

Changes:
- Top-level nav (pages/_meta.json) — add a persistent "Skills 🤖"
  external link, mirroring the existing Blog link.
- Homepage (pages/index.mdx) — prominent Callout above the Get
  Started cards with the install commands.
- Developers landing page (pages/developers.mdx) — new "Start with
  Skills (Recommended)" section above the reference card grid.
- Tooling setup — promote the Skills section to the top of the
  page (right after the intro); reframe the rest of the page as the
  manual/reference path. The MCP-server content stays where it is.
- Validator setup guide — replace the buried GitHub repo link with a
  skills.genlayer.com link and surface the cross-skill discoverability
  (mentions genlayer-dev alongside genlayernode).

All Skills links now point to skills.genlayer.com (canonical),
not github.com/genlayerlabs/skills.

Stacked on top of the agentic-adjudication-narrative branch (#409).
MuncleUscles added a commit that referenced this pull request May 13, 2026
…oint (#410)

GenLayer Skills (https://skills.genlayer.com/) is the recommended path
for both contract development (genlayer-dev) and validator operations
(genlayernode), but it was previously only mentioned in two places —
one of them buried inside an "Agent-Assisted Development" section
near the bottom of the tooling-setup page — and the canonical URL
(skills.genlayer.com) was not linked anywhere in the docs.

Changes:
- Top-level nav (pages/_meta.json) — add a persistent "Skills 🤖"
  external link, mirroring the existing Blog link.
- Homepage (pages/index.mdx) — prominent Callout above the Get
  Started cards with the install commands.
- Developers landing page (pages/developers.mdx) — new "Start with
  Skills (Recommended)" section above the reference card grid.
- Tooling setup — promote the Skills section to the top of the
  page (right after the intro); reframe the rest of the page as the
  manual/reference path. The MCP-server content stays where it is.
- Validator setup guide — replace the buried GitHub repo link with a
  skills.genlayer.com link and surface the cross-skill discoverability
  (mentions genlayer-dev alongside genlayernode).

All Skills links now point to skills.genlayer.com (canonical),
not github.com/genlayerlabs/skills.

Stacked on top of the agentic-adjudication-narrative branch (#409).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant