Prompt-file lifecycle: draft/ active/ complete/ — structure + rewire (PR-A, #71)

[Jammy2211]

PR-A: draft/ active/ complete/ prompt-file lifecycle — structure + engine + rewire

Part of #71 (PR-A of 2). Advances the prompt file through three top-level
states that mirror the active.md → complete.md ledger, so issued/ stops
being an append-only 444-file pile of done + in-flight prompts.

draft/<work-type>/<target>/<name>.md   not started (was the bare work-type dirs)
active/<name>.md                        issued, in flight (was issued/)
complete/<YYYY>/<MM>/<slug>.md          shipped — rich records (complete/AGENTS.md)

Structure (git mv — history preserved; ~535 of the changed files are pure renames)

• issued/ → active/ (440 files, wholesale rename; the intelligent sort of
  these into complete/ is PR-B).
• work-type dirs (feature/ bug/ refactor/ docs/ test/ maintenance/ research/ triage/) → draft/. docs/ was split: only Type:-headed prompts moved to
  draft/docs/; reference material (docs/pyautobrain/spawn_spec.md etc.)
  stays in docs/.
• new complete/ + complete/AGENTS.md (archive schema).

Engine

• scripts/lifecycle.py (stdlib-only): move (active→complete/YYYY/MM by the
  complete.md completed: date), split-complete, migrate, check (drift
  guard, mirrors repos_sync --check). safe_name() sanitises slugs so
  spaces// round-trip.

Rewire

• spawn.py rules (draft/* SKELETON, active/+complete/ DROP,
  complete/AGENTS.md KEEP first-match) + docs/pyautobrain/spawn_spec.md table.
• status.sh (draft inventory, active/complete lifecycle dirs), prompt_sync.sh
  (idea-sweep excludes active/ + complete/).
• docs: AGENTS.md, README.md, REFERENCE.md, ROUTING.md.

Validation

• lifecycle.py check OK; spawn.py dry-run unmatched: none (exit 0);
  status.sh clean; draft→active→complete/2026/07 round-trip smoke passed.

Coupled + follow-ups

• Skills half of PR-A is Wire dev workflow to draft/ active/ complete/ lifecycle (PR-A, #71) PyAutoBrain#109 (create_issue/ship_*/start_dev/intake).
• Post-merge: republish the PyAutoMind-template (deferred so it tracks
  main, not this branch) — spawn --check / spawn_drift is expected red
  until then.
• PR-B: lifecycle.py migrate/split-complete to sort active/ into
  complete/YYYY/MM/ + split complete.md, behind a review manifest.

🤖 Generated with Claude Code