Skip to content

feat: add the AI Transformation playbook to the docs - #11

Open
gokulasok-klarityintelligence wants to merge 1 commit into
mainfrom
add-transformation-playbook
Open

feat: add the AI Transformation playbook to the docs#11
gokulasok-klarityintelligence wants to merge 1 commit into
mainfrom
add-transformation-playbook

Conversation

@gokulasok-klarityintelligence

@gokulasok-klarityintelligence gokulasok-klarityintelligence commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Adds a nine-page Drive AI transformation group, sitting between Concepts and How-to guides. It covers the layer the portal was missing: what to build, where to build it, and how to run the motion from a business objective through to a deployed agent.

Pages

Page Covers
/transformation The three phases, and the Company Brain bridge
objective Naming the outcome in business terms before picking technology
company-brain Discover (rolling out Companion) and Structure (exploring it)
use-case-selection The screens for choosing the right problem
what-you-can-build Skill, Integration Flow, Managed Agent, MCP context bundle
where-you-build The four surfaces and the build grid
non-technical-track Advisor and MCP from a chat app
technical-track The eight-step ADK sequence in a coding harness
maintain-agents Diffing agents against the Company Brain as processes drift

How the ADK is documented

The technical track documents the ADK as a methodology rather than something you install. It is served from the MCP at runtime through get_agent_builder_instructions, so there is nothing separate to set up and no plugin version to track, and improvements reach builders the next time they build. A mermaid diagram on that page shows how the coding harness, the MCP, and the Company Brain fit together.

The sequence is documented as eight steps: Objective, Companion, Analyze, Recommend and select, Design, Build, Test, Deploy.

Terminology

"Company Brain" appeared zero times on the site before this. It is introduced once on the hub page, tied to the Process Index and Artifacts layers, then used freely across the group. Integration Flow, Managed Agent and ADK were also new to the portal and are each defined on first use.

Also in this PR

The landing page card "Build agents and skills" pointed at /guides/code-and-agents, which does not exist and 404s on the live site today. Repointed at /guides/agent-builder. Came in with #8.

concepts/discover-structure-improve and guides/agent-builder each gained a cross-link into the new group.

Checks

All 41 internal links across the site resolve, docs.json parses, and every nav entry has a file.

Known gaps

Advisor has no page on the portal, so its mentions in the non-technical track and the Structure section are plain text.

🤖 Generated with Claude Code

@mintlify

mintlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
klarity-mcp 🟢 Ready View Preview Jul 29, 2026, 3:59 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Adds a nine-page "Drive AI transformation" group covering the layer the
portal was missing: what to build, where to build it, and how to run the
motion from a business objective through to a deployed agent.

Sits between Concepts and How-to guides. The hub page introduces "Company
Brain" once and bridges it to the Process Index and Artifacts layers, since
the term did not appear anywhere on the site before now.

The technical track documents the ADK as a methodology rather than something
you install. It is served from the MCP at runtime via
get_agent_builder_instructions, so there is nothing separate to set up and no
plugin version to track.

Also fixes a dead link on the landing page. The "Build agents and skills"
card pointed at /guides/code-and-agents, which does not exist.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
rs07-within added a commit that referenced this pull request Sep 10, 2026
Bring the docs/transformation pages from PR #11 (add-transformation-playbook)
forward onto current main, and sweep Klarity -> Within in prose so they match
the rebranded site. Nav wiring and the new pages (readouts, opportunity loops)
follow in later commits.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
rs07-within added a commit that referenced this pull request Sep 10, 2026
Bring the docs/transformation pages from PR #11 (add-transformation-playbook)
forward onto current main, and sweep Klarity -> Within in prose so they match
the rebranded site. Nav wiring and the new pages (readouts, opportunity loops)
follow in later commits.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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