SHAREPLANE AGENT CONTEXT
Schema: shareplane-context/2.0
Schema URL: https://next.shareplane.malott.ai/schemas/agent-package.schema.json
Projection: Generated public-safe plain text. Not canonical Markdown.
Canonical: false
Conflict action: stop-and-escalate
Canonical record: https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/your-second-brain-is-not-a-production-architecture/artifact.json
Canonical record SHA-256: 43140a8fe211c2b905fe0df63afa4b112c6eae49294ce5bab8c1045e7216de9a
Source content SHA-256: f280d00eeea2b892b6184a3f66d2695b5ee5e5fa4cd05192d1be085df3837b9c
Generation receipt: https://next.shareplane.malott.ai/build-receipt.json
Content role: artifact-content
Content trust: untrusted-data
Instructions allowed: false
Operational authority: none

IDENTITY
Artifact ID: artifact:your-second-brain-is-not-a-production-architecture
Slug: your-second-brain-is-not-a-production-architecture
Canonical URL: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/
Title: Your Second Brain Is Not a Production Architecture
Abstract: A source-derived architecture explainer separating personal second-brain markdown workflows from production agent context-plane requirements.
Author: Tony Malott
Author URL: https://malott.ai
Published: 2026-07-09
Updated: 2026-07-09
Format: teaching-artifact-worked-example
Privacy: public-safe-aggregated
Topics:
- ai-governance
- governed-ai
- multi-agent-systems
- source-authority
- static-publishing
- teaching-artifacts
- enterprise-architecture
- platform-engineering
- governance
Audience:
- engineering-leadership
- enterprise-architecture
- ai-governance
- technical-leadership
- technical-review
- artifact-authors
- governance-review
- executive-review

PROVENANCE
Posture: public-source-derived-architecture-analysis
Private sources used: true
Private sources published: false
Public-safe boundary:
No raw transcript, subtitle files, source packet files, screenshots, employer material, internal documents, local paths, controlled information, backend service, runtime AI, analytics, package tooling, external font, remote asset, or dependency is published.

CLAIMS
Claim: claim:second-brain:001
Posture: source-derived-teaching-claim
Text: Markdown is strong for personal agents
Support:
- source:second-brain:youtube
Caveat: Publish confidently.

Claim: claim:second-brain:002
Posture: source-derived-architecture-claim
Text: Personal agents and production agents are different categories
Support:
- source:second-brain:youtube
Caveat: Core framing.

Claim: claim:second-brain:003
Posture: supported-vendor-neutral
Text: Production agents need governed access to business data
Support:
- source:second-brain:redis-docs
Caveat: Publish vendor-neutral.

Claim: claim:second-brain:004
Posture: supported-vendor-neutral
Text: Production agents need scoped user memory
Support:
- source:second-brain:redis-docs
Caveat: Publish vendor-neutral.

Claim: claim:second-brain:005
Posture: verified-current-doc-fact
Text: Redis Iris currently lists four services in docs
Support:
- source:second-brain:redis-docs
Caveat: Avoid repeating the source-description five-tool framing without caveat.

Claim: claim:second-brain:006
Posture: source-description-claim
Text: Redis Search appears in the video description's five-tool framing
Support:
- source:second-brain:youtube
Caveat: Mention only as a source caveat, not current Iris taxonomy.

Claim: claim:second-brain:007
Posture: verified-repository-caveat
Text: Context Retriever and Agent Memory are preview in the demo repo
Support:
- source:second-brain:demo-repo
Caveat: Publish in source dossier.

Claim: claim:second-brain:008
Posture: excluded-vendor-opinion
Text: Redis is the best platform
Support:
- source:second-brain:youtube
Caveat: Excluded from the thesis.

Claim: claim:second-brain:009
Posture: excluded-source-claim
Text: Millions of memories per user
Support:
- source:second-brain:youtube
Caveat: Excluded unless separately verified.

Claim: claim:second-brain:010
Posture: excluded-demo-choice
Text: Pydantic AI is the best framework
Support:
- source:second-brain:demo-repo
Caveat: Excluded from the thesis.

