PARA + Proactive Agent Workspace 🦞📁#

A production-ready workspace template that combines two powerful systems:

1. PARA Method (Tiago Forte) - For organizing your content
2. Proactive Agent Architecture (Hal Labs) - For AI memory and continuity

What You Get#

PARA Structure#

• 1-projects/ - Active projects with deadlines
• 2-areas/ - Ongoing responsibilities
• 3-resources/ - Reference materials
• 4-archives/ - Completed projects
• +inbox/ - Temporary inbox (process weekly)
• +temp/ - Scratch space

Proactive Agent Memory#

• memory/ - Daily logs and working buffer
• .learnings/ - Error logs and learnings
• SESSION-STATE.md - Active working memory
• AGENTS.md - Operating rules
• SOUL.md - Agent identity
• USER.md - Your profile
• HEARTBEAT.md - Periodic checks

Installation#

bash

# Create workspace directory
mkdir -p ~/workspace
cd ~/workspace

# Copy template files
cp -r ~/.openclaw/skills/para-proactive-workspace/assets/templates/* .

# Or manually create structure following the guide below

Directory Structure#

text

workspace/
│
├── 📁 1-projects/          # Active projects
│   └── project-name/
│       ├── README.md
│       ├── notes.md
│       ├── docs/
│       └── assets/
│
├── 📁 2-areas/             # Ongoing responsibilities
│   ├── health/
│   ├── finance/
│   └── learning/
│
├── 📁 3-resources/         # Reference materials
│   ├── articles/
│   ├── books/
│   └── templates/
│
├── 📁 4-archives/          # Completed items
│   └── 2024-projects/
│
├── 📁 +inbox/              # Temporary inbox
├── 📁 +temp/               # Scratch space
│
├── 📁 .agents/             # Agent configuration
├── 📁 .learnings/          # Learning logs
│   ├── ERRORS.md
│   ├── LEARNINGS.md
│   └── FEATURE_REQUESTS.md
│
├── 📁 memory/              # Daily logs
│   └── working-buffer.md
│
├── 📄 AGENTS.md            # Operating rules
├── 📄 HEARTBEAT.md         # Periodic checklist
├── 📄 MEMORY.md            # Long-term memory
├── 📄 ONBOARDING.md        # First-run setup
├── 📄 README.md            # Workspace overview
├── 📄 SESSION-STATE.md     # Active task state
├── 📄 SOUL.md              # Agent identity
├── 📄 TOOLS.md             # Tool configurations
├── 📄 USER.md              # Your profile
└── 📄 .gitignore           # Git ignore rules

PARA Method Explained#

Projects (1-projects/)#

Definition: A series of tasks linked to a goal, with a deadline.

Examples:

• Complete website redesign (due March 1)
• Plan vacation to Japan (departing April 15)
• Launch product feature (Q2 goal)

When to move to archives: When completed or cancelled.

Areas (2-areas/)#

Definition: A sphere of activity with a standard to be maintained over time.

Examples:

• Health & Fitness
• Personal Finance
• Professional Development
• Relationships
• Home Maintenance

When to move to archives: When no longer relevant to your life.

Resources (3-resources/)#

Definition: A topic or theme of ongoing interest.

Examples:

• Gardening tips
• Python programming
• Travel destinations
• Recipes
• Book notes

When to move to archives: When no longer interested.

Archives (4-archives/)#

Definition: Inactive items from the other three categories.

Purpose: Keep out of sight but accessible for reference.

Proactive Agent Architecture Explained#

Core Files#

FilePurposeWhen to UpdateSOUL.mdWho the agent is, principles, boundariesWhen identity evolvesUSER.mdWho you are, your goals and preferencesAs you share more contextAGENTS.mdOperating rules and workflowsWhen patterns emergeTOOLS.mdTool configurations and notesWhen learning tool usageSESSION-STATE.mdCurrent task and contextContinuously (WAL protocol)HEARTBEAT.mdPeriodic check checklistReview regularlyMEMORY.mdCurated long-term wisdomPeriodically distill

Memory System#

Three-tier memory:

1. SESSION-STATE.md - Active working memory (current session)
2. memory/YYYY-MM-DD.md - Daily raw logs
3. MEMORY.md - Curated long-term wisdom

WAL Protocol (Write-Ahead Logging):

• Corrections → Write immediately
• Decisions → Write immediately
• Names/Preferences → Write immediately
• Specific values → Write immediately

Working Buffer:

• Activates at 60% context usage
• Captures every exchange
• Survives context compaction

Usage Workflows#

Daily Workflow#

1. Capture → Drop files into +inbox/
2. Process → Sort inbox into PARA folders
3. Work → Create/update projects
4. Log → Agent writes to memory/

Weekly Review#

1. Clear +inbox/ and +temp/
2. Review 2-areas/ for maintenance
3. Archive completed projects
4. Check .learnings/ for patterns

Monthly Review#

1. Clean 4-archives/
2. Review 3-resources/ for relevance
3. Update MEMORY.md with distilled learnings

Integration Points#

PARA ↔ Proactive Agent#

PARAProactive AgentIntegrationProject notes1-projects/X/notes.mdAgent can read/writeDecisionsSESSION-STATE.mdWAL protocol capturesDaily workmemory/YYYY-MM-DD.mdAutomatic loggingLearnings.learnings/LEARNINGS.mdError/learning captureArchives4-archives/Completed projects

Best Practices#

For You (Human)#

• Process +inbox/ weekly (Inbox Zero)
• Keep +temp/ clean daily
• Use consistent naming conventions
• Review areas monthly

For Your Agent#

• Read SOUL.md + USER.md on startup
• Use WAL protocol for critical details
• Log errors to .learnings/ERRORS.md
• Review HEARTBEAT.md periodically

Credits#

• PARA Method: Tiago Forte (Building a Second Brain)
• Proactive Agent: Hal Labs (@halthelobster)
• Integration: OpenClaw Community

License#

MIT - Use freely, modify, share.

---

Organize your content. Empower your agent. Build your second brain. 🧠🦞