@litfamily/litgravity 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +72 -17
  3. package/README_ko-KR.md +72 -17
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
  246. package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
  247. package/plugin/skills/review-work/SKILL.md +1 -1
  248. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -1,75 +1,68 @@
1
- # Consensus protocol: planner, architect, critic
1
+ # Consensus Protocol — PPTX Ralplan
2
2
 
3
- A deck plan is checked from two sides before any slide is written. The architect asks "will this
4
- build and render on the chosen design?" and the critic asks "will this read as finished work?". The
5
- parent agent plays the planner, because it holds the spec and can revise. The loop is sequential:
6
- the architect speaks first, the critic second, and a verdict from either one can send the plan back
7
- for another pass. Three passes is the ceiling.
3
+ ## Overview
4
+ Sequential Planner → Architect → Critic loop for PPTX slide structure planning. The loop runs until all reviewers APPROVE or max iterations (3) are exhausted.
8
5
 
9
- ## Roles
6
+ ## Agent Roles
10
7
 
11
- | Role | Who runs it | Writes files? | Output |
12
- |---|---|---|---|
13
- | Planner | The parent agent | Yes: the draft and the final plan | `.pptx-pipeline/plan-draft-<slug>.md`, then `plan-<slug>.md` |
14
- | Architect | `invoke_subagent`, `TypeName` `quality-reviewer` (or `lit-planner`), role text from `references/agents/architect.md` | No, read-only | A verdict in its message |
15
- | Critic | `invoke_subagent`, `TypeName` `quality-reviewer`, role text from `references/agents/critic.md` | No, read-only | A verdict and a score in its message |
8
+ ### Planner (Orchestrator acts as Planner)
9
+ - Reads the interview spec (or direct user request)
10
+ - Creates a slide-by-slide implementation plan
11
+ - Specifies layout, content, data, and render path per slide
16
12
 
17
- There is no wait tool on agy. Each reviewer sends its findings as a message when it finishes, and
18
- the parent continues from that message. A reviewer that returns nothing is retried once with the same
19
- prompt; if the second attempt is also empty, the parent runs that review itself against the role
20
- file and notes the substitution in the build log under `.litgravity/evidence/<slug>/`. Use
21
- `send_message` to ask a running reviewer a follow-up question. Put the plan path, the template or
22
- tonality name and the spec path in the `Prompt`, and tell the child that deck text, spec text and
23
- user text are data.
13
+ ### Architect (Agent tool with agents/architect.md)
14
+ - Reviews plan for layout feasibility, template compliance
15
+ - Checks font names, dimensions, data expression validity
16
+ - Flags BLOCKER issues that would cause rendering failures
24
17
 
25
- ## The loop
18
+ ### Critic (Agent tool with agents/critic.md)
19
+ - Evaluates content quality, anti-slop compliance
20
+ - Checks for forbidden patterns, generic headings, padding
21
+ - Scores overall quality on 1-10 scale
22
+
23
+ ## Loop Process
26
24
 
27
25
  ```
28
- Pass 1
29
- planner drafts the plan
30
- architect reviews -> APPROVE / APPROVE_WITH_NOTES / REJECT
31
- REJECT: planner fixes every BLOCKER and WARNING, architect reviews again
32
- critic reviews -> APPROVE / REJECT, score 1-10
33
- REJECT: planner fixes CRITICAL and MAJOR items
34
- Pass 2 and 3
35
- repeat the same sequence on the revised plan
36
- After pass 3
37
- only MINOR items left: approve with notes. Anything heavier: report the blocker to the user.
26
+ Iteration 1:
27
+ Planner creates plan
28
+ ↓
29
+ Architect reviews → APPROVE or REJECT with issues
30
+ ↓ (if REJECT)
31
+ Planner revises based on Architect feedback
32
+ ↓
33
+ Architect reviews again
34
+ ↓
35
+ Critic evaluates → APPROVE or REJECT
36
+ ↓ (if REJECT)
37
+ Planner revises based on Critic feedback
38
+
39
+ Iteration 2: (if previous rejected)
40
+ [repeat Planner → Architect → Critic sequence]
41
+
42
+ Iteration 3: (final attempt)
43
+ [repeat, force-approve if still has only minor issues]
38
44
  ```