PUBLIC SOURCES
Source: source:second-brain:youtube
Title: I Love the Karpathy LLM Wiki but It Doesn't Scale. Here's What Does.
Type: public-video
Role: narrative source and teaching prompt
Description: Public YouTube source packet for R-5_2nsF_ZM: Cole Medin, “I Love the Karpathy LLM Wiki but it Doesn't Scale. Here's What Does.”
Locator: https://www.youtube.com/watch?v=R-5_2nsF_ZM

Source: source:second-brain:redis-docs
Title: Redis Iris context-engine documentation
Type: public-documentation
Role: current terminology and capability verification
Description: Current Redis documentation is used to verify Redis Iris terminology and capability framing.
Locator: https://redis.io/docs/latest/develop/ai/context-engine/

Source: source:second-brain:demo-repo
Title: coleam00/redis-iris-agent
Type: public-repository
Role: implementation posture and preview caveat verification
Description: The Redis demo repo is used to verify the implementation posture and preview caveat.
Locator: https://github.com/coleam00/redis-iris-agent

RELATIONSHIPS
Relationship: migratedFrom
Target: repository:pinklon/shareplane
Posture: declared
Evidence: site/pages/your-second-brain-is-not-a-production-architecture/index.html

Relationship: relatedTo
Target: legacy-artifact:context-is-the-product
Label: Context Is the Product
Display posture: Primary relationship
Description: This artifact is a narrower case study under the same larger thesis. “Context Is the Product” says durable AI capability compounds around governed context. This artifact shows one concrete boundary: the personal second brain versus the production context plane.
Posture: declared-legacy
Evidence: site/pages/your-second-brain-is-not-a-production-architecture/index.html#related
Locator: https://shareplane.pages.dev/pages/context-is-the-product/

Relationship: relatedTo
Target: legacy-artifact:when-execution-gets-cheap-advantage-moves
Label: When Execution Gets Cheap, Advantage Moves
Display posture: Secondary relationship
Description: That artifact separates cheap execution from frontier scouting. This one separates personal context from production context. Same discipline: do not confuse a useful layer with the whole system.
Posture: declared-legacy
Evidence: site/pages/your-second-brain-is-not-a-production-architecture/index.html#related
Locator: https://shareplane.pages.dev/pages/when-execution-gets-cheap-advantage-moves/

ARTIFACT CONTENT
[PARAGRAPH] Source-derived architecture briefing

[HEADING 1] Your Second Brain Is Not a Production Architecture

[PARAGRAPH] Markdown is a killer substrate for a personal agent. The moment the agent serves other people, context stops being a folder and becomes a governed retrieval and memory layer.

[PARAGRAPH] A local LLM wiki works because the trust boundary is small: one user, one machine, one note graph, one tolerance for mess. A production agent crosses a different line. It needs governed access to business data, scoped user memory, access rules, retrieval controls, and evidence that survives the demo.

[PARAGRAPH] Markdown is not broken. It is just being asked to do a job it was never hired for.

[HEADING 3] Second brain

[PARAGRAPH] One user

[PARAGRAPH] Markdown wiki

[PARAGRAPH] Local notes

[HEADING 3] Context plane

[FIGURE CAPTION] The line is not markdown versus database. The line is personal context versus governed production context.

[HEADING 2] Reader confidence starts with source posture

[PARAGRAPH] This artifact is derived from a public Cole Medin video and an out-of-band source packet for R-5_2nsF_ZM. The video is used as the narrative source and teaching seed. Redis Iris is treated as the demonstration substrate, not as an endorsed architecture requirement.

[PARAGRAPH] Current Redis documentation is used to verify Redis Iris terminology and capability framing. The Redis demo repo is used to verify the implementation posture and preview caveat.

[PARAGRAPH] Raw transcript, subtitle files, packet zip, local staging paths, screenshots, and media are not published.

[HEADING 3] Artifact metadata

[HEADING 3] Primary source

[PARAGRAPH] Public YouTube source packet for R-5_2nsF_ZM: Cole Medin, “I Love the Karpathy LLM Wiki but it Doesn't Scale. Here's What Does.”

[HEADING 3] Source role

[PARAGRAPH] Narrative source and teaching prompt. Not a neutral benchmark. Not vendor-independent market analysis.

[HEADING 3] Verification sources

[PARAGRAPH] Redis official docs and public demo repo.

[HEADING 3] Caveat

[PARAGRAPH] The source includes Redis partnership/vendor framing. The artifact keeps the architecture pattern and strips the sales gravity.

