{
  "markdown": "# spec-objects-enterprise\n\n> Filament Module: tier-2 enterprise-architecture ObjectTypes (capability, business_function, value_stream, decision, objective, principle, kpi)\n\nAn Agent-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-objects-enterprise`.\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-objects-enterprise\n```\n\n```bash\n# quoin — resolve the module from npm by name\nquoin plugin install package:@agent-ix/spec-objects-enterprise\n\n# or point any tool at the installed package root\nquire validate spec/**/*.md --module node_modules/@agent-ix/spec-objects-enterprise\n```\n\n## Object types provided\n\n| Object | `type:` | Description |\n|:-------|:--------|:------------|\n| Capability | `capability` | An ability the organization possesses (e.g. Order Fulfillment), decomposed into an H2 \"Sub-capabilities\" list of child capabilities. |\n| Business Function | `business_function` | An organizational function (e.g. Supply Chain Management) described in an H2 \"Description\" covering what it does, who performs it and which capabilities it supports. |\n| Value Stream | `value_stream` | An end-to-end flow of value to a stakeholder (e.g. Order to Delivery), listing its ordered \"Stages\" and the value each stage adds. |\n| Decision | `decision` | An architectural decision (e.g. adopt event-driven order orchestration) stated in an H2 \"Decision\" with its scope and the alternatives it supersedes. |\n| Objective | `objective` | A measurable goal carrying frontmatter `metric` and `target` (with optional `deadline`), explaining why it matters and how it will be pursued. |\n| Principle | `principle` | A guiding rule (e.g. promise only what the network can deliver) justified in an H2 \"Rationale\" with its implications. |\n| KPI | `kpi` | A key performance indicator carrying frontmatter `metric` and `target` (with optional `threshold`), explaining how it is computed, who owns it and what happens on a breach. |\n\n## Semantic contract\n\nEvery object type ships a real JSON Schema 2020-12 declaration record under\n`spec_objects_enterprise/schemas/`, emitted from `typespec/main.tsp` against\n`@agent-ix/semantic-core` 0.1.0 and referenced from `manifest.yaml` by path and\nSHA-256 digest. The skeletons author their declarations in the typed\n`## Properties` table (or the equivalent ```sysml``` fence), with clauses as\n```ocl``` fences under `## Invariants`.\n\nOne rule is worth naming here, because it is the reason the KPI type has a\nschema at all: **a KPI declaration is a measure definition, never a reading of\none.** `Kpi.json` requires at least one field carrying a unit (a dimensionless\nmeasure uses the UCUM unity symbol `1`) and admits no identity field and no\n`Timestamp` field — the identity and the instant an observation would carry. An\nobjective is its mirror: time-bound, and referencing a KPI definition through\nits `targets` rather than declaring a measure of its own.\n\n```bash\nmake schemas        # re-emit schemas/ and the manifest digests from typespec/\nmake schemas-check  # fail on any drift (also run by `make lint`)\nmake dev-quire      # install the Quire wheel the semantic tests need\n```\n\n`make dev-quire` exists because the Quire release carrying `extract_semantic`\nis on no index this repository may commit a dependency against\n(`agent-ix/quire-rs#392`). The semantic tests **fail** rather than skip when it\nis absent: a skipped row is not coverage.\n\n## How this module is used\n\n### With quoin (recommended)\n\n```bash\nquoin plugin install path:../spec-objects-enterprise\nquoin catalog list\nquoin write . --types capability,value_stream\nquoin review\n```\n\nSee https://github.com/agent-ix/quoin.\n\n### With quire-cli directly\n\n```bash\nquire schema capability --module ./spec_objects_enterprise\nquire validate spec/**/*.md --module ./spec_objects_enterprise\nquire extract DEC-001.md --module ./spec_objects_enterprise\n```\n\nSee https://github.com/agent-ix/quire-cli#usage-instructions.\n\n## Development\n\nNative Poetry-based Python 3.13+ package (flat layout, package at root). Common targets:\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 + sdist under dist/\nmake update-lock      # update poetry.lock\nmake local-publish    # publish to local pypi.ix\n```\n\nCI (GitHub Actions) runs tests and lint on push/PR, and on a `v*.*.*` tag builds with `poetry build` and publishes to Google Artifact Registry via `twine upload -r internal-pypi`. Versioning is dynamic from the Git tag. Required CI config: secret `GCP_SERVICE_ACCOUNT_KEY`; variables `GCP_REGION`, `GCP_PROJECT_NAME`, `GCP_PYPI`.\n",
  "bytes": 5235,
  "sha": "67d599a4b178aae51f4c0e80fff49ae113ef0233748b349d548e60e27f833abf",
  "repo_slug": "agent-ix/spec-objects-enterprise",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_agent_ix_spec_objects_enterprise_plan_pl_b07934e3/readme"
}