workspaces

Create multi-repo workspace hubs managing documentation, ADRs, and project memory.

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/wyattjoh/skills --skill workspaces-wyattjoh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspaces
Source: https://github.com/wyattjoh/skills/tree/main/skills/workspaces
Command: npx skills add https://github.com/wyattjoh/skills --skill workspaces-wyattjoh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, effect, yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the problem of context rot and fragmented decision-making in cross-repository engineering efforts by providing a unified, auditable hub for documentation, planning, and memory.

Core Features & Use Cases

  • Explicit Agent Context: Automatically generates and maintains CLAUDE.md from a single source of truth, ensuring agents always have up-to-date, auditable context.
  • Decision Discipline: Manages the lifecycle of Architecture Decision Records (ADRs) and deviation journals, ensuring that design history is captured and searchable.
  • Workspace Memory: Provides a committed, indexed layer of working knowledge that persists across sessions, preventing the need to relearn project context.

Quick Start

Use the workspaces skill to initialize a new workspace hub in the current directory.

Frequently Asked Questions about workspaces

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

FAQPage Schema
How do I centralize documentation and ADRs across multiple git repositories?

Multi-repo workspace hubs centralize documentation, Architecture Decision Records, and project memory for cross-repository engineering efforts, preventing context rot and fragmented decision-making across distributed git repositories.

How do I generate and maintain CLAUDE.md context for AI agents across multiple repositories?

Generating agent context involves maintaining CLAUDE.md from a single source of truth, ensuring AI agents always have up-to-date, auditable context for cross-repo engineering efforts.

Do I need Bun and TypeScript to orchestrate multi-repo workspace hubs?

Yes, orchestrating these workspace hubs requires Bun and TypeScript, utilizing the Effect framework for I/O-bearing logic and deterministic state management across repository operations.

What is the best way to manage Architecture Decision Records for distributed engineering projects?

The best way to manage ADRs is using a workspace hub that manages the lifecycle of Architecture Decision Records and deviation journals, ensuring design history is captured, auditable, and searchable.

How does workspace memory prevent context rot in cross-repository engineering?

Workspace memory provides a committed, indexed layer of working knowledge that persists across sessions, eliminating the need to relearn project context and preventing context rot in distributed repositories.