Backpropagate Specs

Use when code changes should be scanned and reflected back into living specs, docs, or architecture notes without changing product intent.

Julius Brussee Updated 120k repo stars

File contents

Backpropagate Specs

Use when implementation facts changed specs/docs.

Workflow

  1. Generate grounded prompt: python3 bin/loop-factory backprop --agent codex
  2. Read generated prompt under factory/prompts/backprop.codex.md.
  3. Inspect git diff directly if needed.
  4. Update only stale facts in specs/docs.
  5. Add TODO/open question when implementation exposed missing decision.
  6. Run relevant checks if docs/spec tests exist.

Rules

  • Do not rewrite intent to match accidental implementation.
  • Do not invent acceptance criteria.
  • Keep edits minimal.
  • Link changes to files or diff evidence.
  • Leave archive specs immutable unless user asks to correct historical record.

juliusbrussee/loop-factory commit 6e39caa63e

Frequently asked questions

npx get-skill add juliusbrussee/backpropagate-specs