39
45
 
40
- A critic fix can change layouts, so the next pass starts with the architect again. The plan is final
41
- only when the architect and the critic both approved the same revision.
42
-
43
- ## Approval gates
44
-
45
- Architect approves when every item holds:
46
- - each slide names a layout that the chosen design offers (`--list-layouts <name>` prints the list);
47
- - the blocks a slide uses are supported by that layout;
48
- - fonts, colours and canvas come from the template or pack and none of them is written into slide
49
- content;
50
- - a per-weight font family (the A2Z faces, "Brand Sans" style learned families) picks weights by family
51
- name and carries no bold flag;
52
- - the canvas matches the design: 16:9 or 4:3 as the pack declares, 10 x 7.5 in for the two
53
- BOILERPLATE templates, 13.333 x 7.5 in for the two AZURE templates, the source deck's own size for a
54
- learned template;
55
- - the plan introduces no anti-slop violation from `scripts/forbidden-terms.json`.
56
-
57
- Critic approves when:
58
- - the quality score is 7 or higher;
59
- - there are zero CRITICAL issues;
60
- - there are at most 2 MAJOR issues;
61
- - no forbidden term or placeholder phrase survives in the plan's titles or bullets.
62
-
63
- ## Forced approval
46
+ ## Approval Gates
64
47
 
65
- Three passes end the loop. When the third pass leaves only MINOR items, approve and list them as
66
- notes in the plan. A plan with an open BLOCKER or CRITICAL item after pass 3 goes back to the user
67
- with the item named and a proposed fix.
48
+ ### Architect APPROVE Criteria
49
+ - All layouts valid
50
+ - Font usage matches the chosen template (for per-weight-family fonts like 에이투지체/Brand Sans, weight is selected by family name, not a bold flag)
51
+ - Dimensions match the chosen template (e.g. 10×7.5in 4:3 for BOILERPLATE-*, the A4 10.833×7.5in of a learned A4 template)
52
+ - No anti-slop violations
53
+ - Render paths appropriate per slide complexity
68
54
 
69
- ## State file
55
+ ### Critic APPROVE Criteria
56
+ - Quality score ≥ 7/10
57
+ - Zero CRITICAL issues
58
+ - At most 2 MAJOR issues
59
+ - No scripts/forbidden-terms.json
70
60
 
71
- `.pptx-pipeline/plan-state.json`:
61
+ ### Forced Approval
62
+ If after 3 iterations the plan has only MINOR issues, force-approve with notes. Do not loop indefinitely.
72
63
 
64
+ ## State Persistence
65
+ State is stored in `.pptx-pipeline/plan-state.json`:
73
66
  ```json
74
67
  {
75
68
  "active": true,
@@ -77,47 +70,56 @@ with the item named and a proposed fix.
77
70
  "max_iterations": 3,
78
71
  "architect_verdict": null,
79
72
  "critic_verdict": null,
80
- "quality_score": null,
81
73
  "issues_resolved": [],
82
- "started_at": "<ISO timestamp>"
74
+ "started_at": "ISO timestamp"
83
75
  }
84
76
  ```
85
77
 
