Skip to content

docs(features): add Charlie personal-assistant pattern doc#26

Merged
melvincarvalho merged 1 commit into
mainfrom
issue-25-charlie-doc
Jun 6, 2026
Merged

docs(features): add Charlie personal-assistant pattern doc#26
melvincarvalho merged 1 commit into
mainfrom
issue-25-charlie-doc

Conversation

@melvincarvalho
Copy link
Copy Markdown
Contributor

Closes #25

Adds docs/features/charlie.md as the narrative/architectural complement to the existing MCP feature doc. Plus a one-line sidebars.ts update placing features/charlie right after features/mcp so the agent-integration docs read as a coherent series.

What's in the doc

  • Lineage: TBL's 2017 Charlie vision, Inrupt's 2024 prototype, the 2026 substrate that exists today.
  • Stack inventory: what's running today (JSS pod + MCP client + open-weights model + WAC consent layer).
  • The interaction trace: verbatim quotes from an actual session , the agent recognising the Charlie pattern, probing for access, examining the ACLs, comprehending its scope. Centerpiece of the doc.
  • The architectural thesis: consent as a language the agent reads, not a fence it runs into. Distinguishes scoped-consent-with-comprehension from access-control-as-barrier.
  • Starter SKILL.md template for /private/bots/charlie/SKILL.md.
  • Forward roadmap: per-agent scoped credentials, agent-to-agent flows, federated agent communication via call_remote_pod.

How it relates to the MCP doc

This is the pattern doc , the what and why. The MCP doc remains the technical reference , the how (connection, tools, per-client recipes, bot layout in How Charlie works). The Charlie doc cross-links explicitly to the MCP doc's How Charlie works section so readers can move from pattern → mechanics without duplication.

The two together form a layered agent-integration surface: MCP for any client, Charlie for the personal-assistant pattern.

Adds docs/features/charlie.md as the narrative/architectural complement
to the MCP doc. Covers the TBL 2017 / Inrupt 2024 lineage, the WAC-as-
language thesis, a verbatim agent-meets-WAC interaction trace, and a
starting SKILL.md template.

The MCP doc remains the technical reference (connection, tools, per-
client recipes, layout). Charlie doc is the pattern and demonstration.

Sidebars updated to place 'features/charlie' immediately after
'features/mcp' so the agent-integration docs read as a coherent series.

Closes #25
@melvincarvalho melvincarvalho merged commit d4437da into main Jun 6, 2026
@melvincarvalho melvincarvalho deleted the issue-25-charlie-doc branch June 6, 2026 18:33
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.

Add Charlie feature doc: the personal-assistant pattern

1 participant