{
  "markdown": "# Trellis\n\nTrellis is a descriptive language for expressing work artifacts, not a system\nfor controlling how work advances. It defines typed, human- and agent-readable\nMarkdown artifacts that capture knowledge, intended outcomes, and the context\nneeded to understand them.\n\nTrellis contracts describe declarative artifact states and minimum information\nrequirements. They do not, merely by defining a type, maturity, status,\ndirectory, link, checkbox, question, or follow-up, prescribe approval,\nassignment, priority, authorization, or a workflow transition. A workflow or\nagent may use Trellis artifacts as inputs and completion criteria without\nTrellis dictating how that workflow operates.\n\nThe copyable [`trellis/`](trellis/) directory is the minimum implementation. It\ncontains a concise [operating manual](trellis/OPERATING.md), an\n[agent-instructions example](trellis/AGENTS.example.md), and two independent,\nagent- and human-readable contracts:\n\n- [Knowledge Topic](trellis/knowledge-topic.md) — a typed,\n  provenance-preserving knowledge bundle conforming to Open Knowledge Format\n  (OKF).\n- [Trellis Design](trellis/design.md) — a dossier whose `design.md` is a\n  complete architectural handoff and whose supporting documents are required\n  when their triggering concerns exist.\n\nEach specification is a standalone document. An agent can create a conforming\nartifact from the raw URL without cloning this repository or installing tools.\n\nThe specifications are independently versioned drafts. Released versions use\nimmutable-by-policy tags:\n\n```text\nhttps://raw.githubusercontent.com/pnw/trellis/knowledge-topic-v0.1.0/trellis/knowledge-topic.md\nhttps://raw.githubusercontent.com/pnw/trellis/design-v0.2.0/trellis/design.md\n```\n\nUntil those tags are released, use the files in this repository rather than\nassuming the example tag URLs exist.\n\n## Repository Layout\n\n```text\ntrellis/\n  OPERATING.md                  # Portable operator manual\n  AGENTS.example.md             # Context-efficient agent routing example\n  knowledge-topic.md            # Normative Knowledge Topic contract\n  design.md                     # Normative Design contract\nkit/\n  skills/                       # Optional agent workflows\n  templates/                    # Optional scaffold files\n  adapters/                     # Optional tool-specific loading wrappers\n  scripts/                      # Optional validators and helpers\nworkspace/\n  wiki/                         # Non-normative Knowledge Topic collection\n  designs/                      # Non-normative Design collection\n```\n\nOnly `trellis/knowledge-topic.md` and `trellis/design.md` are normative.\n`trellis/OPERATING.md`, `trellis/AGENTS.example.md`, the\n[optional kit](kit/README.md), and the dogfood Workspace apply or explain the\ncontracts but do not define conformance.\n\nThe Workspace is only a directory convention. It has no manifest, schema,\ncatalog, router, registry, or validator. A Wiki is the collection under\n`workspace/wiki/`; each child Knowledge Topic is the conforming unit. The\nexisting root `designs/` directory remains legacy lab content excluded from the\n0.1 framework.\n\n## Use\n\nTo create a Knowledge Topic, give an agent the raw specification and one\ngoverning purpose:\n\n> Read this specification and create a Knowledge Topic for this subject:\n> `<versioned raw Knowledge Topic URL>`\n\nTo create a design:\n\n> Read this specification and create a Trellis Design for this change:\n> `<versioned raw design URL>`\n\nFor the local, Markdown-only core, copy `trellis/` into the target repository\nand adapt `trellis/AGENTS.example.md` into the instruction file recognized by\nthe target agent. For scaffolding, ingest, query, lint, or design-authoring\naccelerators, install only the relevant components from `kit/`.\n\n## Versioning\n\nKnowledge Topic and Design evolve independently with semantic versions:\n\n- `knowledge-topic-v<major>.<minor>.<patch>`\n- `design-v<major>.<minor>.<patch>`\n\nRelease tags are never moved or deleted. A patch clarifies without changing\nconformance. While a contract remains an unreleased `0.x` draft, a breaking\nrevision increments the minor version; each contract defines its post-1.0\nminor and major semantics.\n",
  "bytes": 4198,
  "sha": "4f2c125f29567c5e8885f917d95b52e76b8088092f9933a8332c067aab1450cb",
  "repo_slug": "pnw/trellis",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_pnw_trellis_workspace_wiki_open_knowledg_0112dc72/readme"
}