How IdeaFoundry Works

Quick Start

1. Add the Connector

Paste this MCP connector URL into Claude:

OpenClaw skill support is currently in testing and coming soon.

2. Type ideafoundry

Type the core command in Claude:

ideafoundry

Claude will show the available profile actions.

3. Create your profile

Use:

ideafoundry create profile

IdeaFoundry will open the OAuth sign-in flow when authentication is needed. You can sign in or create an account with Google/Gmail, or enter any email address manually.

You are only prompted to sign in when you create, edit, draft, approve, publish, discard, or otherwise modify private profile state.

4. Update from where the work is happening

Use your AI system as the working surface. When your plans, progress, next steps, or needs change, update your IdeaFoundry profile from that same context.

For example:

ideafoundry edit next

Then you can work naturally:

Draft an update based on what we just shipped.
Make it shorter.
Add the latest progress.
Rewrite this in my voice.
Show me the full draft.

Commands are available when you want precision. Natural language does most of the work once you are inside the flow.

5. Refine and publish

Use natural language to refine the draft. Claude or your AI system will usually suggest the next available actions.

When the draft looks right, you can respond naturally:

publish

Or use the explicit command:

ideafoundry publish now

Review and approval commands are also available when you want a more explicit staged workflow:

ideafoundry review draft
ideafoundry approve draft

Your AI system helps prepare the update. Your profile website displays the approved state as a public, read-only source of truth.

One draft at a time: Review each proposed profile update, then publish it or discard it before moving on to the next draft. This keeps changes intentional, understandable, and under your control.

6. View the published profile

Your published profile lives at:

profiles.ideafoundry.network/u/yourhandle

View the IdeaFoundry master profile as an example:

https://profiles.ideafoundry.network/u/ideafoundry

Commands are available for control. Natural language does most of the work. One active draft at a time. You control what goes public.

What IdeaFoundry Is

IdeaFoundry is a shared profile layer for humans and AI systems.

You edit your profile from the AI system where your work is happening — starting with Claude today. That AI system is the working surface.

Your published profile website displays the approved state as a public, read-only source of truth. It shows who you are, what you are building, where things stand, what changed recently, what happens next, and how others can help.

Instead of every AI system working from isolated memory, IdeaFoundry gives humans and AI systems one shared state they can read and coordinate around.

Claude is live today. OpenClaw support is currently in testing and coming soon.

IdeaFoundry is designed to support more AI systems over time, including ChatGPT, Gemini, Grok, Kimi, Ollama, and others.

One working context. One public profile. One shared source of truth. That is the foundation for shared intelligence.

The Operating Pattern

IdeaFoundry uses a simple operating pattern:

Commands open the door. Natural language works inside the room.

A command starts or switches a specific action. Natural language handles most of the drafting, editing, and refinement inside that action.

Command: ideafoundry edit next
→ Private draft
→ Natural language refinement
→ Publish when ready
→ Public profile state

If you want more control, explicit review and approval commands are available:

ideafoundry review draft
ideafoundry approve draft
ideafoundry publish now

The system is controlled, but not rigid. Different users can work at different levels of precision. Some people will mostly talk naturally. Others will use explicit commands for specific workflow steps.

Claude or your AI system will usually suggest the next available actions, and you can respond naturally. If it asks whether you want to publish, you can simply type:

publish

The AI system is where the update is prepared. The profile website is where the approved state becomes public and read-only. This keeps the workflow clear for humans and AI systems without forcing every user into the same exact sequence.

Commands vs Natural Language

Commands are available when you want precision, but IdeaFoundry is designed to feel conversational.

Claude or your AI system will usually suggest what you can do next. You can often follow those suggestions in plain language:

publish
make it shorter
show me the draft
discard this
use my version instead

Explicit ideafoundry commands are there when you want a clear action, need to switch sections, or want to use a specific workflow step.

Commands start actions

Use explicit ideafoundry commands when you want to:

• create a profile
• load your profile
• view a public profile
• edit a section
• draft content
• rewrite content yourself
• review changes
• approve a draft
• publish
• discard a draft

Example:

ideafoundry edit next

This tells the AI system to load the What Happens Next section and open a private draft state.

Natural language does most of the work

Once you are inside an active edit or review flow, you can talk naturally.

Example:

Draft an update based on what we just shipped.
Make it shorter.
Add that the Claude profile flow is live.
Keep the ending.
Make it less hypey.
Show me the full draft.
Publish this.

Commands are useful for opening flows, switching sections, reviewing, approving, publishing, discarding, or replacing the draft. Natural language is useful for everything in between.

Example session

ideafoundry edit next

Claude opens your What Happens Next section and shows the current content.

ideafoundry ai draft

The AI proposes an updated draft.

Make it shorter.
Add that the Claude profile flow is live and OpenClaw is in testing.
Keep the ending.

You refine naturally inside the flow.

When it looks right, publish:

publish

or:

ideafoundry publish now

If you want to check the staged change first, use the optional review path:

ideafoundry review draft
ideafoundry approve draft
ideafoundry publish now

One Active Draft at a Time

IdeaFoundry keeps coordination simple by using one active draft at a time.

Before starting a new draft, you must review, publish, discard, or rewrite the current one. This prevents synchronization errors and keeps your public profile state clear.

One active draft does not mean one rigid workflow. It means IdeaFoundry keeps one private staged change open so the AI system, the user, and the public profile do not drift out of sync.

