chore: initialize POM 2 repo (docs guards green; release gates recorded NOT RUN pending install)

skills/pom/references/agent-studios.md

@@ -0,0 +1,34 @@
+# POM agent studios
+
+One task batch per independent wave.
+
+Shared context:
+- Goal
+- Constraints
+- Contract
+
+Every assignment:
+- Target
+- Change
+- Acceptance
+
+Stage studios:
+- T0 architect
+- T1 researcher + concept forge + critic
+- T2 voice architect + rights auditor
+- T3 concept forge + critic
+- T4 story architect + character/world + continuity + visual
+- T5 structure + continuity + critic
+- T6 structure + continuity + visual
+- T7 prose + developmental editor + continuity
+- T8 delivery + rights + continuity
+
+Rules:
+- main agent integrates and owns final decisions
+- scouts investigate only; editing agents own explicit files
+- no duplicated shared context
+- no generic cloned workers
+- no project-wide formatters/tests inside children
+- local:// for bulk context, agent:// for outputs, history:// for transcripts
+- IRC for overlap, blockers, and follow-up
+- isolate only code-changing extension development, not ordinary story artifacts

skills/pom/references/artifacts.md

@@ -0,0 +1,21 @@
+# POM artifact system
+
+- README.md
+- 00_admin: state, manifest, SHA256SUMS, inventory
+- 01_planning: brief, genre, persona options, story store, selected direction
+- 02_story_bible: identity, voice, cast, relations, world, locations, factions, rules, themes, frameworks, timeline, canon, payoff, style, visual bible
+- 03_manuscript: master outline, chapter outline, scene index, complete manuscript, chapters
+- 04_images: references, briefs, prompts, drafts, finals, alt text, metadata
+- 05_research: plan, sources, notes, fact/invention, rights
+- 06_ledgers: decisions, assumptions, revisions, continuity, quality, validation
+- 07_exports: formats, reports, ZIP
+
+Law:
+- lowercase portable filenames
+- semantic versions
+- atomic writes
+- measured bytes and SHA-256
+- register every claimed artifact
+- checkpoint ZIP only on request or major milestone
+- final ZIP always fresh and member-tested
+- ZIP cannot recursively manifest itself; final archive hash lives in the external delivery sidecar

skills/pom/references/commands.md

@@ -0,0 +1,21 @@
+# `/pom` command tree
+
+- `/pom` — command-center overlay
+- `/pom new <title>` — create project, vault, ledgers, state, and Git root
+- `/pom resume [state-path]` — restore canonical state
+- `/pom run [next|all|0..8]` — start authoritative production
+- `/pom hive [lean|stage|audit]` — queue a native task + IRC specialist wave
+- `/pom swarm [parallel|sequential|pipeline] [count]` — generate optional Swarm YAML
+- `/pom evidence` — record file-backed gate evidence
+- `/pom check [quick|stage|canon|continuity|knowledge|files|delivery|all]`
+- `/pom vault` — insert `@content/production-board.md`
+- `/pom status [--json]`
+- `/pom export [checkpoint|final]`
+- `/pom prompt [list|show|run] [id]`
+- `/pom tools [show|reset|profile <name>]`
+- `/pom theme install`
+- `/pom settings`
+- `/pom doctor`
+- `/pom help`
+
+All model-facing production actions use the seven typed `pom_*` tools. No other POM slash-command root is registered.

skills/pom/references/core-law.jml

@@ -0,0 +1,53 @@
+# 🎭 POM 2 compact operating law
+
+IDENTITY
+- OMP-native production kernel, idea → validated package, stages 0–8.
+- OMP executes models/tools/task/IRC/todo/sessions/approvals/compaction.
+- POM governs contracts/evidence/blockers/prompts/canon/artifacts/Git/validation/delivery.
+
+TRUTH
+- System + explicit user requirements > canonical files > manifest/ledgers > live OMP execution > vault projection > memory.
+- Never fake tool use, files, citations, images, counts, hashes, checks, ZIP tests, or completion.
+- Partial stays partial. Missing stays disclosed. Blocked stays blocked.
+
+STAGE GATE
+- Earlier stages complete.
+- Target stage actively running.
+- Required artifacts substantive and structurally valid.
+- Every acceptance criterion has project-relative evidence paths.
+- No unresolved blocker.
+- Deterministic report PASS.
+- Then, and only then, call `pom_stage` action `pass`.
+
+DELEGATION
+- One widest safe native task batch per independent wave.
+- Each specialist has objective, owned files, and acceptance conditions.
+- IRC vocabulary: CLAIM / QUERY / ANSWER / ALERT / HANDOFF / DONE.
+- IRC is terse; durable analysis goes into files or Hive ledger.
+- Main agent integrates and owns canon decisions.
+- Optional Swarm YAML for unattended fan-out/fan-in execution.
+
+PROMPTS
+- immutable POM law → selected personality → stage/autopilot fragment → executable stage contract → project override.
+- Hash and record every active fragment.
+
+ARTIFACTS
+- Canonical realpath containment; reject traversal and symlink escape.
+- Non-empty regular files only.
+- Preserve category/stage/version/status/bytes/SHA-256/rights/source/notes.
+- Artifact registration advances semantic patch version; canon categories also advance canon version.
+
+VISUALS
+- Status = peripheral truth.
+- HUD = persistent production state.
+- Working message = current semantic phase.
+- Cards = durable validation/Hive/milestone events.
+- Overlay = deliberate operator control.
+- Reward evidence, resolved blockers, clean handoffs, stage PASS, and verified archives—not activity.
+
+DELIVERY
+- Fresh archive.
+- Safe member names, no duplicates/encryption/unsupported methods.
+- Parse central directory; decompress every member; verify size + CRC-32.
+- Hash archive; write external verification report.
+- Disclose warnings and omissions.

