@forwardimpact/model 0.9.0 → 1.0.0

package/README.md

@@ -1,19 +1,19 @@
 # @forwardimpact/model
 
-Derivation engine for roles, skills, and AI agent profiles.
+Derivation engine for roles, skills, and agent team profiles.
 
 ## Role in the Vision
 
 The model package contains the core logic that transforms raw data into
 actionable role definitions. Whether you're generating a human job description
-or an AI agent profile, the same derivation engine ensures consistent
+or a coding agent team profile, the same derivation engine ensures consistent
 expectations across both.
 
 ## What It Does
 
 - **Job derivation** — Combine discipline, track, and grade into complete role
   definitions with skill matrices and behaviour profiles
-- **Agent profiles** — Generate AI coding agent configurations from the same
+- **Agent profiles** — Generate coding agent team configurations from the same
   foundation as human roles
 - **Interview preparation** — Select appropriate questions based on role
   requirements

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@forwardimpact/model",
-  "version": "0.9.0",
-  "description": "Derivation engine for roles, skills, and AI agent profiles",
+  "version": "1.0.0",
+  "description": "Derivation engine for roles, skills, and agent team profiles",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/agent.js

@@ -487,7 +487,8 @@ function getChecklistStage(stageId) {
  * @param {Array} params.derivedBehaviours - Behaviours sorted by maturity
  * @param {Array} params.agentBehaviours - Agent behaviour definitions
  * @param {Array} params.skills - All skill definitions (for agent section lookup)
- * @param {Array<{skill: Object, capability: Object, items: string[]}>} params.checklist - Raw checklist from deriveChecklist
+ * @param {Array<{skill: Object, capability: Object, items: string[]}>} params.readChecklist - Read-then-do checklist from deriveChecklist
+ * @param {Array<{skill: Object, capability: Object, items: string[]}>} params.confirmChecklist - Do-then-confirm checklist from deriveChecklist
  * @param {Array<{id: string, name: string, description: string}>} [params.agentIndex] - List of all available agents
  * @returns {Object} Structured profile body data
  */
@@ -501,7 +502,8 @@ function buildStageProfileBodyData({
   derivedBehaviours,
   agentBehaviours,
   skills,
-  checklist,
+  readChecklist,
+  confirmChecklist,
   agentIndex,
 }) {
   const name = `${humanDiscipline.specialization || humanDiscipline.name} - ${humanTrack.name}`;
@@ -565,7 +567,8 @@ function buildStageProfileBodyData({
     skillIndex,
     roleContext,
     workingStyles,
-    confirmChecklist: checklist || [],
+    readChecklist: readChecklist || [],
+    confirmChecklist: confirmChecklist || [],
     constraints,
     agentIndex: filteredAgentIndex,
     hasAgentIndex: filteredAgentIndex.length > 0,
@@ -628,16 +631,19 @@ export function deriveStageAgent({
     stages,
   });
 
-  // Derive checklist from focused skills only
+  // Derive checklists from focused skills only
   const checklistStage = getChecklistStage(stage.id);
-  let checklist = [];
+  let readChecklist = [];
+  let confirmChecklist = [];
   if (checklistStage && capabilities) {
-    checklist = deriveChecklist({
+    const checklists = deriveChecklist({
       stageId: checklistStage,
       skillMatrix: focusedSkills,
       skills,
       capabilities,
     });
+    readChecklist = checklists.readChecklist;
+    confirmChecklist = checklists.confirmChecklist;
   }
 
   return {
@@ -652,7 +658,8 @@ export function deriveStageAgent({
       ...(agentDiscipline.constraints || []),
       ...(agentTrack.constraints || []),
     ],
-    checklist,
+    readChecklist,
+    confirmChecklist,
     agentDiscipline,
     agentTrack,
     agentBehaviours,
@@ -714,7 +721,7 @@ export function generateStageAgentProfile({
   // Build description using shared helper
   const description = buildAgentDescription(discipline, track, stage);
 
-  // Build structured profile body data (pass raw checklist for template iteration)
+  // Build structured profile body data (pass raw checklists for template iteration)
   const bodyData = buildStageProfileBodyData({
     stage,
     humanDiscipline: discipline,
@@ -725,7 +732,8 @@ export function generateStageAgentProfile({
     derivedBehaviours: agent.derivedBehaviours,
     agentBehaviours,
     skills,
-    checklist: agent.checklist,
+    readChecklist: agent.readChecklist,
+    confirmChecklist: agent.confirmChecklist,
     agentIndex,
   });
 

package/src/checklist.js

@@ -1,22 +1,30 @@
 /**
  * Checklist Derivation
  *
- * Checklists are derived from skills with agent.stages.{stage}.confirmChecklist criteria.
- * Each skill defines its own readiness criteria for stage transitions.
+ * Checklists are derived from skills with agent.stages.{stage} criteria.
+ * Each skill defines its own read-then-do and do-then-confirm items
+ * for stage transitions.
  *
- * Checklist = Stage × Skill Matrix × Skill Confirm Checklist
+ * Checklist = Stage × Skill Matrix × Skill Checklists
+ */
+
+/**
+ * @typedef {Object} ChecklistEntry
+ * @property {{id: string, name: string}} skill - Skill info
+ * @property {{id: string, name: string, emojiIcon: string}} capability - Capability info
+ * @property {string[]} items - Checklist items
  */
 
 /**
  * Derive checklist items for a specific stage
- * Returns skills grouped by capability with their ready criteria
+ * Returns read-then-do and do-then-confirm items grouped by skill/capability
  *
  * @param {Object} params
  * @param {string} params.stageId - Current stage (plan, code, review)
  * @param {Array} params.skillMatrix - Derived skill matrix with skill details
  * @param {Array} params.skills - All skills (to look up agent.stages)
  * @param {Array} params.capabilities - All capabilities (for emoji lookup)
- * @returns {Array<{skill: Object, capability: Object, items: string[]}>} Checklist items grouped by skill
+ * @returns {{readChecklist: ChecklistEntry[], confirmChecklist: ChecklistEntry[]}} Checklists by type
  */
 export function deriveChecklist({
   stageId,
@@ -30,7 +38,8 @@ export function deriveChecklist({
   // Build capability lookup
   const capabilityById = new Map(capabilities.map((c) => [c.id, c]));
 
-  const result = [];
+  const readChecklist = [];
+  const confirmChecklist = [];
 
   for (const entry of skillMatrix) {
     const skill = skillById.get(entry.skillId);
@@ -39,11 +48,7 @@ export function deriveChecklist({
     }
 
     const stageData = skill.agent.stages[stageId];
-    if (
-      !stageData ||
-      !stageData.confirmChecklist ||
-      stageData.confirmChecklist.length === 0
-    ) {
+    if (!stageData) {
       continue;
     }
 
@@ -53,28 +58,38 @@ export function deriveChecklist({
       continue;
     }
 
-    result.push({
-      skill: {
-        id: skill.id,
-        name: skill.name,
-      },
-      capability: {
-        id: capability.id,
-        name: capability.name,
-        emojiIcon: capability.emojiIcon,
-      },
-      items: stageData.confirmChecklist,
-    });
+    const skillInfo = { id: skill.id, name: skill.name };
+    const capabilityInfo = {
+      id: capability.id,
+      name: capability.name,
+      emojiIcon: capability.emojiIcon,
+    };
+
+    if (stageData.readChecklist && stageData.readChecklist.length > 0) {
+      readChecklist.push({
+        skill: skillInfo,
+        capability: capabilityInfo,
+        items: stageData.readChecklist,
+      });
+    }
+
+    if (stageData.confirmChecklist && stageData.confirmChecklist.length > 0) {
+      confirmChecklist.push({
+        skill: skillInfo,
+        capability: capabilityInfo,
+        items: stageData.confirmChecklist,
+      });
+    }
   }
 
-  return result;
+  return { readChecklist, confirmChecklist };
 }
 
 /**
  * Format a checklist for display (markdown format)
  * Groups items by skill with capability emoji
  *
- * @param {Array<{skill: Object, capability: Object, items: string[]}>} checklist - Derived checklist
+ * @param {ChecklistEntry[]} checklist - Checklist entries (readChecklist or confirmChecklist)
  * @returns {string} Markdown-formatted checklist
  */
 export function formatChecklistMarkdown(checklist) {