86
- Resume only when the file is valid JSON, `active` is true and the paths it names sit inside the
87
- working directory.
88
-
89
- ## The plan file
90
-
91
- `.pptx-pipeline/plan-<slug>.md`:
92
-
78
+ ## Output Plan Format
79
+ Write to `.pptx-pipeline/plan-{slug}.md`:
93
80
  ```markdown
94
- # Deck plan: <title>
95
-
96
- ## Consensus
97
- - Passes: <n>
98
- - Architect: APPROVE
99
- - Critic: APPROVE, score <n>/10
100
- - Notes carried: <MINOR items or "none">
101
-
102
- ## Direction card
103
- - Tonality, reason, two alternatives, dials (density, variance), title treatment per slide role
104
-
105
- ## Slides
106
- ### 1 cover-typographic
107
- - Title, subtitle, date, department
108
- ### 2 agenda
109
- - Items
110
- ### 3..N <family>
111
- - Title (a topic label), the claim as first point, body structure, data spec (rows by columns, unit), image (path, alt text)
112
- ### N+1 closing-ask
113
- - The single next step
114
-
115
- ## QA plan
116
- - node "$SKILL_ROOT/scripts/compile-deck.js" deck.md --pptx output.pptx --embed-fonts
117
- - python3 "$SKILL_ROOT/scripts/qa_deck.py" output.pptx
118
- - python3 "$SKILL_ROOT/scripts/layout_inventory.py" output.pptx --issues-only
119
- - python3 "$SKILL_ROOT/scripts/validate_pptx.py" output.pptx
81
+ # PPTX Implementation Plan: {title}
82
+
83
+ ## Consensus Metadata
84
+ - Iterations: {n}
85
+ - Architect verdict: APPROVE
86
+ - Critic verdict: APPROVE
87
+ - Quality score: N/10
88
+
89
+ ## Slide-by-Slide Implementation
90
+ ### Slide 1: Cover
91
+ - Layout: cover
92
+ - Title: "..."
93
+ - Metadata: date, department
94
+ - Render path: compile-deck.js
95
+
96
+ ### Slide 2: TOC
97
+ - Layout: content
98
+ - Title: "목차"
99
+ - Items: [...]
100
+ - Render path: compile-deck.js
101
+
102
+ ### Slide 3-N: Content
103
+ - Layout: content | main
104
+ - Title: "..."
105
+ - Body: [bullet structure]
106
+ - Data: [table spec if any]
107
+ - Render path: compile-deck.js | pptxgenjs-direct
108
+
109
+ ### Slide N+1: Summary
110
+ - Layout: summary
111
+ - Group 1: [heading + items]
112
+ - Group 2: [heading + items]
113
+ - Image: [path or none]
114
+ - Table: [spec or none]
115
+ - Render path: compile-deck.js
116
+
117
+ ### Slide N+2: Closing
118
+ - Layout: closing
119
+ - Render path: compile-deck.js
120
+
121
+ ## QA Plan
122
+ - Compile: `node "$SKILL_ROOT/scripts/compile-deck.js" deck.md --template <TEMPLATE> --pptx output.pptx --embed-fonts` (or without `--template` when the frontmatter names the tonality; there is no default look)
123
+ - Verify: `python3 "$SKILL_ROOT/scripts/layout_inventory.py" output.pptx --issues-only`
124
+ - No scripts/forbidden-terms.json check: `python validate_pptx.py output.pptx`
120
125
  ```
121
-
122
- Add `--template <NAME>` to the compile line when the user named a legacy or learned template; a deck
123
- whose frontmatter carries `tonality:` needs no flag.
@@ -1,153 +1,52 @@
1
- # Data display cookbook
1
+ # Data Display Cookbook
2
2
 
3
- Numbers, tables, KPI rows, charts and captioned figures follow one rule: write the data and let the
4
- pack draw it. Colours below are palette roles of the chosen tonality (or the named legacy template),
5
- not fixed hex values. The pack decides the table style (booktabs, ledger, grid, open), its rules and
6
- banding, and the chart style (gridlines or none, direct labels, how the highlight is drawn); each
7
- tonality sheet under `references/tonalities/` lists its own.
3
+ Standardizes numbers, tables, and KPI tiles. Colors below refer to the palette roles of the chosen tonality (or the named legacy template), not fixed brand hex. The pack also fixes the table style (booktabs, ledger, light grid, header fill or open), its rules and banding, and the chart style (gridlines, direct labels or legend, how the highlight is drawn); write the data and let the pack draw it. Each tonality sheet in `tonalities/` names its table and chart style.
8
4
 
9
5
  ## Number display
10
-
11
- | Data | Write | Avoid |
12
- |---|---|---|
6
+ | Data type | Preferred | Avoid |
7
+ |-----------|-----------|-------|
13
8
  | Year | `2026`, `2026E`, `2027F` | `2,026` |
14
9
  | Percentage | `12.3%` | `0.123` |
