spec-artifacts-app

Filament Module: application/composite spec artifact templates (ApplicationSpec, MasterRequirements) — absorbed spec-master-requirements

Agent-IX Filament module loaded by quire-cli and quoin.

Installing quire-cli

@agent-ix packages are published to public npm. Install the CLI globally:

npm install -g @agent-ix/quire-cli

See https://github.com/agent-ix/quire-cli#install for details.

Install this module via npm

This module is also published as a config-only npm package: @agent-ix/spec-artifacts-app. The package root is the Filament module (manifest.yaml + schemas/skeletons), so it works directly as a --module target or via quoin's package: source.

npm install @agent-ix/spec-artifacts-app

# quoin — resolve the module from npm by name
quoin plugin install package:@agent-ix/spec-artifacts-app

# or point any tool at the installed package root
quire validate spec/**/*.md --module node_modules/@agent-ix/spec-artifacts-app

What's in this module

This module gives you the top-level document kinds for specifying a whole application — the documents that gather requirements together and describe the system as a whole. They sit above the individual requirement artifacts (StR, FR, NFR, …) and tie them into one specification.

| Kind | Type | What it's for | |:-----|:-----|:--------------| | ApplicationSpec | Application Spec | The top-level document for an application — describes the system as a whole and gathers together the requirements and specs that make it up. | | MasterRequirements | Master Requirements | The front page of a specification — its purpose, scope, and the set of requirements it rolls up. |

How this module is used

With quoin (recommended)

quoin plugin install path:../spec-artifacts-app
quoin catalog list
quoin catalog show ApplicationSpec
quoin write . --types ApplicationSpec
quoin review

See https://github.com/agent-ix/quoin.

With quire-cli directly

quire schema ApplicationSpec --module ./spec_artifacts_app
quire validate spec/**/*.md --module ./spec_artifacts_app
quire extract <DOC> --module ./spec_artifacts_app --archetype ApplicationSpec

See https://github.com/agent-ix/quire-cli#usage-instructions.

Development

• Library: spec_artifacts_app (flat layout, Python 3.13+, Poetry)
• Build/CI: GitHub Actions; dynamic Git-tag-based versioning; publishes wheel + sdist to Google Artifact Registry via twine upload -r internal-pypi.

make install          # install deps in Poetry venv
make test             # run pytest
make lint             # ruff + black check
make format           # ruff + black format
make build            # build wheel + sdist under dist/
make local-publish    # build and publish to local PyPI (pypi.ix)
make update-lock      # update poetry.lock

CI requires the GCP_SERVICE_ACCOUNT_KEY secret plus GCP_REGION, GCP_PROJECT_NAME, and GCP_PYPI variables for Artifact Registry publishing.