skills/pom/references/qa.md

@@ -0,0 +1,18 @@
+# POM QA20
+
+Intent, user alignment, originality, genre promise, concept clarity, narrative engine, causality, agency, character continuity, world continuity, thematic integrity, setup/payoff, pacing, emotional logic, voice, readability, research integrity, visual integrity, artifact integrity, truthfulness.
+
+Rights:
+- no distinctive living-author imitation
+- no fabricated quotations or attribution
+- no unauthorized third-party redistribution
+- no invented private identity details
+- minimum necessary personal data
+- fictional framing does not justify operational harm
+
+Completion:
+- fix material defects before pass
+- no objective perfection claims
+- partial remains PARTIAL
+- missing remains disclosed
+- 100% only after requested measurable gates pass

skills/pom/references/todo-blueprints.md

@@ -0,0 +1,105 @@
+# POM todo blueprints
+
+Native todo is the only live task tracker. The active stage prompt instructs OMP to initialize the exact phase blueprint from `src/domain.ts`; POM does not maintain a competing todo database.
+
+## T0 Foundation
+- Resolve project identity
+- Define creative north star
+- Record constraints and assumptions
+- Create project brief
+- Initialize canonical state
+- Validate Task 0 gate
+
+## T1 Genre
+- Map genre candidates
+- Research current genre context
+- Analyze clichés and differentiation
+- Build fusion matrix
+- Rank top directions
+- Lock genre promise
+- Save grid and matrix
+- Validate Task 1 gate
+
+## T2 Voice
+- Design original persona
+- Define audience and philosophy
+- Check rights boundaries
+- Define voice profile
+- Write always and avoid laws
+- Create original sample
+- Save persona and guide
+- Validate Task 2 gate
+
+## T3 Store
+- Generate twenty diverse concepts
+- Enforce structural diversity
+- Score concept potential
+- Rank strongest five
+- Compare top three
+- Select and strengthen winner
+- Save store and direction
+- Validate Task 3 gate
+
+## T4 Bible
+- Finalize story identity
+- Write full ending synopsis
+- Define dramatic and thematic questions
+- Build character bible
+- Build world and rules
+- Build themes and frameworks
+- Create timeline and ledgers
+- Map mysteries and payoffs
+- Create visual bible
+- Run continuity audit
+- Resolve contradictions
+- Validate Task 4 gate
+
+## T5 Outline
+- Design acts and sequences
+- Map turning points
+- Allocate narrative weight
+- Build causal scene index
+- Track state changes
+- Link setups and payoffs
+- Audit agency and escalation
+- Repair weak causality
+- Validate Task 5 gate
+
+## T6 Chapters
+- Map every chapter
+- Define chapter state changes
+- Balance POV and pacing
+- Verify timeline transitions
+- Verify reveals and payoffs
+- Prepare representative visual
+- Save chapter outline
+- Update scene index
+- Validate Task 6 gate
+
+## T7 Draft
+- Load chapter dependencies
+- Verify current canon state
+- Set chapter objective
+- Draft complete chapter
+- Preserve voice and POV
+- End in changed state
+- Measure words
+- Run voice and repetition checks
+- Update canon and ledgers
+- Repeat remaining chapters
+- Run full manuscript review
+- Validate Task 7 gate
+
+## T8 Delivery
+- Compile manuscript
+- Compile requested exports
+- Assemble approved visuals
+- Run structure and content checks
+- Run continuity and rights checks
+- Verify manifest and hashes
+- Create fresh final ZIP
+- Test every ZIP member
+- Write delivery report
+- Provide real artifact path
+- Disclose warnings and omissions
+- Validate Task 8 gate

skills/pom/references/tool-routing.md

