spaces-architecture

Coordinate massCode spaces state and IPC routing across code, notes, math, and tools.

6.9k|262|Updated Mar 29, 2022
One-click install
npx skills add https://github.com/massCodeIO/massCode --skill spaces-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spaces-architecture
Source: https://github.com/massCodeIO/massCode/tree/main/.agents/skills/spaces-architecture
Command: npx skills add https://github.com/massCodeIO/massCode --skill spaces-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate massCode spaces state and IPC coordination to ensure consistent behavior across code, notes, math, and tools.

Core Features & Use Cases

  • Space Model: code, notes, math, tools each with independent state, updates, and synchronization rules.
  • Space State Storage: per-space state stored under spaces/{spaceId}/.state.yaml within vault, with runtime helpers to load and persist space state.
  • IPC Rules: centralized space-specific IPC handlers and standardized events for reading and writing space data.
  • Space-Aware Sync: system:storage-synced updates the active space and triggers appropriate refreshes across code, notes, math, and tools.
  • Debounce & Persist: maintains reliable save behavior to avoid sync loops and data loss.

Quick Start

Follow the Space Architecture guidelines to initialize a new space by wiring its state, updates, and IPC routes to the vault structure.

Frequently Asked Questions about spaces-architecture

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

FAQPage Schema
How do I coordinate IPC and state across multiple vault spaces?

Coordinate vault spaces by defining independent state models for code, notes, math, and tools, then routing reads and writes through centralized space-specific IPC handlers to ensure consistent behavior.

How does space-aware sync handle updates across different workspace types?

Space-aware sync uses system:storage-synced events to update the active space and trigger appropriate refreshes across code, notes, math, and tools, maintaining consistent state without sync loops.

Where is per-space state stored within a vault architecture?

Per-space state is stored under __spaces__/{spaceId}/.state.yaml within the vault, utilizing runtime helpers to load and persist space state for each independent workspace type.

What's the best way to prevent data loss and sync loops when persisting workspace state?

Implement debounce and persist behaviors to maintain reliable save operations, avoiding sync loops and data loss when updating independent state across multiple vault spaces.

Do I need centralized IPC handlers to manage multi-space workflows?

Centralized IPC handlers are required to standardize events for reading and writing space data, ensuring consistent behavior across code, notes, math, and tools within multi-space workflows.

Can I synchronize independent state models for code, notes, math, and tools in one vault?

Yes, you can synchronize independent state models by applying a unified space-aware sync mechanism that triggers appropriate refreshes across all workspace types within the vault.