architecture

Define and enforce architecture and file-placement rules for Electron-style multi-process projects.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill architecture-gerald-ica
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/architecture
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill architecture-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill codifies project architecture and file-structure conventions for Electron-style multi-process projects, helping teams align on where code should live and how modules should be organized.

Core Features & Use Cases

  • Enforces a canonical layout for renderer, main, worker, and shared layers.
  • Guides placement of bridges, services, and workers, and supports migration of single-file components to directories.
  • Use Case: When starting a new Electron app, apply these guidelines to establish a scalable, maintainable architecture from day one.

Quick Start

Provide a recommended target layout for the repository according to the guidelines.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I organize files in an Electron multi-process project?▼

Electron multi-process project file organization is enforced by defining a canonical layout across renderer, main, worker, and shared layers. This establishes directory conventions and validates module placement to maintain a scalable architecture.

What is the correct way to structure renderer and main process code in Electron?▼

Correct renderer and main process code structure separates modules into distinct renderer, main, worker, and shared layers. This centralized approach provides cross-reference guidance and best-practice checks for bridges, services, and patterns.

How do I migrate single-file components to a directory structure in Electron?▼

Migrating single-file components to directories in Electron is guided by applying centralized architecture references. This process validates the target layout and enforces correct file-placement rules for the refactored modules.

Where should shared services and bridges be placed in an Electron app?▼

Shared services and bridges in an Electron app should be placed in defined shared layers following canonical layout rules. This skill validates directory structures and provides best-practice checks for correct module organization.

Does this architecture guidance work for existing codebase refactors?▼

Yes, this architecture guidance works for existing codebase refactors as well as new applications. It validates directory layouts, bridges, services, and patterns through centralized references to enforce correct file placement.