{
  "markdown": "# spec-artifacts-process\n\n> Filament Module: process artifact templates (ADR, Plan, Task, Review, Finding, TestMatrix, Standard) — Jinja .md.j2 templates\n\nAgent-IX Filament module loaded by [`quire-cli`](https://github.com/agent-ix/quire-cli) and [`quoin`](https://github.com/agent-ix/quoin).\n\n## Installing quire-cli\n\n`@agent-ix` packages are published to public npm. Install the CLI globally:\n\n```bash\nnpm install -g @agent-ix/quire-cli\n```\n\nSee https://github.com/agent-ix/quire-cli#install for details.\n\n## Install this module via npm\n\nThis module is also published as a config-only npm package: `@agent-ix/spec-artifacts-process`.\nThe package root **is** the Filament module (`manifest.yaml` + schemas/skeletons),\nso it works directly as a `--module` target or via quoin's `package:` source.\n\n```bash\nnpm install @agent-ix/spec-artifacts-process\n```\n\n```bash\n# quoin — resolve the module from npm by name\nquoin plugin install package:@agent-ix/spec-artifacts-process\n\n# or point any tool at the installed package root\nquire validate spec/**/*.md --module node_modules/@agent-ix/spec-artifacts-process\n```\n\n## Artifact types provided\n\n| Kind | ID pattern | Description |\n|------|------------|-------------|\n| ADR | `ADR-{next:03d}` | Architecture Decision Record capturing a decision, its context and consequences; moves through `proposed → accepted → superseded → rejected` states and links via `supersedes`/`superseded_by`/`relates_to`/`depends_on`. |\n| Plan | `Plan-{next:03d}` | An implementation plan that owns a set of member Tasks (expected artifact `Task`); links via `contains`/`depends_on`/`references`. |\n| Task | `Task-{next:03d}` | A single unit of implementation work; links via `depends_on`/`verifies`/`references`. |\n| Review | `Review-{next:03d}` | A review document that owns a set of member Findings (expected artifact `Finding`); top-level nav item, links via `reviews`/`references`. |\n| Finding | `Finding-{next:03d}` | An individual review finding/issue; links via `found_in`/`blocks`/`references`. |\n| TestMatrix | `TestMatrix-{next:03d}` | A requirement-to-test coverage matrix; links via `covers`/`references`. |\n| Standard | `Standard-{next:03d}` | A normative standard definition with a stable `code` slug, description and application guidance; links via `references`. |\n\nAll artifacts share the `process-artifacts` grammar and require `id`, `title`, and `type` frontmatter; Standard additionally requires `code`.\n\n### Object type: `standard`\n\nThe module also exposes a `standard` object type. It extracts a stable `code` slug (required), optional `name`/`link` frontmatter, a `description` from the **Description** section body, and a `guide` from the **Application Guidance** section body. These objects are referenced from spec frontmatter `standards_alignment[]`.\n\n## How this module is used\n\n### With quoin (recommended)\n\n```bash\nquoin plugin install path:../spec-artifacts-process\nquoin catalog list\nquoin catalog show ADR\nquoin write . --types ADR,Plan\nquoin review\n```\n\nSee https://github.com/agent-ix/quoin.\n\n### With quire-cli directly\n\n```bash\nquire schema ADR --module ./spec_artifacts_process\nquire validate spec/**/*.md --module ./spec_artifacts_process\nquire extract <DOC> --module ./spec_artifacts_process --archetype ADR\n```\n\nSee https://github.com/agent-ix/quire-cli#usage-instructions.\n\n## Development\n\n- **Library:** `spec_artifacts_process` (flat layout, Python 3.13+, [Poetry](https://python-poetry.org/))\n- **Build & CI:** GitHub Actions; dynamic Git-tag-based versioning; published to Google Artifact Registry via `twine upload -r internal-pypi`.\n\n```bash\nmake install          # install dependencies in Poetry venv\nmake test             # run pytest\nmake lint             # ruff + black check\nmake format           # ruff + black format\nmake build            # build wheel and sdist under dist/\nmake update-lock      # update poetry.lock\nmake use-local p=<name>     # switch dep to local pypi.ix\nmake use-upstream p=<name>  # switch dep back to upstream\nmake local-publish    # build and publish to local pypi.ix\n```\n\nRequired CI secrets/variables: `GCP_SERVICE_ACCOUNT_KEY`, `GCP_REGION`, `GCP_PROJECT_NAME`, `GCP_PYPI`.\n",
  "bytes": 4178,
  "sha": "fa09430ee5b0c6e8b56359f29715d6942562b8b42514d6cda3fdad8fff2f0320",
  "repo_slug": "agent-ix/spec-artifacts-process",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_agent_ix_spec_artifacts_process_plan_pla_659b69cc/readme"
}