# Preserve and update PROMPT.md workflow

Audience: AI coding agents first.

## Outcome

Preserve owner-authored `PROMPT.md` taxonomy change in `main`, then update fresh copy so workflow converts source theme as-is into Gutenberg blocks without visual or markup drift.

## Status

DONE — committed in isolated worktree; ready to land and push.

## Task IDs

- #1 Commit existing `PROMPT.md` changes.
- #2 Update Gutenberg methodology.

## Source request

Owner requested: commit and push current `PROMPT.md` changes first; then work from fresh copy. Required methodology: do not rebuild theme from scratch; preserve original HTML, CSS, JS, and design; convert every section/component/area into Gutenberg blocks; include imported demo matching original HTML visually while remaining functionally distinct per existing prompt.

## Acceptance criteria

1. Owner's current taxonomy edit committed and pushed unchanged before new edit begins.
2. Fresh branch/worktree includes pushed commit.
3. `PROMPT.md` explicitly requires source-preserving conversion, not redesign/rebuild.
4. Every section/component/area maps to Gutenberg blocks without rewriting source HTML structure.
5. Original CSS and behavior-bearing JS remain source of visual parity unless Gutenberg integration requires narrowly scoped adaptation.
6. Imported demo uses original source structure/assets and is visually identical.
7. Existing functional-difference requirements remain authoritative.
8. Final diff is narrow, reviewed, committed, and pushed.

## Preserved WIP / refs / paths

- Owner WIP: shared checkout `/home/user/Projects/Press.zone/ThemeFactory/PROMPT.md`.
- Isolated worktree: `.worktrees/prompt-gutenberg-methodology`.
- Initial branch base: `afb4c87`.
- Owner WIP diff adds taxonomy decision prompt before `# TAXONOMIES` guidance.

## Constraints

- NEVER overwrite or reformat owner WIP.
- Preserve exact HTML/CSS/design; do not reinterpret visual design.
- Keep existing functional-difference doctrine; add methodology only.
- Agent-facing prose: imperative, scoped, BLUF, caveman register.
- Touch only `PROMPT.md` plus durable plan registry.

## Execution steps

1. Review owner WIP diff and repository status.
2. Commit only owner `PROMPT.md` change; push `main`.
3. Rebase/reset isolated worktree branch onto updated `origin/main` without touching shared WIP.
4. Read relevant `PROMPT.md` workflow/import/Gutenberg sections.
5. Add one canonical source-preservation methodology and reference it where needed.
6. Review diff for visual-parity invariants, functional separation, duplication, ambiguity.
7. Verify formatting and repository checks applicable to documentation.
8. Commit, land, and push final update.

## Current receipt

- 2026-08-11: Created isolated worktree from `afb4c87`.
- 2026-08-11: Reviewed owner WIP; only tracked change is taxonomy guidance addition. `.worktrees/` is untracked infrastructure and MUST NOT be committed.
- 2026-08-11: Initial plan-index probe failed due sandbox command rewriting; reran with native shell and confirmed no existing registry.
- 2026-08-11: Created plan registry in isolated worktree.
- 2026-08-11: Committed owner taxonomy edit as `0a79c5b` and pushed `main`.
- 2026-08-11: Rebased isolated branch onto pushed `origin/main`.
- 2026-08-11: Added source-preserving Gutenberg conversion, imported-demo parity, per-component block composition, original CSS/JS retention, and exact-output verification rules.
- 2026-08-11: Independent review found seven prompt risks; resolved token-system conflict, Gutenberg construct ambiguity, monolithic-block escape hatch, functional-variant preservation, deviation criteria, static/dynamic ambiguity, and overbroad markup-fix permission.
- 2026-08-11: `git diff --check` passed; prompt update committed as `df0e781`.

## Next executable action

None. Delivery complete after fast-forwarding `main` and pushing `origin/main`.