A workspace-based knowledge and task management system designed specifically for AI-assisted development workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install joan-workflow
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install joan-workflow using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Joan Workflow?
Joan Workflow is a sophisticated system that bridges the gap between raw code and organizational domain knowledge. By utilizing Openclaw Skills, developers can integrate Joan's core concepts of pods, todos, and plans directly into their AI-driven environments. This skill ensures that both human developers and AI assistants stay synchronized with the project's architecture, design decisions, and business rules through a structured markdown-based approach.
The system focuses on persistent context management, allowing for the creation of versioned documentation that evolves alongside your codebase. By leveraging this Openclaw Skills integration, teams can maintain a living knowledge base that is easily accessible through both a command-line interface and Model Context Protocol (MCP) servers, streamlining the transition from planning to implementation.
Joan Workflow Use Cases
- Documenting project architecture and complex design decisions for AI assistants.
- Synchronizing domain-specific terminology across distributed development teams.
- Tracking implementation tasks and linking them to detailed technical plans.
- Generating context-rich configuration files like CLAUDE.md to guide AI coding agents.
- Managing a centralized knowledge repository for self-hosted or cloud-based projects.
How Joan Workflow Works
- Initialize the project workspace using the CLI to establish a connection between the local environment and the Joan server.
- Create or add pods, which serve as versioned markdown documents containing critical domain knowledge and project rules.
- Synchronize context by pulling the latest pod updates and generating specific files like CLAUDE.md to inform AI agents.
- Manage the development lifecycle by creating todos and implementation plans that track progress and document technical approaches.
- Push local updates to the server to ensure team-wide visibility and consistent context across all Openclaw Skills instances.
Joan Workflow Setup
To get started with this skill, install the Joan CLI and authenticate your account. Then, follow these steps:
- Initialize your project:
joan init
- Add existing pods from your workspace:
joan pod add
- Generate AI-ready context:
joan context claude
Joan Workflow Data Schema & Taxonomy
Joan organizes its data locally to ensure transparency and version control compatibility:
| Component | Location | Description |
|---|---|---|
| Configuration | .joan/config.yaml |
Stores workspace IDs and metadata for tracked pods. |
| Knowledge Pods | .joan/pods/ |
Local directory containing versioned markdown documentation files. |
| AI Context | CLAUDE.md |
A generated file used to inject Joan context into AI coding agent sessions. |
Joan Workflow Advanced Features
- Model Context Protocol (MCP) support via an authenticated server for direct AI tool integration.
- Automated CLAUDE.md context generation for seamless AI agent onboarding.
- Interactive and non-interactive workspace initialization for flexible environment setup.
- Role-based access control within workspaces to manage team member permissions.
- Bi-directional synchronization between local markdown files and the remote Joan server using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Corpus
A powerful integration for AI agents to interact with the Corpus AI library for content retrieval, web bookmarking, and reminder management.
Musify: CUDA to MUSA Migration Tool
A specialized migration tool for converting NVIDIA CUDA source code into Moore Threads MUSA architecture using automated text-based API mapping.
Waiting Tips
A bilingual learning utility that displays curated AI and productivity tips to users while the agent processes their requests.
Social Copy Generator
A multi-platform content engine that transforms a single product description into 14+ optimized social media posts with a one-click copy dashboard.
Video Watcher
A specialized tool for programmatically fetching and reading transcripts from YouTube and Bilibili videos to enable AI-powered analysis.
Agent Stability Framework (ASF)
A comprehensive three-layer defense system to prevent AI personality drift, technical faults, and soul misalignment in autonomous agents.
Featured*