@@ -0,0 +1,43 @@
+# POM tool routing
+
+## Discovery and reading
+- read: files, directories, archives, databases, documents, internal URIs, static URLs; parallelize independent reads
+- glob: bounded path discovery
+- grep: bounded regex search
+- ast_grep: syntax-shape search
+- inspect_image: evidence-grounded image analysis
+- web_search: current public discovery; primary sources first
+- browser: authenticated, interactive, or JavaScript-only pages
+
+## Changing and computing
+- edit: grounded hash-anchored edits to existing files; reread after every edit
+- write: new files or intentional complete replacement
+- lsp: definitions, references, rename, diagnostics, code actions; mandatory for symbol-aware work
+- ast_edit: structural codemods when text edits are unsafe
+- eval: persistent multi-step computation, schemas, pipelines, local:// context, agent DAGs
+- bash: one real binary or short fact pipeline; never a shell program
+- debug: breakpoints, stepping, threads, variables, runtime state
+
+## Orchestration
+- task: widest safe specialist fan-out; one shared context, complete assignments
+- job: intervention only; results arrive automatically
+- irc: coordinate existing peers and avoid duplicate work
+- todo: exact phased execution state; every required item explicit
+- ask: only material user tradeoffs after exhausting sources
+- resolve: explicit pending-action approval
+- learn/manage_skill: reusable lessons and repeatable procedures only
+- generate_image: complete brief, generation/edit, then mandatory inspection
+
+## Profiles
+- creative: read/search, edit/write, eval, task/IRC/todo, image
+- research: read/web/browser, inspection, eval, task/IRC/todo
+- draft: read/edit/write, eval, task/IRC/todo, image
+- audit: read/search, AST/LSP, eval, task/IRC/todo
+- delivery: read/write/edit, short binaries/eval, checksums, ZIP, resolve
+
+## Law
+- native tool first; MCP only for trusted external capabilities
+- never use browser when read can retrieve static content
+- never use text rename when LSP can preserve symbol semantics
+- never poll agents unless all useful parent work is blocked
+- never duplicate native todo, task, IRC, memory, approval, compaction, or session truth inside POM

skills/pom/references/ui.md

@@ -0,0 +1,28 @@
+# POM terminal UI
+
+## Surface hierarchy
+
+- status line: stage, progress, gate/blocker, Hive, approval, retry
+- HUD widget: persistent contract, evidence, blockers, active work
+- working message: exact current semantic phase
+- custom cards: validation, Hive, milestones, important events
+- tool renderers: compact call, partial update, pass/fail result, expanded evidence
+- `/pom` overlay: run, Hive, validate, evidence, vault, export, themes, settings
+- thinking lane: optional stage/execution annotation beneath visible thinking
+
+## Density
+
+- cinematic: three-line HUD, stage track, richer cards and coordination cues
+- rich: two-line evidence HUD and detailed cards
+- compact: one-line HUD and terse cards
+- minimal: status plus critical cards; no persistent widget
+
+## Motion
+
+- off: static semantic symbols
+- subtle: two-frame work pulse
+- full: four-frame activity cue and stronger live coordination feedback
+
+## Law
+
+Use OMP theme tokens and visual-width utilities. Never emit raw ANSI control sequences. Keep custom TUI optional: headless/RPC/ACP operation must still work through textual tools and canonical files.

skills/pom/references/workflow.md

@@ -0,0 +1,55 @@
+# POM workflow
+
+## Task 0 — Project Initialization
+- profile creative
+- agents pom-architect
+- output identity, north star, brief, assumptions, roadmap
+- gate identity resolved, foundational ambiguity cleared
+
+## Task 1 — Genre Architecture
+- profile research
+- agents researcher, concept forge, critic
+- output full genre grid, 8–15 fusions, top three, risks, promise, choice, key art
+- gate primary genre selected, promise and cliché risks recorded
+
+## Task 2 — Author Persona and Voice
+- profile creative
+- agents voice architect, rights auditor
+- output original persona, complete voice profile, laws, tags, sample, portrait
+- gate another editor can consistently test prose against the guide
+
+## Task 3 — Story Store
+- profile creative
+- agents concept forge, critic
+- output exactly twenty structurally diverse concepts, strongest five, top three, winner, upgrade
+- gate one stable premise selected
+
+## Task 4 — Story Blueprint and Bible
+- profile creative
+- agents story architect, character/world, continuity, visual
+- output full ending, cast, relationships, world, systems, rules, themes, frameworks, timeline, canon, mysteries, payoffs, visual bible
+- gate ending known, arcs and rules stable, canon supports outline
+
+## Task 5 — Master Story Outline
+- profile creative
+- agents structure, continuity, critic
+- output acts, sequences, beats, scenes, state changes, setup/payoff
+- gate ending represented, causality and escalation survive review
+
+## Task 6 — Chapter Architecture
+- profile creative
+- agents structure, continuity, visual
+- output every chapter, scenes, objectives, reversals, hooks, word allocation, representative art
+- gate no gaps, redundancy, unsupported payoff, impossible timeline, or broken POV logic
+
+## Task 7 — Drafting and Revision
+- profile draft
+- agents prose, developmental editor, continuity
+- output complete chapter files, canonical deltas, measured words, reviewed manuscript
+- gate every planned chapter complete, continuity resolved or disclosed
+
+## Task 8 — Final Compilation and Delivery
+- profile delivery
+- agents delivery, rights, continuity
+- output compiled artifacts, manifest, checksums, exports, fresh tested ZIP, report, real path
+- gate files exist, hashes match, every ZIP member passes decompression/CRC, omissions disclosed