Files
Tabish Bidiwale 702c163048 proposal: add instruction loader and schema restructure (Slice 3)
Adds two change proposals for implementing Slice 3 of the artifact POC:

1. restructure-schema-directories
   - Move schemas from embedded TS objects to self-contained directories
   - Each schema becomes a directory with schema.yaml + templates/
   - Enables co-located templates for user extensibility
   - 2-level resolution: user override → package built-in

2. add-instruction-loader (depends on #1)
   - Load templates from schema directories
   - Enrich templates with change context (dependencies, next steps)
   - Format change status for CLI output
   - New instruction-loader capability

These proposals complete Slice 3 from docs/artifact_poc.md.
2025-12-26 23:13:13 +11:00

895 B

Why

Slice 1 (artifact-graph) provides graph operations and state detection. Slice 2 (change-utils) provides change creation. We now need the ability to load templates for artifacts and enrich them with change-specific context so users/agents know what to create next.

What Changes

  • Add template resolution from schema directories (uses structure from restructure-schema-directories)
  • Add instruction enrichment that injects change context into templates
  • Add status formatting for CLI output
  • New instruction-loader capability

Dependencies

  • Requires restructure-schema-directories to be implemented first (schemas as directories with co-located templates)

Impact

  • Affected specs: New instruction-loader spec
  • Affected code: src/core/artifact-graph/ (new files)
  • Builds on: artifact-graph (Slice 1), uses ArtifactGraph, detectCompleted, resolveSchema