One-click install
npx skills add https://github.com/RagnarokButMemorySafe/opencode-config --skill subarc-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subarc-create
Source: https://github.com/RagnarokButMemorySafe/opencode-config/tree/main/skills/subarc-create
Command: npx skills add https://github.com/RagnarokButMemorySafe/opencode-config --skill subarc-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms high-level requests into detailed sub-architecture plans, ensuring new components seamlessly integrate with existing systems and adhere to architectural standards.

Core Features & Use Cases

  • Detailed Planning: Generates concrete sub-architecture documents (<subdir>/<appname>-architecture.md) that align with a root architecture.md.
  • Dependency Mapping: Explicitly documents parent-child linkages, sibling dependencies, and cross-system contract assumptions.
  • Use Case: When tasked with building a new user authentication service, this Skill will help define its boundaries, APIs, data models, and how it fits within the broader application architecture, producing a ready-to-review plan.

Quick Start

Use the subarc-create skill to define the architecture for a new 'user-service' within the 'auth' subdirectory, aligning it with the main 'architecture.md'.

Frequently Asked Questions about subarc-create

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

FAQPage Schema
How do I design a sub-architecture for a new service within an existing system?

To design a sub-architecture, define self-contained boundaries, APIs, and data models for the new service. This ensures explicit parent-child linkage and scopes tradeoffs, producing a delivery-ready architecture document that aligns with your root system.

What is subsystem design and when do I need to document it?

Subsystem design is planning self-contained architectures for new application components. You need to document it when adding new services to an existing root architecture, ensuring dependencies, NFRs, and cross-system contract assumptions are explicitly mapped.

How to plan technology choices and build-vs-buy decisions for a new subsystem?

Plan technology choices and build-vs-buy decisions by scoping tradeoffs within a sub-architecture document. This process evaluates non-functional requirements and dependency mappings to produce a ready-to-review technical plan for your new application component.

Does this approach support mapping sibling dependencies and cross-system contracts?

Yes, mapping sibling dependencies and cross-system contract assumptions is supported. The sub-architecture planning process explicitly documents these parent-child linkages to ensure new components seamlessly integrate with existing architectural standards.

What format should the sub-architecture documentation follow for delivery?

Sub-architecture documentation should follow a markdown format, specifically generating a file like <subdir>/<appname>-architecture.md. This delivery-ready artifact explicitly links to the root architecture.md and details boundaries, APIs, and data models.

When should I not use a sub-architecture planning skill?

You should not use a sub-architecture planning skill for standalone applications lacking a root architecture, or when a quick prototype is needed without explicit parent-child linkage, non-functional requirement scoping, or cross-system contract documentation.