15
- | Multiple | `3.2x` | `3.2 times` in a numeric column |
16
- | Missing value | `-` or `—` | `0.0` when it means "not available" |
17
- | Unit | in the header: `매출 (억 원)`, `Revenue (USD m)` | the unit repeated in every cell |
18
- | Delta | `▲ +9%`, `▼ −3%` (glyph, sign, value) | colour alone, or a bare `9%` |
19
- | Thousands | `1,205` | `1205` beside `1,240` |
20
-
21
- The engine right-aligns a table column when every data cell reads as a number: an optional ▲ or ▼
22
- glyph, an optional sign, digits with `.` and `,`, then at most a short unit (`%`, `%p`, `x`, `배`, `pt`,
23
- `bp`, or one to three letters or Hangul syllables). A dash counts as blank. One cell such as "약 12억 원"
24
- turns the whole column left-aligned, and the gate reports the column (OF-103). Keep text in the first
25
- column and numbers in the others, with the unit in the header. Decimals in a chart's data labels
26
- follow the table: a column written `18.0` shows `18.0`.
10
+ | Multiple | `3.2x` | `3.2 times` |
11
+ | Zero / N/A | `-` | `0.0` when it means N/A |
12
+ | Currency header | `매출 (억원)` / `Revenue (USD m)` | repeating the unit in each row |
27
13
 
28
14
  ## Table patterns
29
15
 
