gear-architecture-planner

Translate Gear and Vara feature specifications into structured architecture and service boundary definitions.

17|23|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/gear-foundation/vara-skills --skill gear-architecture-planner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gear-architecture-planner
Source: https://github.com/gear-foundation/vara-skills/tree/main/skills/gear-architecture-planner
Command: npx skills add https://github.com/gear-foundation/vara-skills --skill gear-architecture-planner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork and inconsistency of manually translating approved Gear/Vara feature specifications into compliant, well-structured architecture plans, ensuring designs align with Gear and Sails platform constraints from the start.

Core Features & Use Cases

  • Guided Reference Integration: Automatically surfaces relevant Gear domain, Sails architecture, messaging, and IDL pipeline reference materials to inform design decisions.
  • Guardrail-Aligned Design: Enforces platform best practices including thin #[program] constructs, explicit state ownership, clear async failure policies, and standardized Sails message contracts.
  • Use Case: When you have an approved spec for a new Vara DeFi feature, use this skill to map out program boundaries, message flows, and off-chain components into a consistent, shareable architecture document.

Quick Start

Use the gear-architecture-planner skill to turn your approved Gear/Vara feature specification into a structured architecture plan following Sails and Gear best practices.

Frequently Asked Questions about gear-architecture-planner

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

FAQPage Schema
How do I turn a Vara feature spec into a structured program architecture?

To turn a Vara feature spec into a structured program architecture, translate the approved specification into compliant designs that define state ownership, message flows, and off-chain integration surfaces using Gear and Sails constraints.

How does Sails IDL generation influence Gear program design boundaries?

Sails IDL generation influences Gear program design boundaries by requiring thin #[program] constructs and standardized message contracts. This ensures architecture plans explicitly define async failure policies and align with client generation requirements.

What is the best way to plan state ownership for a Gear smart contract?

The best way to plan state ownership for a Gear smart contract is to map approved feature specifications against guardrail-aligned design principles, ensuring explicit state boundaries and clear async failure policies within the architecture document.

Can I use this architecture planning approach for off-chain integration surfaces?

Yes, you can use this architecture planning approach for off-chain integration surfaces. It translates Gear and Vara feature specifications into structured service boundary definitions that explicitly map off-chain components and messaging flows.

Does Gear message flow architecture require explicit async failure policies?

Yes, Gear message flow architecture requires explicit async failure policies. Structured planning ensures designs align with gstd API capabilities and platform best practices to properly handle asynchronous messaging constraints.

Why do my Gear architecture plans lack consistent service boundary definitions?

Gear architecture plans often lack consistent service boundary definitions due to manual guesswork. Applying guardrail-aligned design eliminates inconsistency by enforcing standardized Sails message contracts and explicit state ownership.