@forwardimpact/schema 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/examples/framework.yaml +1 -1
  2. package/examples/stages.yaml +6 -0
  3. package/package.json +1 -1
  4. package/schema/json/capability.schema.json +1 -1
  5. package/schema/json/stages.schema.json +5 -1
  6. package/schema/rdf/capability.ttl +2 -2
  7. package/schema/rdf/stages.ttl +27 -3
package/examples/framework.yaml CHANGED
@@ -66,4 +66,4 @@ entityDefinitions:
66
66
  title: Tools
67
67
  emojiIcon: "🔧"
68
68
  description: |
69
- Recommended tools and utilities referenced by skills for effective engineering workflows. Tools are linked to specific skills with guidance on when and how to use them, surfacing best practices directly in skill definitions.
69
+ Required tools and utilities referenced by skills for effective engineering workflows. Tools are linked to specific skills with guidance on when and how to use them, surfacing organizational standards directly in skill definitions.
package/examples/stages.yaml CHANGED
@@ -3,6 +3,7 @@
3
3
  - id: specify
4
4
  name: Specify
5
5
  emojiIcon: "🎯"
6
+ summary: Defines requirements, user stories, and acceptance criteria
6
7
  description:
7
8
  Your primary task is to define WHAT users need and WHY, not how to build it.
8
9
  Gather requirements, write user stories, and define acceptance criteria.
@@ -30,6 +31,7 @@
30
31
  - id: plan
31
32
  name: Plan
32
33
  emojiIcon: "📐"
34
+ summary: Designs architecture, makes technology choices, and defines contracts
33
35
  description:
34
36
  Your primary task is to define HOW to build the solution. Make technology
35
37
  choices, design architecture, define contracts and data models.
@@ -60,6 +62,7 @@
60
62
  - id: code
61
63
  name: Code
62
64
  emojiIcon: "💻"
65
+ summary: Implements solutions, writes tests, and iterates to completion
63
66
  description:
64
67
  Your primary task is to implement the solution. Write code, write tests, and
65
68
  iterate until the implementation is complete.
@@ -83,6 +86,8 @@
83
86
  - id: review
84
87
  name: Review
85
88
  emojiIcon: "🔍"
89
+ summary:
90
+ Verifies implementation, tests acceptance criteria, and documents findings
86
91
  description:
87
92
  Your primary task is to verify the implementation works correctly. Run the
88
93
  application, test against acceptance criteria, document findings.
@@ -116,6 +121,7 @@
116
121
  - id: deploy
117
122
  name: Deploy
118
123
  emojiIcon: "🚀"
124
+ summary: Ships changes to production and monitors deployment workflows
119
125
  description:
120
126
  Your primary task is to ship the changes to production. Push code, monitor
121
127
  CI/CD workflows, and verify successful deployment.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forwardimpact/schema",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "Schema definitions and data loading for skills, behaviours, and role frameworks",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
package/schema/json/capability.schema.json CHANGED
@@ -95,7 +95,7 @@
95
95
  },
96
96
  "toolReferences": {
97
97
  "type": "array",
98
- "description": "Recommended tools for this skill",
98
+ "description": "Required tools for this skill",
99
99
  "items": { "$ref": "#/$defs/toolReference" }
100
100
  }
101
101
  },
package/schema/json/stages.schema.json CHANGED
@@ -27,7 +27,11 @@
27
27
  },
28
28
  "description": {
29
29
  "type": "string",
30
- "description": "Description of the stage's purpose"
30
+ "description": "Description of the stage's purpose (second-person, for agent body)"
31
+ },
32
+ "summary": {
33
+ "type": "string",
34
+ "description": "Third-person summary for metadata, listings, and sub-agent descriptions"
31
35
  },
