tml-primitive-definition-kit/DECLARATION.json at main · CobraChickenAI/tml-primitive-definition-kit · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
{
  "$schema": "https://themissinglayer.dev/schema/v1",
  "declaration": {
    "scope": {
      "id": "scope-tml-pdk",
      "name": "TML Primitive Definition Kit",
      "description": "The canonical specification and interaction layer for TML primitives",
      "parent": null,
      "lifecycle": "active"
    },
    "domains": [
      {
        "id": "domain-specification",
        "name": "Specification",
        "description": "The primitive definitions themselves"
      },
      {
        "id": "domain-interaction",
        "name": "Interaction",
        "description": "Skills, starters, and patterns for working with primitives"
      },
      {
        "id": "domain-governance",
        "name": "Meta-Governance",
        "description": "How this repo governs itself"
      }
    ],
    "capabilities": [
      { "id": "cap-explain", "name": "Explain Primitives", "domain": "domain-interaction" },
      { "id": "cap-assess", "name": "Assess Primitives", "domain": "domain-interaction" },
      { "id": "cap-create", "name": "Create Primitives", "domain": "domain-interaction" },
      { "id": "cap-interview", "name": "The Familiar", "domain": "domain-interaction" },
      { "id": "cap-validate", "name": "Validate Declarations", "domain": "domain-specification" }
    ],
    "archetypes": [
      {
        "id": "arch-learner",
        "name": "Learner",
        "description": "Someone encountering TML for the first time",
        "permissions": ["read-primitives", "use-starters", "run-interview"]
      },
      {
        "id": "arch-implementer",
        "name": "Implementer",
        "description": "Someone deploying TML in their org or personal workflow",
        "permissions": ["read-primitives", "customize-hooks", "fork-examples", "create-declarations"]
      },
      {
        "id": "arch-contributor",
        "name": "Contributor",
        "description": "Someone proposing changes to TML itself",
        "permissions": ["propose-primitive-changes", "submit-patterns", "add-examples"]
      },
      {
        "id": "arch-maintainer",
        "name": "Maintainer",
        "description": "Steward of the TML specification",
        "permissions": ["all"]
      }
    ],
    "policies": [
      {
        "id": "policy-scale-agnostic",
        "name": "Scale Agnosticism",
        "description": "No primitive may assume or require a specific organizational scale",
        "enforcement": "Every PRIMITIVE.md must include a Scale Notes section"
      },
      {
        "id": "policy-self-referential",
        "name": "Self-Governance",
        "description": "This repository must be expressible as a valid TML declaration",
        "enforcement": "DECLARATION.json at root must validate against current schema"
      },
      {
        "id": "policy-progressive-disclosure",
        "name": "Progressive Disclosure",
        "description": "An agent should be able to load just PRIMITIVE.md frontmatter to decide relevance, then load deeper as needed",
        "enforcement": "Frontmatter must contain sufficient metadata for routing"
      }
    ],
    "connectors": [
      { "id": "conn-agentskills", "name": "AgentSkills Spec", "source": "agentskills.io" },
      { "id": "conn-anthropic-skills", "name": "Anthropic Skills Repo", "source": "github.com/anthropics/skills" }
    ],
    "bindings": [
      { "id": "bind-schema", "name": "Schema Publication", "target": "themissinglayer.dev/schema/v1" },
      { "id": "bind-skillpack", "name": "SkillPack Sync", "target": "cobrachickenai/skillpack" }
    ],
    "provenance": {
      "created_by": "michael@cobrachicken.ai",
      "created_at": "2026-02-22",
      "rationale": "Packaging TML primitives as a self-contained, self-documenting, customizable kit"
    }
  }
}