Files
Tabish Bidiwale 8dcd1707ee proposal: add instruction loader and schema restructure (Slice 3) (#410)
* 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.

* fix: include full requirement block in MODIFIED spec

Update the Schema Loading requirement to include all original scenarios
(modified as needed) per the MODIFIED requirement guidelines. The archiver
replaces the entire requirement with the provided content.
2025-12-26 23:45:36 +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