module-building-strategies

Guides design decisions for decomposing, configuring, and verifying Intent Architect modules.

23|10|Updated Aug 31, 2017
One-click install
npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-building-strategies-intentarchitect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: module-building-strategies
Source: https://github.com/IntentArchitect/Intent.Modules/tree/main/Tests/ModuleBuilderSkills/.opencode/skills/module-building-strategies
Command: npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-building-strategies-intentarchitect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building an Intent Architect module involves judgment calls that mechanical how-to guides do not cover: how to decompose modules, when to choose a template versus a factory extension, whether to use settings or stereotypes, and how to verify generated output. This Skill provides the strategic decision framework for those design decision points. ## Core Features & Use Cases - Module Decomposition Strategy: Apply the dependency-boundary rule to decide between root modules, bridging modules, and common modules, and avoid shared-project DLL version skew. - Template & Configuration Judgment: Choose between template and factory extension, pick file cardinality and managed modes (Fully, Merge, Ignore), and decide between module settings, stereotypes, and convention-based defaults. - Two-Phase Verification: Reproduce output on a reference app, then run a mandatory from-scratch generation test with a spanning set of scenarios and comprehensive domain models. - Use Case: When extending an eventing module, use this Skill to decide whether the integration belongs in a bridging module, whether the topic name should be a convention or an explicit stereotype, and how to test both single-app and cross-app topologies. ## Quick Start Ask the AI to help you decide whether a new integration should be a bridging module or part of an existing root module while building an Intent Architect module.

Frequently Asked Questions about module-building-strategies

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

FAQPage Schema
How do I decide between a template and a factory extension in Intent Architect?▼

Choose a template when the concern produces a new output file, since a template's sole purpose is file generation. Choose a factory extension when the concern modifies another module's output or wires behavior without emitting its own file.

When should I create a bridging module instead of adding a dependency?▼

Create a bridging module when integrating two root modules would force one to take on a dependency it does not otherwise need. The bridge depends on both sides, is installed on demand, and keeps each root module dependency-clean.

Should I use a module setting or a stereotype for configuration?▼

Use a module setting for application-wide behavior and a stereotype for fine-grained, element-level overrides of that global default. Associations are structural modeling mechanisms and should never carry configuration.

Why does my module pass on the reference app but fail on a new application?▼

The reference app already contains hand-written code, so zero Software Factory changes prove nothing about missing wiring. A from-scratch test on a brand-new app is the only way to expose forgotten registration or wiring steps.

What are the limitations of shared projects in Intent Architect modules?▼

Shared projects cause each module to bundle its own copy of the shared DLL, and the loader binds to the first copy, creating version skew when copies are out of sync. A common module fixes this by versioning the shared code centrally.