AI Memory Workspace Setup
Starter kit
First committed by Fryingpannn
Published in Fryingpannn/ai-memory-workspace-starter. Publisher page
21 GitHub stars
What it is
A Hermes-friendly, files-first AI memory workspace that survives fresh chats.
AutoGineer overview, from the brain’s own files
ai-memory-workspace-starter provides a structured, agent-driven installation process to establish a persistent memory workspace within a user's existing file system. Designed to be platform-agnostic, it uses a set of templates and setup prompts to scaffold a workspace that survives individual chat sessions. The system focuses on creating a canonical structure including a user profile, a wiki, and project-specific directories, ensuring that AI agents can maintain context across different sessions without relying on proprietary cloud storage.
How it works
Memory model: Markdown vault
AutoGineer overview, from the brain’s own files
The system functions as a temporary setup utility. When triggered by an agent, it reads the setup instructions in the docs folder and uses the prompts in the prompts/setup folder to guide the user through a multi-stage installation. It copies missing files from the templates/workspace folder into the user's designated workspace directory, creating a standard structure of folders like projects, skills, outputs, and wiki. It also initializes a root USER.md file and a fused AGENTS.md file to serve as the primary knowledge entry points for the agent.
| Folder | Role | Files |
|---|---|---|
| docs | docs | 2 |
| prompts | agent-instructions | 9 |
| templates | templates | 18 |
The agent reads
- SETUP.md evidence: AGENTS.md
- prompts/setup/ evidence: AGENTS.md
- AGENTS.md evidence: README.md
The agent writes
- AGENTS.md evidence: AGENTS.md
Requirements
Works with: Claude Code, OpenAI Codex, GitHub Copilot, Cursor, Kiro, OpenCode, Amp, Cline, JetBrains Junie, Devin (ex-Windsurf)
Set it up
- Download the brain as a ZIP and unzip it where you keep your notes or project: https://mp-staging.autogineer.com/agent-brains/fryingpannn/ai-memory-workspace-starter/download
Claude Code reads CLAUDE.md from this folder automatically.
cd ai-memory-workspace-starter && claude
AutoGineer scanned these files at commit cf26138.
First committed by Fryingpannn. Published in Fryingpannn/ai-memory-workspace-starter. Licence: MIT License.
Usage
AutoGineer overview, from the brain’s own files
- Scaffolding a new persistent memory workspace for an existing AI agent.
- Standardizing memory structures across multiple agent-enabled projects.
- Integrating a portable wiki and user profile into an existing file-based development environment.
- “Set up my AI memory workspace from this repository.”
- The agent will initiate the setup flow, confirm the workspace location, and scaffold the necessary folders and files.
- “Verify my workspace memory.”
- The agent will run the acceptance test defined in the workspace to ensure the memory structure is correctly linked and accessible.
Documentation by Fryingpannn
AI Memory Workspace Setup
An agent-run installer for adding portable, files-first memory to a new or existing outer workspace.
This repository is not the user's workspace. The user's existing file-aware agent reads
SETUP.md, temporarily downloads this package when needed, and installs only the
missing scaffold files from templates/workspace/.
One Setup Prompt
Paste this into the agent you already use:
Set up my AI memory workspace from this repository:
https://github.com/Fryingpannn/ai-memory-workspace-starter
Start with SETUP.md. Use this repository only as temporary setup instructions and a
template source; do not turn its clone into my workspace.The setup manager asks whether an outer workspace already exists. It uses that folder or creates one after approval. Existing projects stay in place.
What This Package Contains
SETUP.md: the only setup entrypoint.prompts/setup/: short, ordered setup stages.prompts/VERIFY-WORKSPACE.md: fresh-session acceptance test.prompts/CONNECT-INNER-PROJECTS.md: optional reviewed bridge for child-project instruction files.templates/workspace/: missing-only files for the user's outer workspace.docs/: reference material for the setup agent and implementing user.
The temporary clone is removed after verification and the final handoff. Its Git history and remote are never copied into the user's workspace.
Setup Flow
Confirm or create the outer workspace.
Copy only missing supporting files from
templates/workspace/.Build the portable root
USER.md.Build the interlinked
wiki/.Analyze approved existing child projects read-only.
Create or review a fused canonical
AGENTS.md.Review or initialize the outer Git repository.
Prove retrieval from a fresh session.
Deliver the optional inner-project bridge prompt, then remove the temporary setup clone.
Ownership Boundaries
The portable workspace owns:
root
USER.md;the
CLAUDE.mdcompatibility bridge;projects/,skills/,outputs/, andwiki/.
Existing target files are preserved except for a user-confirmed replacement of
AGENTS.md with its reviewed fused proposal. Git initialization, commits, remote
creation, and pushes remain approval-gated.
This installer uses the file-aware agent the user already has. Installing another harness is a separate optional workflow.
SETUP.md
AI Memory Workspace Setup Manager
This is the only setup entrypoint the user needs.
Read one stage at a time. Keep the user's current file-aware agent as the manager for the entire setup.
User Prompt
Set up my AI memory workspace from this repository:
https://github.com/Fryingpannn/ai-memory-workspace-starter
Start with SETUP.md. Use this repository only as temporary setup instructions and a
template source; do not turn its clone into my workspace.Goal
Turn one outer folder into a files-first memory workspace without moving or rewriting its existing projects.
This repository supplies instructions and missing-file templates. Its clone is never the user's personalized workspace.
Global Rules
Ask only questions the current stage cannot answer safely.
Keep the user's current agent as setup manager for the entire workflow.
Never replace existing content except the explicitly reviewed
AGENTS.mdfusion in Stage 6. Use only reviewed, targeted edits.Never move or edit an existing project during setup.
Never read secrets, generated dependencies, or broad source trees.
Show proposed changes before editing an existing
USER.md,AGENTS.md, orCLAUDE.md.Ask before initializing Git, committing, creating a remote, or pushing.
Do not support scattered projects in the guided setup. They can be connected later.
Read only the next routed prompt.
Stage 0: Make the Starter Available
If this repository is not already available locally, clone it into an agent-created temporary staging directory.
Do not clone it over the user's outer folder.
Do not personalize the staging clone.
Keep its Git history and remote separate from the user's workspace.
Record the staging path for the entire setup workflow.
If this repository was already cloned directly into an originally empty working folder:
Stop before personalization.
Confirm no user files were displaced.
Move that clone to an agent-created temporary staging path.
Restore the original empty folder as the candidate outer workspace.
If prior contents are uncertain, stop and ask instead of moving anything.
Routed Workflow
Follow these prompts in order:
prompts/setup/01-CHOOSE-WORKSPACE.mdprompts/setup/02-SCAFFOLD-WORKSPACE.mdprompts/setup/03-ONBOARD-USER.mdprompts/setup/04-BUILD-WIKI.mdprompts/setup/05-ANALYZE-PROJECTS.md, only when projects already existprompts/setup/06-FINALIZE-AGENTS.mdprompts/setup/07-INITIALIZE-GIT.mdprompts/VERIFY-WORKSPACE.mdprompts/CONNECT-INNER-PROJECTS.md
The manager owns user questions and approval gates. Spawn clean-context subagents only where a stage explicitly requests them. If subagents are unavailable, execute that stage in isolation and avoid unrelated context.
After Stage 1, use the confirmed outer workspace as the working directory and project root for every remaining stage. Continue reading routed prompts from the staging clone.
Completion
Setup is complete when:
one outer workspace root is confirmed;
missing skeleton files exist without replacing prior work;
a missing
AGENTS.mdwas created from the template, or an existing file was replaced only after the user approved a complete fused proposal;user onboarding completed or was explicitly declined;
a reviewed root
USER.mdexists or onboarding was explicitly declined;wiki/has an index, schema, log, raw-source area, and interlinked pages;approved existing projects have sourced wiki entries;
memory routing is present or was explicitly declined;
the outer workspace is a Git repository;
project profiles match final live Git paths, remotes, and connection modes;
the user has reviewed all changes;
a fresh session can retrieve user context and sourced knowledge through
USER.mdandwiki/index.md;the optional inner-project memory-bridge prompt was delivered without editing child projects;
the agent-created temporary setup clone was removed after verification and the final handoff.
Installing another harness is outside this setup. It can be added to the completed workspace later without changing the workspace structure.
36 files
- .gitignore
- AGENTS.md
- ATTRIBUTION.md
- CLAUDE.md
- LICENSE
- README.md
- SETUP.md
- docs/GIT-AND-GITHUB.md
- docs/TROUBLESHOOTING.md
- prompts/CONNECT-INNER-PROJECTS.md
- prompts/VERIFY-WORKSPACE.md
- prompts/setup/01-CHOOSE-WORKSPACE.md
- prompts/setup/02-SCAFFOLD-WORKSPACE.md
- prompts/setup/03-ONBOARD-USER.md
- prompts/setup/04-BUILD-WIKI.md
- prompts/setup/05-ANALYZE-PROJECTS.md
- prompts/setup/06-FINALIZE-AGENTS.md
- prompts/setup/07-INITIALIZE-GIT.md
- templates/workspace/.gitignore
- templates/workspace/AGENTS.md
- templates/workspace/CLAUDE.md
- templates/workspace/README.md
- templates/workspace/USER.md
- templates/workspace/outputs/README.md
- templates/workspace/projects/README.md
- templates/workspace/projects/index.md
- templates/workspace/projects/local-paths.example.md
- templates/workspace/projects/project-template.md
- templates/workspace/skills/README.md
- templates/workspace/wiki/SCHEMA.md
- templates/workspace/wiki/inbox.md
- templates/workspace/wiki/index.md
- templates/workspace/wiki/log.md
- templates/workspace/wiki/pages/decisions.md
- templates/workspace/wiki/pages/workspace-profile.md
- templates/workspace/wiki/raw/README.md
Advantages
- Ensures memory persistence across fresh agent sessions by using a file-based vault structure. evidence: README.md
- Preserves existing project files by only installing missing scaffold components. evidence: README.md
Limitations
- Requires an existing file-aware agent to execute the setup process. evidence: README.md
- The installer repository itself is not a workspace and must be removed after setup. evidence: AGENTS.md
Security
Risk level: No risk found
This brain runs
This brain runs nothing: AutoGineer found no hooks, scripts, plugin code or MCP servers in its files.
Attribution and licence
- First committed by
Fryingpannn
- Publisher
- Duke Pan (Community)
- Source
- Fryingpannn/ai-memory-workspace-starter · commit cf26138
- Licence
- MIT License (files served here)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
- Contributors
- Fryingpannn
AutoGineer is not affiliated with or endorsed by Fryingpannn.
Download
The ZIP holds the files AutoGineer serves, with ATTRIBUTION.md and the licence. Download ai-memory-workspace-starter.zip