Rewrite the draft yourself

Sometimes you do not want the AI draft. You want to write the section yourself.

Use:

ideafoundry rewrite myself

This replaces the active draft with your own words while keeping the same review and publish workflow. You still control what gets published.

Profile Sections

IdeaFoundry profiles are structured so humans and AI systems can understand work quickly.

Each section is designed to stay focused and scannable.

Metadata & Coordination Signals

IdeaFoundry profiles include coordination signals that help humans and AI systems understand how a profile is changing.

Provenance

Provenance shows where profile content came from. A section can be labeled as:

• Human — written by the profile owner
• Agent — drafted with AI assistance
• Human + Agent — created through a mix of human direction and AI drafting

When an agent performs an action, provenance can also show which AI model was used. These labels make authorship clearer. They help readers understand whether a section was written directly, generated with help, or shaped collaboratively.

Abundance Signals

Abundance signals help humans and AI systems understand whether an update appears to move the profile forward.

• Rising — adds value, clarity, momentum, or useful new information
• Stable — preserves or maintains the current state
• Unclear — needs more context, clarity, or review

These are coordination signals, not personal ratings. The larger purpose is to guide collaboration toward abundance: more useful work, less artificial scarcity, and a path toward post-scarcity coordination. The formula and governance behind this are explained in the IdeaFoundry Litepaper.

Security & State

Public profile

Your published profile is visible at:

profiles.ideafoundry.network/u/yourhandle

Humans and AI systems that can read public web pages can read it. That is the point: your profile becomes a public coordination surface.

Read-only published state

The profile website displays the approved state. Public readers can use it as a source of truth, but they cannot edit it. Edits happen from authenticated AI-system workflows, such as Claude today.

Private state

Drafts, authentication data, ownership records, session records, and unpublished changes are private.

Authentication

IdeaFoundry asks you to sign in only when authentication is needed for a private or modifying action. Reading public profiles does not require sign-in.

System rules

IdeaFoundry enforces:

• OAuth authentication for private actions
• Google/Gmail sign-in and manual email login support
• Owner-only profile edits
• Draft-before-publish workflow
• One active draft at a time
• Explicit publish control
• User confirmation before publishing
• Version conflict detection
• Focused content limits
• HTTPS-only social links
• Rate limiting

Command Reference

These commands are available when you want explicit control. You do not need to use every command every time.

System & State

Section Editing

Drafting and Refinement

Review and Publish

Roadmap

Live now

• Public IdeaFoundry profile pages
• Claude MCP connector
• OAuth authentication
• Google/Gmail sign-in and manual email login
• Conversational profile editing with optional explicit commands
• One active draft at a time
• Single-section draft, refinement, optional review, and publish workflow
• Provenance labels
• Abundance signals

In testing

• OpenClaw native skill
• Same profile workflow across Claude and OpenClaw

Coming next

• Search across public profiles
• Direct messaging between users, agents, and projects
• Workflow cards and settlement
• Expanded AI-system support
• Automated multi-section drafting
• Deeper shared coordination workflows

Workflow cards and settlement will let humans and AI systems coordinate tasks, track deliverables, and let users pay or get paid when work is completed.

FAQ

Do I need to create an account first?

No separate setup is required before you start. Add the Claude connector, then use:

ideafoundry create profile

IdeaFoundry will open OAuth when sign-in is needed. You can sign in or create an account with Google/Gmail, or enter any email address manually.

When will I be prompted to sign in?

IdeaFoundry prompts you to sign in only when authentication is needed for a private or modifying action. Reading public profiles does not require sign-in.

What sign-in options are supported?

You can sign in or create an account with Google/Gmail. You can also enter any email address manually.

Do I need to use exact commands every time?

No. Commands are available when you want explicit control. Most drafting and refinement happens through natural language once you are inside a flow. You can often respond naturally, for example:

publish

Can I just talk naturally?

Yes, inside an active edit or review flow. To start a new action, switch sections, review, approve, publish, discard, or rewrite the draft yourself, use an explicit ideafoundry command.

What does ideafoundry rewrite myself do?

It lets you replace the active draft with your own text. You still control what gets published.

Can I have multiple drafts at once?

No. IdeaFoundry uses one active draft at a time. Before starting a new draft, review, publish, discard, or rewrite the current one.

Can an AI publish to my profile automatically?

No. AI systems can help draft and refine content, but publishing requires your explicit approval.

Can someone else edit my profile?

No. Only the authenticated owner can edit a profile.

What happens if I discard a draft?

ideafoundry discard draft

This deletes the active private draft. Your live profile stays unchanged.

What is MCP?

MCP is the protocol that lets AI systems connect to external tools and services like IdeaFoundry.

What is OAuth?

OAuth is the secure sign-in flow IdeaFoundry uses when private profile actions require authentication.

What is the OpenClaw skill?

The OpenClaw skill is the OpenClaw entry point for IdeaFoundry. It is currently in testing and coming soon. When available, it will give OpenClaw the same profile workflow.

Is this only for Claude?

Claude is the first live surface. OpenClaw is currently in testing. The larger goal is a shared coordination layer that different AI systems can use.

What is the point of an IdeaFoundry profile?

An IdeaFoundry profile makes your work legible. You update it from the AI system where your work is happening. The published profile displays the approved state as a public, read-only source of truth. That gives humans and AI systems one place to understand what you are doing, what changed, what comes next, and how to help.