Creation Feasibility Gate

Creation Feasibility Gate

Overview

Run a fast preflight feasibility check before creating a new agent/skill/workflow/hook/template/schema. This prevents low-value or impossible creator runs.

When to Use

• Phase 0.5 dynamic creation flow
• User asks for net-new capability
• Reflection/evolution recommends artifact creation

Iron Laws

1. NEVER create artifacts inside this skill — return PASS/WARN/BLOCK with evidence only; all actual creation happens in the appropriate creator skill downstream.
2. ALWAYS run the existence/duplication check first — never proceed toward PASS if a functionally identical artifact already exists in any catalog or registry.
3. ALWAYS include concrete file-level evidence for every decision — a bare PASS or BLOCK without referencing specific paths or catalog entries is a spec violation.
4. NEVER let WARN silently become PASS — every WARN must list exact caveats that the calling agent must acknowledge before creation proceeds.
5. ALWAYS resolve BLOCK status with actionable next steps and recommended target agents — a BLOCK without remediation tasks is an incomplete gate decision.

Anti-Patterns

Workflow

Step 1: Resolve Target

• Identify proposed artifact type and name
• Identify expected runtime/tool dependencies
• Identify expected owner agents

Step 2: Existence/Duplication Check (Iron Law #2)

Use the shared duplicate detection library:

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: artifactType, // from Step 1 classification
  name: proposedName,
  description: proposedDescription,
});

if (result.decision === 'EXACT_MATCH') {
  return {
    gate: 'BLOCK',
    reason: `Artifact exists at ${result.matchedPath}. Use the ${artifactType}-updater skill instead.`,
  };
}
if (result.decision === 'REGISTRY_MATCH') {
  return {
    gate: 'WARN',
    reason: `"${proposedName}" found in ${result.message} but file may be missing. Investigate.`,
  };
}
if (result.decision === 'SIMILAR_FOUND') {
  return {
    gate: 'WARN',
    reason: `Similar artifacts found: ${result.candidates.map(c => `${c.name} (${(c.score * 100).toFixed(0)}%)`).join(', ')}. Confirm creation is intentional.`,
  };
}
return { gate: 'PASS' };

The 3 detection layers (filesystem, registry/catalog, fuzzy/semantic) are handled internally by the library. See .claude/lib/creation/duplicate-detector.cjs for details.

Step 2.5: Additional Preflight Checks

Run these checks with concrete evidence:

1. Stack compatibility check
   • Required tooling/runtime present in current project conventions
2. Integration readiness check
   • Can it be routed/discovered/assigned after creation?
3. Security/creator boundary check
   • Ensure creator path and governance can be satisfied

Step 3: Decision

Return one status:

• PASS: creation is feasible now
• WARN: feasible with clear caveats
• BLOCK: not feasible; must resolve blockers first

Use this output shape:

{
  "status": "PASS|WARN|BLOCK",
  "artifactType": "agent|skill|workflow|hook|template|schema",
  "artifactName": "example-name",
  "evidence": ["..."],
  "blockers": [],
  "nextActions": ["..."]
}

Output Protocol

If BLOCK, include concrete remediation tasks and recommended target agents. If PASS or WARN, include exact creator skill chain to run next.

Memory Protocol

Record feasibility patterns and recurring blockers to .claude/context/memory/learnings.md.