@really-knows-ai/foundry 1.0.0 → 1.1.0

package/.opencode/plugins/foundry.js

@@ -1,9 +1,9 @@
 /**
  * Foundry plugin for OpenCode.ai
  *
- * Conditional bootstrap:
- * - If foundry/ exists in project: full skill registration + pipeline context
- * - If foundry/ does not exist: only init-foundry skill + minimal prompt
+ * All skills are always registered. Individual skills check for foundry/ dir.
+ * - If foundry/ exists: pipeline context + multi-model agent registration
+ * - If foundry/ does not exist: minimal prompt guiding user to init-foundry
  */
 
 import path from 'path';
@@ -56,11 +56,12 @@ export const FoundryPlugin = async ({ client, directory }) => {
       config.skills = config.skills || {};
       config.skills.paths = config.skills.paths || [];
 
-      if (foundryExists) {
-        if (!config.skills.paths.includes(allSkillsDir)) {
-          config.skills.paths.push(allSkillsDir);
-        }
+      // Always register all skills — individual skills check for foundry/ dir
+      if (!config.skills.paths.includes(allSkillsDir)) {
+        config.skills.paths.push(allSkillsDir);
+      }
 
+      if (foundryExists) {
         // Register per-model subagents for multi-model stage routing
         try {
           const providers = await client.provider.list();
@@ -83,10 +84,6 @@ export const FoundryPlugin = async ({ client, directory }) => {
         } catch (err) {
           console.warn('[foundry] Failed to discover models for agent registration:', err.message);
         }
-      } else {
-        if (!config.skills.paths.includes(initSkillDir)) {
-          config.skills.paths.push(initSkillDir);
-        }
       }
     },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@really-knows-ai/foundry",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A structured framework for AI-driven artefact creation with deterministic routing, quality gates, and iterative refinement cycles.",
   "type": "module",
   "main": ".opencode/plugins/foundry.js",

package/skills/add-appraiser/SKILL.md

@@ -8,6 +8,12 @@ description: Creates a new appraiser personality, checking for semantic overlap
 
 You help the user create a new appraiser personality. You ensure it's genuinely distinct from existing appraisers and scaffold the definition file.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### 1. Gather basics

package/skills/add-artefact-type/SKILL.md

@@ -8,6 +8,12 @@ description: Creates a new artefact type, checking for conflicts with existing t
 
 You help the user create a new artefact type. You ensure it doesn't conflict with existing types, scaffold the directory structure, and walk the user through defining laws and validation.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### 1. Gather basics

package/skills/add-cycle/SKILL.md

@@ -8,6 +8,12 @@ description: Creates a new foundry cycle within a foundry flow, specifying the o
 
 You help the user create a new foundry cycle and add it to an existing foundry flow. A foundry cycle produces one artefact type (read-write) and optionally reads from artefact types produced by earlier foundry cycles (read-only).
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### 1. Identify the foundry flow

package/skills/add-flow/SKILL.md

@@ -8,6 +8,12 @@ description: Creates a new foundry flow definition.
 
 You help the user create a new foundry flow. A foundry flow is an ordered list of foundry cycles that transforms a request into finished artefacts.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### 1. Gather basics

package/skills/add-law/SKILL.md

@@ -8,6 +8,12 @@ description: Creates a new law, checking for conflicts with existing laws.
 
 You help the user create a new law. You ensure it's well-scoped, doesn't conflict with existing laws, and ends up in the right file.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### 1. Determine scope

package/skills/appraise/SKILL.md

@@ -8,6 +8,12 @@ description: Subjective evaluation of an artefact against laws via multiple inde
 
 You orchestrate subjective appraisal of an artefact by dispatching independent sub-agent appraisers, then consolidating their feedback into WORK.md.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Appraiser configuration
 
 Appraiser personalities are defined in `foundry/appraisers/` (the appraiser directory). Each markdown file defines:

package/skills/cycle/SKILL.md

@@ -9,6 +9,12 @@ composes: [sort, forge, quench, appraise, hitl]
 
 A foundry cycle reads its definition from `foundry/cycles/<cycle-id>.md`, sets up WORK.md for routing, then hands control to the sort skill which drives the forge → quench → appraise loop.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Cycle definition
 
 The cycle definition (`foundry/cycles/<cycle-id>.md`) specifies:

package/skills/flow/SKILL.md

@@ -9,6 +9,12 @@ composes: [cycle]
 
 A foundry flow reads a flow definition from `foundry/flows/`, creates a work branch, initialises WORK.md, and executes each foundry cycle in sequence.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Starting a foundry flow
 
 1. Read the flow definition from `foundry/flows/<flow-id>.md`

package/skills/forge/SKILL.md

@@ -8,6 +8,12 @@ description: Produces or revises an artefact, guided by WORK.md and the foundry
 
 You produce or revise artefacts. You read WORK.md to understand the goal and feedback, and the foundry cycle definition to understand what you're producing and what inputs you can read.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 ### First generation (no artefact registered in WORK.md yet)

package/skills/hitl/SKILL.md

@@ -8,6 +8,12 @@ description: Human-in-the-loop checkpoint. Pauses the cycle for human input befo
 
 You are a human-in-the-loop checkpoint. Sort has routed to you because the cycle definition includes a pause point here. Your job is to present context, ask the human whatever needs asking, record their response, and return control to sort.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 1. Read `WORK.md` — understand the current state: goal, artefacts, feedback

package/skills/quench/SKILL.md

@@ -8,6 +8,12 @@ description: Deterministic validation of an artefact by running CLI commands. Wr
 
 You run deterministic checks on an artefact by executing the CLI commands defined in the artefact type's validation file. No judgment — commands pass or fail.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## When this skill applies
 
 This skill only runs if `foundry/artefacts/<type>/validation.md` exists. If there is no validation file for the artefact type, this skill is skipped.

package/skills/sort/SKILL.md

@@ -8,6 +8,12 @@ description: Deterministic routing for a foundry cycle. Runs scripts/sort.js and
 
 You are the central dispatcher for a foundry cycle. You run the sort script to determine what stage to execute next, then invoke that stage's skill.
 
+## Prerequisites
+
+Before running this skill, verify that the `foundry/` directory exists in the project root. If it does not exist, stop and tell the user:
+
+> Foundry is not initialized in this project. Run the `init-foundry` skill first to create the foundry/ directory structure.
+
 ## Protocol
 
 1. Run the sort script: