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.