PARA Workspace — Workflows Reference
Version: 1.6.2 | Last reviewed: 2026-03-24
Overview
Workflows are standardized operational flows (Document Instructions) designed specifically for AI Agents. These flows clearly define step-by-step how the AI Agent must interact with the user and the core system to complete a specific task without breaking the Kernel architecture.
Version Table
Source of truth:
repo/templates/common/agent/workflows/catalog.yml
| Workflow | Slash Command | Version | Kernel Min | Notes |
|---|---|---|---|---|
| Session Open | /open | 1.5.0 | 1.6.2 | Unified Agent Index, skills loading (v1.6.2) |
| Session End | /end | 1.5.1 | 1.6.2 | Pre-flight re-read rules+skills (v1.6.2) |
| Plan Controller | /plan | 1.5.0 | 1.6.2 | Pre-flight, D3 skills check (v1.6.2) |
| Documentation Manager | /docs | 1.1.1 | 1.6.2 | Pre-flight (v1.6.2) |
| Brainstorm | /brainstorm | 1.0.0 | 1.5.3 | |
| Backlog Controller | /backlog | 1.3.1 | 1.6.2 | Pre-flight (v1.6.2) |
| New Project | /new-project | 1.1.0 | 1.6.0 | Ecosystem type support |
| Verify Task | /verify | 1.0.0 | 1.4.0 | |
| Push | /push | 1.0.1 | 1.6.2 | Pre-flight (v1.6.2) |
| Release Gate | /release | 1.0.1 | 1.6.2 | Pre-flight (v1.6.2) |
| Semantic Merge | /merge | 1.0.0 | 1.4.0 | |
| Project Retrospective | /retro | 1.0.1 | 1.6.2 | Pre-flight (v1.6.2) |
| Install / Sync | /install | 1.0.0 | 1.4.0 | |
| Safe Update | /update | 1.1.0 | 1.4.0 | |
| Macro Assessor Audit | /para-audit | 1.3.0 | 1.6.2 | Agent Index Consistency (v1.6.2) |
| PARA Master Controller | /para | 1.0.0 | 1.4.0 | |
| Config Manager | /config | 1.0.0 | 1.4.0 | |
| Backup | /backup | 1.0.0 | 1.4.0 | |
| Inbox Categorizer | /inbox | 1.0.0 | 1.4.0 | |
| Learn & Capture | /learn | 1.1.0 | 1.4.0 | |
| Workflow Manager | /para-workflow | 1.0.0 | 1.4.0 | |
| Rule Manager | /para-rule | 1.0.0 | 1.4.0 |
Core Workflows
Configuration files for workflows (/slash-commands) are stored in the system at repo/templates/common/agent/workflows/ in .md format.
1. Session Management
/open <project-name>: Initialize context at the start of a new working session, analyze structure, read old session logs, and list pending sync changes at theSYNC Queue./end: End-of-day conclusion flow. Agent reports tasks, automatically classifies results (classifications) according to PARA architecture, and saves logs tosessions/.
2. Project Lifecycle (Planning & Development)
/brainstorm: Structured brainstorming session, recording decisions and suggesting next steps./docs <action>: Automated codebase analysis process extracted into documentation (docs/) with clear review versions. (v1.6.1) Added Strategy docs detection (Step 3.5)./plan: Create a standard-form implementation plan. (v1.6.1) Supports selecting type: 🗺️ Roadmap or 📐 Detail Plan (Step 2.8)./verify: Call Walkthrough documentation to cross-reference and perform QA checks, confirming task fulfillment.
3. Strategy → Plan Flow (v1.6.1)
Details in Strategy Plan Flow Guide.
The 3-tier model added to 4 workflows: /docs, /plan, /open, /end:
Tier 1: docs/strategy/ WHY + WHAT ← Created by /docs, loaded by /open, detected by /end
Tier 2: plans/*-roadmap.md Global HOW ← Created by /plan, loaded by /open, synced by /end
Tier 3: plans/*.md (detail) Detail HOW ← Created by /plan, active_plan, archived when doneWorkflow impacts:
| Workflow | v1.6.1 Changes |
|---|---|
/docs | Step 3.5 — Strategy docs discovery, suggests creating strategy for ecosystem |
/plan | Step 2.8 — Plan Type Selection (Roadmap vs Detail), strategy context load |
/open | Step 2 ext — Strategy summary (~30 tokens), Step 5.5 — Roadmap + cascade |
/end | Step 3.2 — Strategy/roadmap change detection, Step 4.5 — Roadmap sync |
4. Advanced Operations & Maintenance
/update: Agent administration workflow assisting the execution of safe review processes (Safe Update) to upgrade the versions of libraries / Agent Workflows themselves./retro,/release,/push: Toolset supporting product acceptance, release notes, and project archiving.
Interaction with Profiles
- Role Routing: A workflow file can be dynamically compatible based on Profile configurations (declared in the YAML file). Based on the
preferences.languageinformation, the entire workflow interaction process will be localized (e.g., Translating the response to the local language usingvi). - Execution with
// turboflag: Special Workspace Workflows optimize AI Tokens with turbo markers. Simple read-only bash commands without destructive properties (e.g.,grep,head,ls) will be fully automated by the Agent without interrupting (waiting for approval) the communication process with the user.
Last updated: 2026-03-24