@litfamily/litgravity 0.1.1 → 0.1.3
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.
- package/CHANGELOG.md +46 -0
- package/README.md +19 -3
- package/README_ko-KR.md +19 -3
- package/TRADEMARK.md +12 -0
- package/package.json +3 -2
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/liveness.mjs +81 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +364 -0
- package/plugin/hooks/lib/rewind/collect.mjs +359 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +39 -1
- package/plugin/hooks/pre-invocation.mjs +93 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +55 -6
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +277 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +160 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +3 -2
- package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
- package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
- package/plugin/skills/lit-plan/templates/plan.md +3 -0
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/review-work/SKILL.md +1 -1
- package/plugin/skills/start-work/SKILL.md +2 -2
|
@@ -1,75 +1,68 @@
|
|
|
1
|
-
# Consensus
|
|
1
|
+
# Consensus Protocol — PPTX Ralplan
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
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
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
|
|
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
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
-
|
|
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
|
-
|
|
66
|
-
|
|
67
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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": "
|
|
74
|
+
"started_at": "ISO timestamp"
|
|
83
75
|
}
|
|
84
76
|
```
|
|
85
77
|
|
|
86
|
-
|
|
87
|
-
|
|
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
|
-
#
|
|
95
|
-
|
|
96
|
-
## Consensus
|
|
97
|
-
-
|
|
98
|
-
- Architect: APPROVE
|
|
99
|
-
- Critic: APPROVE
|
|
100
|
-
-
|
|
101
|
-
|
|
102
|
-
##
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
- Title
|
|
112
|
-
|
|
113
|
-
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
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
|
|
1
|
+
# Data Display Cookbook
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
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`
|
|
16
|
-
|
|
|
17
|
-
|
|
|
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
|
-
|
|
31
|
-
last when the data has one (
|
|
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: ``.
|
|
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
|
-
|
|
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
|
-
|
|
125
|
-
|
|
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
|
-
|
|
128
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
140
|
-
|
|
141
|
-
|
|
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
|
-
##
|
|
47
|
+
## Filling the slide with the data, not around it
|
|
145
48
|
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
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:` | `` |
|
|
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.
|