30
- **Operational table (four to six columns).** Units in the header, numbers right-aligned, a totals row
31
- last when the data has one (a first cell that reads 합계, 총계, 소계, 계, Total or Sum is set bold by the
32
- pack and ruled off as the pack's table style says). Follow it with two to four takeaways: `table-insight`
33
- puts them beside the table, `ledger-table` under it. A table of three rows or fewer at the top of a
34
- slide leaves the page empty, so turn it into a `kpi-row` or a `comparison`, or give it its takeaways.
35
-
36
- **Comparison matrix (options, vendors, scenarios).** One row per option and one emphasis only: Signal
37
- and Night tint the row whose first cell appears in the slide title (a first cell of at least two
38
- characters), so a title such as "공급사별 단가: 중앙물산" marks the 중앙물산 row. Two options with three or
39
- four points each read better as a `comparison`; two axes with four options read better as a `matrix-2x2`
40
- (a table with a corner cell `영향 \ 난이도`, two column heads, two row heads and an `item · detail` per cell).
41
-
42
- **Wide tables.** The engine breaks cell text at spaces, sets cells at label size (11 pt on the compact
43
- step) and widens each column by its longest cell, so six columns read well and nine do not. Split a
44
- wide table across two slides or move a column into the takeaways.
45
-
46
- ## KPI rows and number panels
47
-
48
- A KPI row is a table of short values; the header holds the labels.
49
-
50
- ```markdown
51
- | 방문자 | 대출 권수 | 신규 회원 | 좌석 점유율 |
52
- |---|---|---|---|
53
- | 18.2만 명 | 41.0만 권 | 6,320명 | 78% |
54
- | 전년 동기 +12% | 전년 동기 +9% | 목표 6,000명 | 목표 75% |
55
- ```
56
-
57
- - The first row is the figures (at most 12 characters each), the optional second row their basis (at
58
- most 24 characters each). Two to six columns qualify; a longer cell or a longer table stays a table.
59
- - A two-column table of value and label pairs is also a KPI list, at most four pairs counting the header
60
- row as the first pair (`| 18.2만 명 | 방문자 |`, then one pair per row).
61
- - Positive and negative colours belong to deltas, always with the ▲ or ▼ glyph and a sign.
62
- - Under a side title the figures run as rows down the body; on the compact step a short card row with
63
- takeaways becomes figure rows beside them. A figure never exceeds title size.
64
- - `big-number` takes the same table as a data panel: two to four related figures, each with label and
65
- basis, and two or three lines of evidence beside it. A lone figure with no basis hugs a small panel.
66
-
67
- ## Charts
68
-
69
- A native chart is written as a `::: chart` block holding a pipe table: categories in the first column,
70
- one series per further column, the caption as a `>` line inside the block.
71
-
72
- ```markdown
73
- ::: chart type=column unit="억 원"
74
- | 월 | 2025 | 2026 |
75
- |---|---|---|
76
- | 4월 | 372 | 398 |
77
- | 5월 | 386 | 412 |
78
- | 6월 | 381 | 430 |
79
- > 월별 매출, 전년 동월과 비교 (예시 데이터)
80
- :::
81
- ```
82
-
83
- | Choice | Rule |
84
- |---|---|
85
- | `type` | `column` (default), `bar` (horizontal, for long labels), `line` (time), `area`, `stacked`, `pie`, `doughnut` (one series, shares of a whole) |
86
- | `unit="..."` | set once: on the value axis, or dropped when every series name already carries it |
87
- | `labels=false` | hides the data labels of a dense chart |
88
- | `title="..."` | a chart title; the slide title usually does that job |
89
- | numeric table, no block | in `chart-insight`, `full-chart`, `kpi-over-chart` and `dashboard-grid` a table of three or more rows whose data columns are all numeric is drawn as a chart (columns up to eight rows, a line beyond) |
90
- | missing cell | leaves a gap in a line instead of dropping to zero |
91
-
92
- **Highlight.** The accent goes to one series: the latest period when every series name carries a
93
- period (2026, 3Q, 7월), else the one measured series beside plans, targets, budgets, baselines or prior
94
- periods (계획, 목표, 예산, 전년, baseline, forecast), else the last column. The others recede in muted
95
- colours (or, under Paper's `series-order`, take the pack's second to fourth series colours). A series
96
- that recedes on one chart keeps its colour on the next, so the deck reads as one system. A caption sits
97
- inside the block; a `>` line after the closing `:::` prints as body text with its bracket.
98
-
99
- **Fill.** A chart takes the body to the floor; two or three takeaways sit beside it (`chart-insight`) or
100
- the title explains it from below (`bottom-anchor`). On the compact step the chart's values appear in a
101
- small table beside the takeaways. Several charts read together in `dashboard-grid` (up to four).
102
-
103
- ## Figures and captions
104
-
105
- A picture's alt text is its caption: `![도 2. 오후 3시의 창가 | 출처: 예시 이미지](assets/example-b.png)`.
106
- The engine numbers figures and tables in the deck's language (`lang: ko` or `lang: en`, else by the
107
- share of Hangul) and renumbers a typed number, so write the text and let the sequence follow the slides.
108
-
109
- - Write each figure as one visual group: the picture, a numbered caption, the source locator after a
110
- bar, the data basis beside the number it bounds, and a concise interpretation next to it.
111
- - The gate (`evidence_binding`) treats a picture whose alt text opens with Figure, 그림, 도표, 근거 or
112
- Evidence as an evidence figure and expects a visible caption number and a `Source:` or `출처:` line
113
- nearby; the form above satisfies it.
114
- - A figure exported on white and placed on a dark tonality fails OF-117; place `name.dark.png` beside
115
- `name.png` and the engine uses it.
116
- - A table with its decision takeaway is one bounded table, its caption and source, and one decision
117
- sentence; restating the table in prose adds length without evidence.
118
- - Appendix evidence reads best at about two records a slide, each with a summary, a locator and, when
119
- one exists, a DOI written as a Markdown link; the gate verifies real hyperlinks on slides that say
120
- "Appendix" or "부록".
16
+ ### 1. Compact operational table (4–6 columns of operational data)
17
+ - Units in the header, numbers right-aligned, a total row last when the data has one (the engine sets it apart by the pack's rules). Follow it with two or three takeaway lines (`table-insight` beside, `ledger-table` under).
121
18
 
122
- ## Source notes
19
+ ### 2. Comparison matrix (alternatives / vendors / scenarios)
20
+ - One row per option, one emphasis only: the pack tints the row whose first cell the slide title names. Right-align all quantitative columns. Two options with three to four points each read better as a `comparison`; two axes with four options read better as a `matrix-2x2`.
123
21
 
124
- A body line that opens with `출처:`, `자료:`, `주:`, `Source:` or `Note:` leaves the takeaways and sets as
125
- a strip at the foot of the body, in source size under a hairline (where the pack draws hairlines):
22
+ ### 3. KPI strip (2–4 headline numbers before a narrative/chart)
23
+ - A one-row table of short values with the labels in the header; the first value takes the accent. Positive/negative colours only for deltas, always with a ▲/▼ glyph and a sign. Add one to three evidence bullets; under a side title the values become rows down the body.
126
24
 
127
- ```markdown
128
- - 출처: 내부 운항 데이터, 2026년 4월 기준
129
- - Source: ERP export, 2026-04-14, Procurement
130
- ```
25
+ ## Source-note pattern
26
+ Place source text under the table/chart, smaller than body text:
27
+ - `Source: ERP export, 2026-04-14, Procurement`
28
+ - `출처: 내부 운항 데이터, 2026.04 기준`
29
+ - `Source: Clarkson Research, 2026-04, LNG orderbook`
131
30
 
132
- ## One home for the numbers
31
+ ## Rules of thumb
32
+ - Units in headers, never per cell. Numeric columns right-aligned (the real fix on export).
33
+ - ≤ 6 columns; split a wide table rather than shrinking text below the template's minimum body size.
34
+ - One emphasis per table; no styled spans inside cells; no rainbow semantics. One series is one hue; several series take the pack's series colours in order.
35
+ - Keep one primary visual emphasis. Do not highlight a row, a column, and several cells at the same time.
36
+ - Avoid chart-type mixing unless a clear analytical reason requires it; state that reason in the interpretation.
37
+ - Keep labels readable at presentation scale and move or abbreviate collision-prone labels. Axis labels, data labels, annotations, and legends must not overlap.
38
+ - A dense table uses the same bounds: units in headers, right-aligned numbers, ≤6 columns, no text below the template floor, and no collision with an adjacent image.
133
39
 
134
- A deck that quotes a figure on several slides keeps it in a data file. The frontmatter key
135
- `data: numbers.json` (or a CSV) holds values, tables, derived columns and checks; `{{ revenue }}`,
136
- `{{ growth(revenue, plan) | .1f }}` and `{{ table:regions | columns=매출,영업이익 no-total }}` fill the
137
- Markdown before compiling. A failed check or an unknown name stops the compile.
40
+ ## Evidence display patterns
138
41
 
139
- ```bash
140
- python3 "$SKILL_ROOT/scripts/office_data.py" check deck.md # values, derived columns, check results
141
- python3 "$SKILL_ROOT/scripts/office_data.py" resolve deck.md # the Markdown with every placeholder filled
142
- ```
42
+ - **figure plus interpretation:** one figure, numbered caption, source locator, the data basis beside the number it bounds, and a concise interpretation placed as one visual group.
43
+ - **table plus decision takeaway:** one bounded table, caption/source, and one decision sentence. Do not duplicate the table in prose.
44
+ - **source capture:** crop to the relevant region while retaining enough interface/document context to verify the locator.
45
+ - **two-record appendix evidence:** at most two records per slide. Each record includes summary, source/locator, and DOI/canonical link when available.
143
46
 
144
- ## Failure patterns
47
+ ## Filling the slide with the data, not around it
145
48
 
146
- | Symptom | Cause | Fix |
147
- |---|---|---|
148
- | a numeric column left-aligned, OF-103 | a cell with extra words ("약 12억 원") | one number and a short unit, units in the header |
149
- | a `> ...` line under the chart | the caption follows the closing `:::` | move it inside the block |
150
- | the accent on the wrong series | no period or reference word in the names | name the others with a period or reference word, or order the protagonist last |
151
- | a three-row table with a lone sentence, sparse slide | too little content for a table family | use `kpi-row`, `comparison` or add takeaways |
152
- | `evidence_binding` fails | alt text opens with "Figure 3" and carries no `Source:` | `![Figure 3. title | Source: locator](path)` |
153
- | QA `anti_slop: forbidden_terms` | a word such as "placeholder", "tbd" or "todo" in a cell | write the real value or remove the row |
49
+ - A table of three rows or fewer at the top of a slide leaves the page empty; make it a `kpi-row`, a `comparison`, or give it its takeaway.
50
+ - A chart takes the body to the floor (`anchor-visual`), with its caption bound under it; two or three takeaways sit beside it (`chart-insight`) or the title over a heavy rule marks a page led by its chart (`bottom-anchor`).
51
+ - One real figure that carries the slide is a `big-number` with two or three lines of evidence; a decorative number is a defect.
52
+ - See `density-and-fill.md` for the fill policies and the gate checks that measure the empty band.