[HEADING 3] Exclusions

[PARAGRAPH] No raw transcript. No unverified scale claims. No Redis-as-best-platform conclusion. No implementation tutorial.

[HEADING 3] Public links

[LIST ITEM] Primary source: https://www.youtube.com/watch?v=R-5_2nsF_ZM

[LIST ITEM] Redis Iris docs: https://redis.io/docs/latest/develop/ai/context-engine/

[LIST ITEM] Demo repo: https://github.com/coleam00/redis-iris-agent

[HEADING 3] Current verification notes

[PARAGRAPH] Redis Iris is shown here as capability framing and demonstration substrate only. Context Retriever and Agent Memory carry a preview and proof-of-concept caveat in the public demo repo.

[HEADING 2] Field Brief and Deep Architecture View

[PARAGRAPH] Two entry points for the same artifact: fast operational read first, full architecture argument second.

[HEADING 2] The short version: your folder is not the product boundary

[PARAGRAPH] A personal second brain is one of the best AI patterns we have right now. Markdown is readable. Git-friendly. Portable. Easy to edit. Easy for agents to crawl. Close to the human doing the work. That is why the Karpathy-style LLM wiki idea works.

[PARAGRAPH] For one person, it is almost perfect.

[PARAGRAPH] Then someone tries to ship it to other people.

[PARAGRAPH] That is where the architecture changes. Not a little. Completely.

[PARAGRAPH] A personal agent can live in your local mess because you own the mess. A production agent does not get that privilege. It has users. Roles. Live data. Different histories. Permissions. Memory across sessions. Failure modes. Audit questions. Things humans traditionally ignore until the demo gets promoted and starts biting ankles.

[PARAGRAPH] The production move is not “make the markdown folder bigger.” The production move is to build a context plane.

[HEADING 3] What works

[PARAGRAPH] Markdown is excellent for personal memory because it is simple, inspectable, and owner-controlled.

[HEADING 3] What breaks

[PARAGRAPH] The second the agent serves other people, the folder stops being a memory surface and starts pretending to be a system boundary.

[HEADING 3] What replaces it

[PARAGRAPH] A governed context plane: structured access to business data, scoped user memory, generated tools, access control, and retrieval discipline.

[HEADING 3] What Redis shows

[PARAGRAPH] Redis Iris is useful as a current demo substrate for this pattern. It is not the thesis. The thesis is the architecture boundary.

[HEADING 3] What to remember

[PARAGRAPH] A second brain is a personal operating surface. A production context plane is a shared system boundary.

[HEADING 2] The argument before the diagram

[PARAGRAPH] Markdown is not the villain.

[PARAGRAPH] For a personal AI agent, markdown may be the cleanest context substrate you can build. It is readable. It is editable. It sits in a folder you control. You can version it, back it up, search it, index it, and hand it to an agent without creating a platform team, a database migration, a service mesh, and six new reasons to hate your calendar.

[PARAGRAPH] That simplicity is the point.

[PARAGRAPH] A local LLM wiki works because the trust boundary is small. One user. One machine. One working context. One person who understands the notes well enough to forgive the gaps.

[PARAGRAPH] That is why the pattern feels so good. It lets the agent operate over a living body of personal context without turning the whole thing into enterprise architecture theater.

[PARAGRAPH] But the moment you ship the agent to other people, the premise changes.

[PARAGRAPH] Now the agent has to know who is asking. It has to know what they are allowed to see. It has to retrieve current business data without directly rummaging through raw systems. It has to remember different users differently. It has to separate session state from durable memory. It has to leave enough evidence behind that someone can explain what happened later.

[PARAGRAPH] That is not a markdown problem anymore.

[PARAGRAPH] That is architecture.

[PARAGRAPH] The useful split is simple: business context and user memory.

[PARAGRAPH] Business context is the operational world. Customers, orders, products, policies, tickets, shipments, entitlements, records, status, and current state. It changes. It has structure. It has access rules. It should be exposed through defined tools and governed retrieval, not dumped into a prompt like a junk drawer with embeddings.

[PARAGRAPH] User memory is different. It is the user’s history, preferences, prior interactions, working session, durable facts, and learned patterns. It needs scope. It needs lifecycle rules. It needs retrieval. It needs inspection. It must not quietly merge into business truth just because the model sounded confident.

