Submission Workflow

1

Create a directory at registry/packages/<component>/.

2

Add exactly one #intent facet file: <component>.aim.

3

Add optional facet files referenced by the entry file via INCLUDES.

4

Add an optional cover.png or cover.jpg for visual identity.

5

Register your package in registry/index.json. (Metadata like files and image are auto-generated by our build script).

6

Ensure all files use valid v3.1 frontmatter with aim and facet. The project-wide aim_version and spec: URL live once in AGENTS.md.

7

Submit a Pull Request to the GitHub repository.

Example Index Entry

registry/index.json
{
  "name": "weather",
  "aim_version": "3.1",
  "version": "1.0.0",
  "entry": "registry/packages/weather/weather.aim"
}

Validation Policy

Every PR is automatically validated for:

  • Correct directory structure
  • Header-to-path identity alignment
  • Version consistency