32
36
  "handoffs": {
33
37
  "type": "array",
package/schema/rdf/capability.ttl CHANGED
@@ -85,7 +85,7 @@ fit:implementationReference a rdf:Property ;
85
85
 
86
86
  fit:toolReferences a rdf:Property ;
87
87
  rdfs:label "toolReferences"@en ;
88
- rdfs:comment "Recommended tools for this skill"@en ;
88
+ rdfs:comment "Required tools for this skill"@en ;
89
89
  rdfs:domain fit:Skill ;
90
90
  rdfs:range fit:ToolReference .
91
91
 
@@ -288,7 +288,7 @@ fit:SkillShape a sh:NodeShape ;
288
288
  sh:path fit:toolReferences ;
289
289
  sh:node fit:ToolReferenceShape ;
290
290
  sh:name "toolReferences" ;
291
- sh:description "Recommended tools for this skill" ;
291
+ sh:description "Required tools for this skill" ;
292
292
  ] .
293
293
 
294
294
  # -----------------------------------------------------------------------------
package/schema/rdf/stages.ttl CHANGED
@@ -33,6 +33,17 @@ fit:entryCriteria a rdf:Property ;
33
33
  rdfs:comment "Conditions that must be met before entering this stage"@en ;
34
34
  rdfs:range xsd:string .
35
35
 
36
+ fit:exitCriteria a rdf:Property ;
37
+ rdfs:label "exitCriteria"@en ;
38
+ rdfs:comment "Conditions that must be met before leaving this stage"@en ;
39
+ rdfs:range xsd:string .
40
+
41
+ fit:summary a rdf:Property ;
42
+ rdfs:label "summary"@en ;
43
+ rdfs:comment "Third-person summary for metadata, listings, and sub-agent descriptions"@en ;
44
+ rdfs:domain fit:Stage ;
45
+ rdfs:range xsd:string .
46
+
36
47
  fit:targetStage a rdf:Property ;
37
48
  rdfs:label "targetStage"@en ;
38
49
  rdfs:comment "The stage to transition to"@en ;
@@ -63,7 +74,7 @@ fit:StageShape a sh:NodeShape ;
63
74
  sh:targetClass fit:Stage ;
64
75
  sh:property [
65
76
  sh:path fit:id ;
66
- sh:in ( "plan" "code" "review" ) ;
77
+ sh:in ( "specify" "plan" "code" "review" "deploy" ) ;
67
78
  sh:minCount 1 ;
68
79
  sh:maxCount 1 ;
69
80
  sh:name "id" ;
@@ -89,7 +100,14 @@ fit:StageShape a sh:NodeShape ;
89
100
  sh:datatype xsd:string ;
90
101
  sh:maxCount 1 ;
91
102
  sh:name "description" ;
92
- sh:description "Description of the stage's purpose" ;
103
+ sh:description "Description of the stage's purpose (second-person, for agent body)" ;
104
+ ] ;
105
+ sh:property [
106
+ sh:path fit:summary ;
107
+ sh:datatype xsd:string ;
108
+ sh:maxCount 1 ;
109
+ sh:name "summary" ;
110
+ sh:description "Third-person summary for metadata, listings, and sub-agent descriptions" ;
93
111
  ] ;
94
112
  sh:property [
95
113
  sh:path fit:handoffs ;
@@ -108,6 +126,12 @@ fit:StageShape a sh:NodeShape ;
108
126
  sh:datatype xsd:string ;
109
127
  sh:name "entryCriteria" ;
110
128
  sh:description "Conditions that must be met before entering this stage" ;
129
+ ] ;
130
+ sh:property [
131
+ sh:path fit:exitCriteria ;
132
+ sh:datatype xsd:string ;
133
+ sh:name "exitCriteria" ;
134
+ sh:description "Conditions that must be met before leaving this stage" ;
111
135
  ] .
112
136
 
113
137
  # -----------------------------------------------------------------------------
@@ -118,7 +142,7 @@ fit:HandoffShape a sh:NodeShape ;
118
142
  sh:targetClass fit:Handoff ;
119
143
  sh:property [
120
144
  sh:path fit:targetStage ;
121
- sh:in ( "plan" "code" "review" ) ;
145
+ sh:in ( "specify" "plan" "code" "review" "deploy" ) ;
122
146
  sh:minCount 1 ;
123
147
  sh:maxCount 1 ;
124
148
  sh:name "targetStage" ;