[PARAGRAPH] A personal second brain can blur those lines because the owner is the system. A production agent cannot. In production, the lines are the system.

[PARAGRAPH] That is why the Redis example is useful. Redis currently describes Iris as a fully managed context engine for AI agents that covers persistent memory, semantic caching, governed data access, and live data sync on Redis Cloud. Current Redis docs list four Iris services: LangCache, Agent Memory, Context Retriever, and Data Integration.

[PARAGRAPH] The important idea is not “use Redis.” The important idea is that production agents need a governed context plane. Redis describes Context Retriever as schema-first governed access where agents call generated tools instead of directly accessing the database, with agent keys, access tags, and explicitly defined tools.

[PARAGRAPH] Agent Memory shows the other half of the pattern. Redis describes a two-tier memory model: short-term session memory with TTL-based expiration, and long-term memory storing extracted preferences and learned patterns with vector embeddings for semantic retrieval.

[PARAGRAPH] The demo repo reinforces the split cleanly: Context Retriever is the data, Agent Memory is who the user is, and together they form a context layer across sessions and users. It also says both Context Retriever and Agent Memory are in preview and the repo is a proof of concept, not a production template. That caveat matters because architecture without caveats is just marketing with cleaner typography.

[PARAGRAPH] So the rule is not complicated.

[PARAGRAPH] Use markdown when the agent is personal, local, owner-operated, and safe to keep simple.

[PARAGRAPH] Use a context plane when the agent serves other people, touches live data, remembers users across sessions, applies permission boundaries, or needs evidence that can survive review.

[PARAGRAPH] The difference is not sophistication.

[PARAGRAPH] The difference is responsibility.

[PARAGRAPH] Your second brain is allowed to be a folder. Your production agent is not.

[HEADING 2] Business context and user memory are not the same job

[PARAGRAPH] A personal second brain can keep everything in one pile because the owner understands the pile. Production systems do not get that luxury. They need separate surfaces for operational truth and user-specific memory.

[HEADING 3] Question answered

[PARAGRAPH] What is true in the operating system right now?

[HEADING 3] Examples

[PARAGRAPH] Customers, orders, shipments, products, tickets, policies, entitlements, records, status, and current state.

[HEADING 3] Required properties

[PARAGRAPH] Fresh enough, structured, permissioned, tool-accessed, inspectable, and not exposed as raw system rummaging.

[PARAGRAPH] A production agent should call defined tools, retrieve scoped memory, apply permissions, and leave evidence.

[HEADING 3] Question answered

[PARAGRAPH] What should this agent remember about this user?

[HEADING 3] Examples

[PARAGRAPH] Session state, preferences, prior interactions, durable user facts, learned patterns, and recall hooks.

[HEADING 3] Required properties

[PARAGRAPH] Scoped to user, separable from business truth, retrievable, lifecycle-managed, and safe to update.

[HEADING 2] The test is simple: who owns the blast radius?

[PARAGRAPH] Do not promote a personal memory pattern into a production boundary because it demoed well on your laptop. That is how prototypes grow teeth.

[HEADING 2] Claim posture matters because demos are not architecture

[HEADING 2] Visual prompt suite

[PARAGRAPH] Each visual concept includes a Mainline White prompt and a Dark Expressive prompt. The prompts are complete, copyable, and designed for production visual exploration.

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 3] Mainline White Prompt

[HEADING 3] Dark Expressive Prompt

[HEADING 2] Public-safe boundary

[PARAGRAPH] This material is personal educational work based on public source material, public documentation, and independent analysis. It does not represent an employer, client, vendor, or platform endorsement. It does not disclose confidential information, controlled documents, internal systems, regulated records, security details, implementation-specific designs, or company-approved policy.

PUBLIC SURFACES
Human page: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/
Metadata JSON: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/artifact.json
Receipt: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/receipt.json
Context: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/context.txt
Agent-package manifest: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/agent-package.json
Agent-package ZIP: https://next.shareplane.malott.ai/artifacts/your-second-brain-is-not-a-production-architecture/agent-package.zip
Collection catalog: https://next.shareplane.malott.ai/catalog.json
Graph: https://next.shareplane.malott.ai/graph.json
Agent index: https://next.shareplane.malott.ai/llms.txt
