Complete pack example

This example shows a complete wiki-first pack with sources/, wiki/, compiled/, indexes/, runs/, schemas/, and evals/. For document-first product or operations documents, see the brand product, content operations, and private-domain operations examples.

acme-product-brief/
├── KNOWLEDGE.md
├── sources/
│   ├── product-one-pager.md
│   └── customer-interview.md
├── wiki/
│   ├── index.md
│   ├── sources/product-one-pager.md
│   ├── concepts/offline-queue.md
│   ├── contradictions/pricing.md
│   └── synthesis/rag-boundary.md
├── compiled/
│   ├── facts.md
│   ├── boundaries.md
│   └── briefing.md
├── indexes/
│   └── source-map.json
├── evals/
│   └── discovery.validation.json
├── runs/
│   ├── compile-2026-05-01T10-30-00Z.json
│   ├── context-2026-05-01T10-45-00Z.json
│   └── health-2026-05-01.md
└── schemas/
    └── local-claim.schema.json

KNOWLEDGE.md

---
name: acme-product-brief
description: Product facts, approved positioning, pricing boundaries, support language, and source-grounded claims for Acme Widget. Use for Acme marketing copy, sales replies, support answers, partner briefs, or checking whether Acme-related claims are approved.
type: brand-product
profile: wiki-first
status: ready
version: 1.0.0
language: en
trust: user-confirmed
grounding: recommended
runtime:
  mode: data
metadata:
  producedBy:
    kind: agent-skill
    name: brand-product-knowledge-builder
    version: 1.0.0
---

# Acme Product Brief

## Context map

- Read `compiled/briefing.md` first for normal tasks.
- Read `compiled/facts.md` for factual claims.
- Read `compiled/boundaries.md` before pricing, compliance, or customer-logo claims.
- Return to `wiki/` for novel questions or disputed claims.
- Read `sources/` anchors for citation and verification.

compiled/facts.md

# Facts

- Acme Widget supports offline queueing. [source: sources/product-one-pager.md#L12]
- Acme Widget is built for field service teams. [source: sources/product-one-pager.md#L4]

indexes/source-map.json

{
  "claims": [
    {
      "claim_id": "clm-acme-offline-queue",
      "text": "Acme Widget supports offline queueing.",
      "status": "confirmed",
      "source": {
        "path": "sources/product-one-pager.md",
        "anchor": "L12"
      },
      "compiled_into": [
        "wiki/concepts/offline-queue.md",
        "compiled/facts.md"
      ]
    }
  ]
}

evals/discovery.validation.json

{
  "pack_name": "acme-product-brief",
  "cases": [
    {
      "id": "support-offline-queue",
      "prompt": "Help me answer whether Acme Widget supports offline queueing.",
      "expected": "select",
      "reason": "Requires Acme product facts."
    },
    {
      "id": "generic-email-edit",
      "prompt": "Polish a generic English email.",
      "expected": "reject",
      "reason": "Does not need Acme knowledge."
    }
  ]
}

runs/compile-...json

{
  "run_id": "compile-2026-05-01T10-30-00Z",
  "trigger": "ingest",
  "status": "passed",
  "profile": "wiki-first",
  "runtime_mode": "data",
  "builder_skill": {
    "name": "brand-product-knowledge-builder",
    "version": "0.7.2",
    "digest": "sha256:..."
  },
  "inputs": [
    {
      "path": "sources/product-one-pager.md",
      "sha256": "..."
    }
  ],
  "outputs": [
    {
      "path": "wiki/concepts/offline-queue.md",
      "operation": "updated"
    },
    {
      "path": "compiled/facts.md",
      "operation": "updated"
    }
  ],
  "diagnostics": []
}

runs/context-...json

{
  "run_id": "context-2026-05-01T10-45-00Z",
  "query": "Can Acme Widget work offline?",
  "status": "passed",
  "resolver": {
    "tool": "agentknowledge-ref",
    "version": "0.7.2",
    "strategy": "profile-aware"
  },
  "activated_packs": [
    {
      "name": "acme-product-brief",
      "activation": "implicit",
      "status": "ready",
      "trust": "user-confirmed",
      "profile": "wiki-first",
      "runtime_mode": "data",
      "grounding": "recommended",
      "selected_files": [
        "compiled/facts.md"
      ],
      "source_anchors": [
        "sources/product-one-pager.md#L12"
      ],
      "warnings": []
    }
  ],
  "token_estimate": 420
}

Companion Skill

A Skill that maintains this pack might expose:

agentknowledge-ref validate ./acme-product-brief
agentknowledge-ref compile ./acme-product-brief --changed sources/product-one-pager.md
agentknowledge-ref eval ./acme-product-brief --suite evals/discovery.validation.json

These commands are not knowledge pack core. They are maintenance-layer tools, and their outputs SHOULD be written to runs/.