Skip to content
ContractSpec
Start here

Package manual · tools

·CLI, authoring and agent tooling

agentpack.contractspec

Canonical repository-local Claude, Codex, and agent guidance for ContractSpec consumers.

toolsagent-packv2.0.4experimentalservernode
@lssm-tech/agentpack.contractspec
bun add @lssm-tech/agentpack.contractspec
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Canonical repository-local guidance for teams consuming ContractSpec packages. It supplies marker-owned Claude Code, Codex, OpenCode, and Cursor rules, compact catalog memory, adoption hooks, one adoption skill, and local MCP wiring.

contractspec init materializes this pack into the repository-local agentpacks cache and invokes the existing agentpacks compiler. User-owned AGENTS.md and CLAUDE.md content is preserved by agentpacks managed markers. The pack never writes global Claude Desktop or Codex configuration.

Claude Code hooks use the Claude blocking protocol (--host claudecode), so an adoption denial actually blocks in Claude Code instead of surfacing as a non-blocking exit code, and an adoption review follows the session permission mode (no prompt in bypassPermissions/dontAsk, where the review is deferred and recorded; a prompt in default; a deny in plan). A workspace that has not enabled Connect (connect.enabled, off by default) is not prompted: the adoption hooks stay silent there. The shell hook matches both Bash and PowerShell, and SessionStart runs contractspec can-help catalog status --host claudecode, which adds one line of catalog context (version, source, freshness, content hash, counts, and the can-help discovery command) instead of raw JSON. These hooks need a ContractSpec CLI that supports can-help catalog status --host and connect hook adoption ... --host. The catalog memory rule loads only when package manifests or .contractspec/** files are read.

The adoption skill activates for capability selection, replacement, or a new public surface/dependency. It uses current catalog provenance and task-bound Connect decisions, then verifies affected consumers. Routine unrelated edits do not need an adoption ceremony.

Published rule/skill files and the materialized contractSpecAgentPackFiles map are one surface; bun test src/index.test.ts checks their parity.

Relationships

THIS PACKAGEagentpack.contractspec1 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

0 declarations

No Runtime dependencies are declared here.

Declared capabilities

Agentpack Contractspec

Canonical repository-local Claude, Codex, and agent guidance for ContractSpec consumers.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • lint:checknode ../../../scripts/biome.cjs check .
  • testbun test
  • typechecktsgo --noEmit