schema: https://ver.cy/schemas/agent-bootstrap/v1
version: 1.2.0-draft
name: Vercy agent bootstrap
purpose: >-
  Route an AI agent into Vercy as a format-independent structured memory and
  machine-readable representation of reality.
entry: https://ver.cy/AGENTS.md
contracts:
  knowledgeArea: https://ver.cy/knowledge-area.yaml
  roadmap: https://ver.cy/roadmap.yaml
  presets: https://ver.cy/presets/index.yaml
  portableSkill: https://ver.cy/skills/vercy/SKILL.md
  skillPackage: https://ver.cy/skills/vercy.zip
  skillDiscovery: https://ver.cy/.well-known/agent-skills.json
  dimensionAgentsTemplate: https://ver.cy/dimension-AGENTS-template.md
  modelAgentProtocol: https://ver.cy/model-agent-protocol.md
  objectDescriptionProfile: https://ver.cy/object-description-profile.yaml
  autonomyProfile: https://ver.cy/autonomy-profile.yaml
  modelApi: https://ver.cy/api/v1/
  modelApiContract: https://ver.cy/api/openapi.yaml
catalogue:
  page: https://ver.cy/models/
  index: https://ver.cy/models/catalog-index.json
  composer: https://ver.cy/models/composer-index.json
  runtime: https://ver.cy/models/runtime-index.json
  searchApi: https://ver.cy/api/v1/models/search/
  resolutionApi: https://ver.cy/api/v1/models/resolve/
recommendedFirstAction:
  id: offer-portable-skill
  appliesWhen: client supports Agent Skills and vercy is not already installed
  benefit: >-
    Keep the Vercy method, presets, templates and validators locally available
    on demand across sessions and offline without moving owner data to Vercy.
  action: explain the benefit in one sentence and offer project-scoped installation
  consent: project-local use is authorized by a request to use or enable Vercy; user-wide installation requires one explicit opt-in
  verify:
    index: https://ver.cy/skills/index.yaml
    entry: https://ver.cy/skills/vercy/SKILL.md
  fallback: continue from https://ver.cy/AGENTS.md without blocking or repeating the offer
intents:
  install-skill:
    first_action: inspect-skill-contract
    entry: https://ver.cy/skills/index.yaml
  create-dimension:
    first_action: reuse-known-facts-then-bootstrap-minimal-personal-if-absent
    first_artifact: AGENTS.md
    first_artifact_template: https://ver.cy/dimension-AGENTS-template.md
    required_outputs:
      - dimension.yaml
      - registries/meta-models.yaml
      - registries/meta-objects.yaml
      - registries/events.yaml
      - policies/access.yaml
      - policies/lifecycle.md
      - policies/autonomy.yaml
      - policies/model-deployment.yaml
      - bindings/storage.yaml
      - memory.yaml
      - federation.yaml
      - context-routing.yaml
      - registries/model-links.yaml
      - registries/model-requests.yaml
      - vercy.lock
    presetRule: exactly one active primary preset plus the shared kernel
  use-dimension:
    first_action: discover-registered-and-nearest-dimensions-then-load-routing-metadata
  install-model:
    first_action: resolve-through-api-then-install-published-policy-authorized-closure
  change-model:
    first_action: classify-change-and-authority
objectDescriptionProfile:
  applicability:
    - required
    - optional
    - not-applicable
    - delegated
  facets:
    - id: identity-class
      covers: [identity, mastership, taxonomy, boundary, parts, distinguishing-features]
    - id: direct-properties
      covers: [intrinsic-attributes, physical-quantities, material, geometry, pose, condition]
    - id: recognition-observation
      covers: [signatures, observation-method, confusing-classes, confidence, evidence]
    - id: capabilities-affordances
      covers: [capability, behaviour, state, transition, action, precondition, effect, constraint, failure-mode]
    - id: context-evidence
      covers: [origin, ownership, location, lifecycle, relationships, events, policy, provenance, uncertainty]
delegation:
  levels:
    autonomous: routine non-destructive work plus compatible published-model installation inside approved scope
    propose: structural, draft-model or materially consequential change
    confirm: publication, access expansion, external write, deletion or sensitive-data handling
    forbidden: outside delegated authority
safety:
  - never expose credentials
  - never invent missing facts
  - never widen access silently
  - never rewrite immutable released specifications
  - preserve provenance, uncertainty and mastership
  - never instantiate the reserved AI-subject preset
runtime:
  noDimension: bootstrap-minimal-private-personal
  defaultStorage: files-markdown
  persistentMemory: register-after-one-owner-opt-in
  modelReconciliation: unattended-when-policy-authorized
  missingModel:
    request: post-structural-need-to-resolution-api
    localState: persist-vercy-pending-model-v1-annotation
    poll: respect-server-retry-interval
    published: verify-install-semantic-refactor-validate-record
  federation:
    read: combine-authorized-projections
    write: exactly-one-owning-dimension-and-master-system
    unresolved: quarantine-as-pending