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.