matter-workspace

Create, list, switch, and archive per-client matter workspaces.

Updated May 19, 2026
One-click install
npx skills add https://github.com/jrhueiueng/codex-for-legal --skill matter-workspace-jrhueiueng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matter-workspace
Source: https://github.com/jrhueiueng/codex-for-legal/tree/main/plugins/jrhueiueng/codex-for-legal/skills/privacy-legal__matter-workspace
Command: npx skills add https://github.com/jrhueiueng/codex-for-legal --skill matter-workspace-jrhueiueng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps practitioners manage multiple client matters without cross-contaminating context, so each engagement stays clean, consistent, and traceable throughout the workflow.

Core Features & Use Cases

  • Create and seed a new matter workspace: Generates a matter folder with a matter.md intake, initializes history.md, and creates notes.md for working drafts.
  • List and track active matter status: Enumerates all matter workspaces (including archived ones) and clearly marks the currently active matter.
  • Switch, close/archive, or detach from matter context: Sets the active matter in the practice-level CLAUDE.md, archives matters to an _archived folder for retention/readability, or returns to practice-level context only.
  • Safety and confidentiality alignment: Obeys the Cross-matter context flag and prevents automatic cross-matter reading unless explicitly enabled.

Quick Start

Run the skill with your desired command like: list your current matters and identify which one is active.

Frequently Asked Questions about matter-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I isolate legal matter workspaces to prevent cross-client context contamination?

You isolate legal matter workspaces by creating per-client engagement contexts with separated files, matter-scoped notes, and an explicit active-matter pointer. This prevents cross-contamination by blocking automatic cross-matter reading unless explicitly enabled.

How do I create and seed a new matter workspace for a legal client?

To create a new matter workspace, you generate a dedicated matter folder containing a matter.md intake file, initialize a history.md for append-only tracking, and create notes.md for working drafts specific to that client engagement.

Can I archive closed legal matters while maintaining traceable history?

Yes, you can archive closed legal matters by moving them to an _archived folder for retention. The system maintains append-only history and non-deleting archive behavior, ensuring all matter context remains readable and traceable throughout the workflow.

What is the best way to switch between active client matters in a legal practice workflow?

The best way to switch active client matters is by updating the active matter line in the practice-level CLAUDE.md. This sets an explicit active-matter pointer, allowing you to change engagement contexts without cross-contaminating files or notes.

Does matter workspace isolation require a specific practice-level configuration to function?

Yes, matter workspace isolation requires reading the practice-level CLAUDE.md for the Matter workspaces enabled state. This configuration dictates the cross-matter context flag and controls whether automatic cross-matter reading is permitted.

When should I detach from a matter context and return to practice-level workflow only?

You should detach from a matter context when you need to stop working on a specific client engagement and return to practice-level workflow only. This clears the active matter pointer, preventing any client-specific context from influencing general practice tasks.