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

# 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

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

| File | Purpose | When to Update | |------|---------|----------------| | SOUL.md | Who the agent is, principles, boundaries | When identity evolves | | USER.md | Who you are, your goals and preferences | As you share more context | | AGENTS.md | Operating rules and workflows | When patterns emerge | | TOOLS.md | Tool configurations and notes | When learning tool usage | | SESSION-STATE.md | Current task and context | Continuously (WAL protocol) | | HEARTBEAT.md | Periodic check checklist | Review regularly | | MEMORY.md | Curated long-term wisdom | Periodically 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

| PARA | Proactive Agent | Integration | |------|-----------------|-------------| | Project notes | 1-projects/X/notes.md | Agent can read/write | | Decisions | SESSION-STATE.md | WAL protocol captures | | Daily work | memory/YYYY-MM-DD.md | Automatic logging | | Learnings | .learnings/LEARNINGS.md | Error/learning capture | | Archives | 4-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. 🧠🦞