create-import-module

Create Import Module

Always use the skill load-plain-reference to retrieve the ***plain syntax rules — but only if you haven't done so yet.

What an Import Module Is

An import module is a .plain file that lives in the template/ directory and contains only ***definitions***, ***implementation reqs***, and/or ***test reqs***. It must not contain ***functional specs*** and must not use requires in its frontmatter. Other modules pull in its content via the import field in their YAML frontmatter, gaining access to its definitions and reqs.

Use import modules for:

• Sharing concept definitions across multiple modules
• Providing common implementation requirements (e.g., technology stack, coding standards)
• Providing common test requirements
• Creating reusable foundational structure (templates)

If the module needs functional specs (i.e., it describes what software should do), it is not an import module — see the create-requires-module skill.

Workflow

1. Determine what shared content this module should provide — which definitions, implementation reqs, or test reqs will other modules need?
2. Create the .plain file in the template/ directory with YAML frontmatter. Use required_concepts to declare concepts that importing modules must define. It may optionally import other templates for layered reuse, but must not use requires.
3. Add the shared content — definitions, implementation reqs, and/or test reqs.
4. Do not add ***functional specs*** — import modules must not contain functional specs.
5. Verify concept availability — ensure all :Concepts: referenced are either defined in this module, provided by its own imports, declared as required_concepts, or are predefined concepts.

Format

The import field is a list of module paths in the YAML frontmatter:

---
import:
  - base_template
required_concepts: [":AppName:"]
description: Shared API definitions and reqs
---

***definitions***

- :ApiClient: is the HTTP client used to communicate with external services.

- :ApiResponse: is the response returned by :ApiClient:.

***implementation reqs***

- :Implementation: should handle HTTP errors by raising appropriate exceptions.

- :ApiClient: should support configurable timeouts.

***test reqs***

- :ConformanceTests: should mock all external HTTP calls made by :ApiClient:.