konoha-mcp 2.1.13 → 2.1.14

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 (52) hide show
  1. package/.agents/skills/konoha/SKILL.md +16 -3
  2. package/.agents/skills/tokubetsu-jonin-skill/SKILL.md +48 -23
  3. package/.agents/skills/tokubetsu-jonin-skill/references/docx.md +25 -4
  4. package/.agents/skills/tokubetsu-jonin-skill/references/elite-powerpoint-designer.md +48 -23
  5. package/.agents/skills/tokubetsu-jonin-skill/references/pdf.md +78 -46
  6. package/.agents/skills/tokubetsu-jonin-skill/references/pptx.md +25 -3
  7. package/.agents/skills/tokubetsu-jonin-skill/references/xlsx.md +60 -33
  8. package/.agents/skills/tokubetsu-jonin-skill/references/zero-ai-human-writing.md +34 -11
  9. package/.agents/skills.fingerprint +1 -1
  10. package/README.md +18 -6
  11. package/apps/web/build/adapter-node.js +1 -1
  12. package/apps/web/build/client/_app/version.json +1 -1
  13. package/apps/web/build/client/_app/version.json.br +0 -0
  14. package/apps/web/build/client/_app/version.json.gz +0 -0
  15. package/apps/web/build/server/chunks/instance.js +3 -3
  16. package/apps/web/build/server/chunks/internal.js +1 -1
  17. package/apps/web/package.json +1 -1
  18. package/bin/cli.js +3 -3
  19. package/docs/ALL-WORKFLOW-DIAGRAMS.md +642 -0
  20. package/docs/ARCHITECTURE.md +11 -7
  21. package/docs/SETUP-CLI.md +1 -1
  22. package/docs/SecurityCompliance/security_compliance_report_google_policy_2.1.13_2026-10-07.md +10 -0
  23. package/docs/SecurityCompliance/security_compliance_report_google_policy_2.1.14_2026-10-08.md +88 -0
  24. package/docs/diagrams/README.md +1 -1
  25. package/package.json +3 -2
  26. package/src/agent_manager.js +20 -4
  27. package/src/canonical_skills.js +1 -1
  28. package/src/file_tools_router.js +3 -1
  29. package/src/mcp/anti_slop.js +281 -0
  30. package/src/mcp/memory_reporting.js +21 -0
  31. package/src/mcp/skills.js +274 -0
  32. package/src/mcp/tool_dispatch.js +14 -1
  33. package/src/mcp/workflow.js +1 -1
  34. package/src/mcp_tool_manifest.json +59 -0
  35. package/src/templates/agents.yaml +21 -0
  36. package/src/templates/skills/konoha/SKILL.md +16 -3
  37. package/src/templates/skills/tokubetsu-jonin-skill/SKILL.md +48 -23
  38. package/src/templates/skills/tokubetsu-jonin-skill/references/docx.md +25 -4
  39. package/src/templates/skills/tokubetsu-jonin-skill/references/elite-powerpoint-designer.md +48 -23
  40. package/src/templates/skills/tokubetsu-jonin-skill/references/pdf.md +78 -46
  41. package/src/templates/skills/tokubetsu-jonin-skill/references/pptx.md +25 -3
  42. package/src/templates/skills/tokubetsu-jonin-skill/references/xlsx.md +60 -33
  43. package/src/templates/skills/tokubetsu-jonin-skill/references/zero-ai-human-writing.md +34 -11
  44. package/.agents/skills/helm-chart-scaffolding/SKILL.md +0 -71
  45. package/.agents/skills/helm-chart-scaffolding/assets/Chart.yaml.template +0 -42
  46. package/.agents/skills/helm-chart-scaffolding/assets/values.yaml.template +0 -185
  47. package/.agents/skills/helm-chart-scaffolding/references/chart-structure.md +0 -509
  48. package/.agents/skills/helm-chart-scaffolding/references/details.md +0 -497
  49. package/.agents/skills/helm-chart-scaffolding/scripts/validate-chart.sh +0 -244
  50. package/src/templates/skills/helm-chart-scaffolding/SKILL.md +0 -71
  51. package/src/templates/skills/helm-chart-scaffolding/references/chart-structure.md +0 -509
  52. package/src/templates/skills/helm-chart-scaffolding/references/details.md +0 -497
@@ -19,11 +19,32 @@ Use this reference whenever generating, editing, or styling Microsoft Word docum
19
19
 
20
20
  ## 1. Zero-AI Human Writing Invariants for Word Documents
21
21
 
22
- - **Strict Light Mode Invariant (Zero Dark Theme Style)**: Under NO circumstances create, generate, or style Word documents with dark theme style. Dark covers, dark pages, dark headers, dark footers, and black or near-black background fills are STRICTLY PROHIBITED. All document backgrounds must be pure white (`#FFFFFF`) or subtle pearl white (`#F8FAFC`) for executive readability.
23
- - **3-Color Minimum Gradient for Covers, Headers, & Footers**: When color or visual distinction is needed for cover pages, header bands, footer accents, or hero dividers, ALWAYS create a smooth multi-stop gradient with a MINIMUM of 3 colors (e.g. Crisp Executive Sapphire `#1E3A8A` → `#2563EB` → `#60A5FA`, Emerald Wealth `#065F46` → `#0D9488` → `#38BDF8`, or Dawn Coral `#9A3412` → `#EA580C` → `#FDBA74`). Never use a dark gradient or single flat dark blocks.
24
- - **Business & Enterprise Class Polish**: Typography must use modern corporate fonts (Aptos, Calibri, Arial, Georgia) with clean point sizing, 1.15 line spacing, generous cell padding (minimum 120 DXA), subtle light borders (`#CBD5E1`), and soft zebra stripes (`#F8FAFC`).
25
- - **Strict Zero Watermark Invariant**: Under NO circumstances should generated, styled, or edited Word documents contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent image overlays, or evaluation markings. All pages must feature clean, unblemished white canvases.
22
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances create, generate, or style Word documents with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All document backgrounds must be pure white (`#FFFFFF`) or pearl (`#F8FAFC`), with text strictly in **medium slate `#64748B`**.
23
+ - **20 Canonical 4-Base-Color Themes**: When decorative color is applied to cover ribbons, header bands, or footer lines, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per document and keeping it consistent throughout:
24
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
25
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
26
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
27
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
28
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
29
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
30
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
31
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
32
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
33
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
34
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
35
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
36
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
37
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
38
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
39
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
40
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
41
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
42
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
43
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
44
+ - **Strict Typography Contract**: Word/reports strictly use **Georgia (headings) + Calibri (body)** with clean point sizing, 1.15 line spacing, generous cell padding (minimum 120 DXA), subtle light borders (`#E2E8F0`), and soft zebra stripes (`#F8FAFC`).
45
+ - **Strict Zero Watermark Invariant**: Under NO circumstances should generated Word documents contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent image overlays, or evaluation markings.
26
46
  - **Metadata Scrubbing**: Always set document core properties (`creator`, `lastModifiedBy`) to the project or author name; remove default library tags (`python-docx`, `docx-js`).
47
+ - **Mandatory Kage Review Gate**: Every generated DOCX document must undergo Kage review before completion.
27
48
 
28
49
  ---
29
50
 
@@ -16,17 +16,40 @@ Transform content into world-class presentations with the design quality of Appl
16
16
  ## Core Design Philosophy & Business-Class Invariants
17
17
 
18
18
  > [!IMPORTANT]
19
- > **Strict Light Mode Invariant (Zero Dark Theme)**: Under no circumstances should presentations be designed with dark backgrounds, black slides, or dark navy full-bleed covers. All presentations must use pure white (`#FFFFFF`) or soft pearl (`#F8FAFC` / `#FAFAFA`) canvases.
20
- > **3-Color Minimum Gradient Invariant**: When decorative accents, header/footer bands, title dividers, or KPI highlights are applied, strictly use a smooth gradient with a **minimum of 3 colors** (e.g., Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` or Teal `#0D9488` → Cyan `#06B6D4` → Mint `#6EE7B7`).
19
+ > **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances should presentations be designed with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All slide canvases must be pure white (`#FFFFFF`) or soft pearl (`#F8FAFC` / `#FAFAFA`), with text strictly in **medium slate `#64748B`**.
20
+ > **20 Canonical 4-Base-Color Themes**: When decorative accents, header/footer bands, title dividers, or KPI highlights are applied, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per presentation deck and keeping it consistent throughout:
21
+ > - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
22
+ > - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
23
+ > - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
24
+ > - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
25
+ > - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
26
+ > - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
27
+ > - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
28
+ > - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
29
+ > - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
30
+ > - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
31
+ > - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
32
+ > - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
33
+ > - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
34
+ > - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
35
+ > - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
36
+ > - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
37
+ > - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
38
+ > - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
39
+ > - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
40
+ > - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
41
+ > **Strict Typography Contract**: PowerPoint presentations strictly use **Segoe UI Semibold or Georgia (headings) + Segoe UI or Calibri (body)** with text in medium slate `#64748B`.
42
+ > **Mandatory Kage Review Gate**: Always use Kage review on every generated PowerPoint presentation.
21
43
 
22
44
  **Principles:**
23
45
  1. **Pure Light Mode Canvas** - Clean white backgrounds with executive crisp contrast.
24
- 2. **3-Color Gradient Accents** - Sophisticated, multi-stop accents; zero monotone dark blocks.
25
- 3. **Minimalism First** - Remove everything that doesn't serve a clear purpose.
26
- 4. **Bold & Clear** - Large typography, high contrast, confident colors.
27
- 5. **Visual Hierarchy** - Guide attention through size, color, and spacing.
28
- 6. **Consistent Branding** - Every element follows the design system.
29
- 7. **Purposeful Motion** - Animations only where they add clarity or emphasis.
46
+ 2. **4-Base-Color Theme Gradient Accents** - Sophisticated, multi-stop accents matching T01–T20; zero monotone dark blocks.
47
+ 3. **Medium Slate `#64748B` Typography** - High-legibility, zero dark gray or black text.
48
+ 4. **Minimalism First** - Remove everything that doesn't serve a clear purpose.
49
+ 5. **Bold & Clear** - Large typography, high contrast, confident colors.
50
+ 6. **Visual Hierarchy** - Guide attention through size, color, and spacing.
51
+ 7. **Consistent Branding** - Every element follows the chosen theme consistently.
52
+ 8. **Purposeful Motion** - Animations only where they add clarity or emphasis.
30
53
 
31
54
  ## When to Use This Skill
32
55
 
@@ -41,37 +64,39 @@ Transform content into world-class presentations with the design quality of Appl
41
64
 
42
65
  ### Available Brand Styles
43
66
 
67
+ All presentation styles strictly enforce **Pure Light Mode**, text in **medium slate `#64748B`**, and smooth **4-base-color gradient ribbons** from one of the 20 canonical themes (T01–T20):
68
+
44
69
  **1. Tech Keynote (Executive Light Edition)**
45
- - **Colors**: Pure white background (#FFFFFF), slate text (#0F172A), 3-color gradient accent bar (#1E3A8A → #2563EB → #60A5FA)
46
- - **Typography**: SF Pro Display (title 72-96pt), SF Pro Text (body 32-44pt)
70
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient accent bar (T01–T20)
71
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Segoe UI (body 24-32pt)
47
72
  - **Layout**: Extreme whitespace, single focal point per slide
48
73
  - **Transitions**: Push, Fade (duration: 0.6s)
49
74
  - **Style**: Minimalist, premium, product-focused light mode
50
75
 
51
- **2. Corporate Professional (Microsoft/IBM Style)**
52
- - **Colors**: Pure white background (#FFFFFF), deep slate (#0F172A), 3-color gradient ribbon (#003366 → #0078D4 → #60A5FA), warm gray cards (#F8FAFC)
53
- - **Typography**: Segoe UI (title 54-72pt), body (24-32pt)
76
+ **2. Corporate Professional (Enterprise Executive Edition)**
77
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient ribbon (T01–T20), soft pearl cards (#F8FAFC)
78
+ - **Typography**: Georgia (title 54-72pt), Calibri (body 24-32pt)
54
79
  - **Layout**: Balanced, grid-based, data-friendly
55
80
  - **Transitions**: Morph, Fade (duration: 0.8s)
56
81
  - **Style**: Trustworthy, data-driven, enterprise-ready light mode
57
82
 
58
- **3. Creative Bold (Google/Airbnb Style)**
59
- - **Colors**: Pure white canvas (#FFFFFF), 3-color gradient accents (#0D9488 → #06B6D4 → #6EE7B7)
60
- - **Typography**: Product Sans or Montserrat (title 64-84pt)
61
- - **Layout**: Dynamic, asymmetric, playful spacing
83
+ **3. Creative Bold (Design Innovation Edition)**
84
+ - **Colors**: Pure white canvas (#FFFFFF), medium slate text (#64748B), 4-base-color gradient accents (T01–T20)
85
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Calibri (body 24-32pt)
86
+ - **Layout**: Dynamic, asymmetric, generous spacing
62
87
  - **Transitions**: Zoom, Reveal (duration: 0.5s)
63
88
  - **Style**: Energetic, innovative, design-forward light mode
64
89
 
65
- **4. Financial Elite (Goldman Sachs/McKinsey Style)**
66
- - **Colors**: Pure white background (#FFFFFF), deep charcoal (#1E293B), 3-color bronze/amber gradient (#9A3412 → #F59E0B → #FDE68A)
67
- - **Typography**: Garamond or Georgia (serif, elegant)
90
+ **4. Financial Elite (Institutional Boardroom Edition)**
91
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient metrics ribbon (T01–T20)
92
+ - **Typography**: Georgia (title 54-72pt), Calibri (body 24-32pt)
68
93
  - **Layout**: Traditional hierarchy, centered, balanced
69
94
  - **Transitions**: Subtle Fade only (duration: 0.4s)
70
95
  - **Style**: Sophisticated, authoritative, premium light mode
71
96
 
72
- **5. Startup Pitch (Y Combinator/500 Startups Style)**
73
- - **Colors**: Pure white canvas (#FFFFFF), bold slate typography (#0F172A), 3-color gradient metric highlights
74
- - **Typography**: Inter or Roboto (modern sans-serif)
97
+ **5. Startup Pitch (Venture Showcase Edition)**
98
+ - **Colors**: Pure white canvas (#FFFFFF), medium slate typography (#64748B), 4-base-color gradient metric highlights (T01–T20)
99
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Segoe UI (body 24-32pt)
75
100
  - **Layout**: Problem-solution focused, metric-heavy
76
101
  - **Transitions**: Quick Push (duration: 0.3s)
77
102
  - **Style**: Energetic, data-driven, founder-friendly light mode
@@ -21,28 +21,52 @@ Use this reference whenever generating, styling, or auditing standalone PDF docu
21
21
  ## 1. Zero-AI Human Document Invariants
22
22
 
23
23
  When creating executive PDFs:
24
- - **Strict Light Mode Invariant (Zero Dark Style)**: PDFs must strictly use pure light mode. Never apply dark theme fills, dark covers, dark header blocks, or black/near-black backgrounds to any page. Page backgrounds must be pure white (`#FFFFFF`) or pearl (`#FAFAFA`).
25
- - **3-Color Minimum Gradient Invariant**: When decorative color is applied to headers, footers, cover accents, or callout ribbons, always use a smooth multi-stop gradient with a minimum of 3 colors (e.g., Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` or Teal `#0D9488` → Cyan `#06B6D4` → Mint `#6EE7B7`). Monotone dark bars or 2-color harsh transitions are strictly forbidden.
24
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances create, generate, or style PDF documents with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All document backgrounds must be pure white (`#FFFFFF`) or pearl (`#FAFAFA`), with text strictly in **medium slate `#64748B`**.
25
+ - **20 Canonical 4-Base-Color Themes**: When decorative color is applied to headers, footers, cover accents, or callout ribbons, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per document and keeping it consistent throughout:
26
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
27
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
28
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
29
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
30
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
31
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
32
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
33
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
34
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
35
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
36
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
37
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
38
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
39
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
40
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
41
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
42
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
43
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
44
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
45
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
26
46
  - **Dynamic Two-Pass Pagination**: Every multi-page PDF must include running headers/footers with dynamic page numbering in the exact format: `Page X of Y`. Hardcoded single numbers (`Page 1`) signal naive generation.
27
- - **Professional Font Pairing**: Body copy set in crisp, readable sans-serif (Helvetica, Inter, Arial, Calibri) at 10–10.5pt with 14–15pt leading. Headlines in bold, authoritative hierarchy (H1: 22–26pt, H2: 15–18pt, H3: 12–14pt).
28
- - **Executive Data Tables**: Table headers use light executive fills (`#F1F5F9` or `#E2E8F0`) with dark typography (`#0F172A`). Subtle grid borders (`#E2E8F0`). Alternating rows use pearl shading (`#F8FAFC`).
29
- - **Executive Callout Boxes**: Light tinted fill (`#F0F9FF` or `#F8FAFC`) with a 3-color gradient accent bar along the left edge.
47
+ - **Strict Typography Contract**: PDF/digital deliverables strictly use **Inter (headings and body)** (fallback: Helvetica/Arial). Body copy at 10–10.5pt with 14–15pt leading in medium slate `#64748B`. Headlines in bold, authoritative hierarchy (H1: 22–26pt, H2: 15–18pt, H3: 12–14pt) in medium slate `#64748B`.
48
+ - **Executive Data Tables**: Table headers use light executive fills (`#F1F5F9`) with `#64748B` typography. Subtle grid borders (`#CBD5E1` / `#E2E8F0`). Alternating rows use pearl shading (`#F8FAFC`).
49
+ - **Executive Callout Boxes**: Light tinted fill (`#F8FAFC`) with a 4-color gradient accent bar along the left edge.
30
50
  - **Strict Zero Watermark Invariant**: Under NO circumstances should generated, styled, or compiled PDFs include watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent overlay text, or evaluation markings. All pages must be crisp, unblemished, executive-class documents.
31
51
  - **Metadata Scrubbing**: Author, Title, and Subject fields must be sanitized to human executive attributes; automated generator tags (e.g. `ReportLab PDF Library`, `WeasyPrint`) must be purged.
52
+ - **Mandatory Kage Review Gate**: Every generated PDF document must undergo Kage review before completion.
32
53
 
33
54
  ---
34
55
 
35
56
  ## 2. Professional Color Palettes (Pure Light Mode)
36
57
 
37
- | Element | Executive Slate & Sapphire (Default) | Forest & Mint Finance | Modern Azure Tech |
38
- |---|---|---|---|
39
- | **Page Background** | Pure White `#FFFFFF` | Pure White `#FFFFFF` | Pure White `#FFFFFF` |
40
- | **Body Typography** | Deep Slate `#1E293B` | Deep Slate `#1E293B` | Charcoal `#334155` |
41
- | **Headings** | Midnight Slate `#0F172A` | Deep Spruce `#064E3B` | Deep Navy `#0C4A6E` |
42
- | **3-Color Accent Gradient** | Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` | Pine `#047857` → Teal `#0D9488` → Mint `#34D399` | Cobalt `#1D4ED8` → Blue `#3B82F6` → Ice `#93C5FD` |
43
- | **Table Header Fill** | Executive Tint `#F1F5F9` | Sage Tint `#ECFDF5` | Azure Tint `#F0F9FF` |
44
- | **Table Header Text** | Bold Slate `#0F172A` | Bold Spruce `#064E3B` | Bold Navy `#0C4A6E` |
45
- | **Callout Background** | Soft Slate `#F8FAFC` | Soft Sage `#F0FDF4` | Soft Sky `#F0F9FF` |
58
+ Never use black, dark gray, dark blue, or dark theme fills. Use refined business-class light palettes with text in medium slate `#64748B`:
59
+
60
+ | Element | Specification & Values |
61
+ |---|---|
62
+ | **Page Background** | Pure White `#FFFFFF` or Soft Pearl `#FAFAFA` |
63
+ | **Typography (Headings & Body)** | Medium Slate `#64748B` (Inter font exclusively) |
64
+ | **4-Base-Color Accent Gradient** | 4-base-color gradient ribbon matching chosen theme (T01–T20) |
65
+ | **Table Header Fill** | Executive Light Tint `#F1F5F9` |
66
+ | **Table Header Text** | Medium Slate `#64748B` (Bold) |
67
+ | **Table Cell Borders** | Subtle Light Slate `#CBD5E1` / `#E2E8F0` |
68
+ | **Alternating Rows** | Soft Pearl `#F8FAFC` |
69
+ | **Callout Background** | Soft Slate `#F8FAFC` with 4-color left border accent |
46
70
 
47
71
  ---
48
72
 
@@ -88,22 +112,26 @@ class NumberedCanvas(canvas.Canvas):
88
112
  if self._pageNumber > 1:
89
113
  self.drawString(54, 11 * inch - 36, "Konoha Infrastructure Engineering · Architecture Audit")
90
114
  self.drawRightString(8.5 * inch - 54, 11 * inch - 36, "Q3 Production Performance")
91
- # 3-Color Gradient Running Header Accent Ribbon
92
- self.setFillColor(colors.HexColor("#1E3A8A"))
93
- self.rect(54, 11 * inch - 42, 170, 2, fill=True, stroke=False)
94
- self.setFillColor(colors.HexColor("#2563EB"))
95
- self.rect(224, 11 * inch - 42, 170, 2, fill=True, stroke=False)
96
- self.setFillColor(colors.HexColor("#60A5FA"))
97
- self.rect(394, 11 * inch - 42, 110, 2, fill=True, stroke=False)
115
+ # 4-Base-Color Gradient Running Header Accent Ribbon (Theme T01)
116
+ self.setFillColor(colors.HexColor("#8A4FD0"))
117
+ self.rect(54, 11 * inch - 42, 125, 2, fill=True, stroke=False)
118
+ self.setFillColor(colors.HexColor("#E8453C"))
119
+ self.rect(179, 11 * inch - 42, 125, 2, fill=True, stroke=False)
120
+ self.setFillColor(colors.HexColor("#F08A24"))
121
+ self.rect(304, 11 * inch - 42, 125, 2, fill=True, stroke=False)
122
+ self.setFillColor(colors.HexColor("#F7C948"))
123
+ self.rect(429, 11 * inch - 42, 75, 2, fill=True, stroke=False)
98
124
 
99
125
  # Footer (all pages)
100
- # 3-Color Gradient Running Footer Accent Ribbon
101
- self.setFillColor(colors.HexColor("#1E3A8A"))
102
- self.rect(54, 46, 170, 1.5, fill=True, stroke=False)
103
- self.setFillColor(colors.HexColor("#2563EB"))
104
- self.rect(224, 46, 170, 1.5, fill=True, stroke=False)
105
- self.setFillColor(colors.HexColor("#60A5FA"))
106
- self.rect(394, 46, 110, 1.5, fill=True, stroke=False)
126
+ # 4-Base-Color Gradient Running Footer Accent Ribbon (Theme T01)
127
+ self.setFillColor(colors.HexColor("#8A4FD0"))
128
+ self.rect(54, 46, 125, 1.5, fill=True, stroke=False)
129
+ self.setFillColor(colors.HexColor("#E8453C"))
130
+ self.rect(179, 46, 125, 1.5, fill=True, stroke=False)
131
+ self.setFillColor(colors.HexColor("#F08A24"))
132
+ self.rect(304, 46, 125, 1.5, fill=True, stroke=False)
133
+ self.setFillColor(colors.HexColor("#F7C948"))
134
+ self.rect(429, 46, 75, 1.5, fill=True, stroke=False)
107
135
 
108
136
  self.drawString(54, 32, "Confidential · Internal Executive Review Only")
109
137
  page_str = f"Page {self._pageNumber} of {page_count}"
@@ -129,7 +157,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
129
157
  fontName='Helvetica-Bold',
130
158
  fontSize=24,
131
159
  leading=30,
132
- textColor=colors.HexColor("#0F172A"),
160
+ textColor=colors.HexColor("#64748B"),
133
161
  spaceAfter=8
134
162
  )
135
163
  subtitle_style = ParagraphStyle(
@@ -138,7 +166,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
138
166
  fontName='Helvetica',
139
167
  fontSize=12,
140
168
  leading=16,
141
- textColor=colors.HexColor("#475569"),
169
+ textColor=colors.HexColor("#64748B"),
142
170
  spaceAfter=20
143
171
  )
144
172
  body_style = ParagraphStyle(
@@ -147,7 +175,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
147
175
  fontName='Helvetica',
148
176
  fontSize=10,
149
177
  leading=14,
150
- textColor=colors.HexColor("#1E293B"),
178
+ textColor=colors.HexColor("#64748B"),
151
179
  spaceAfter=10
152
180
  )
153
181
 
@@ -183,7 +211,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
183
211
  t = Table(table_data, colWidths=[150, 110, 110, 134])
184
212
  t.setStyle(TableStyle([
185
213
  ('BACKGROUND', (0, 0), (-1, 0), colors.HexColor("#F1F5F9")),
186
- ('TEXTCOLOR', (0, 0), (-1, 0), colors.HexColor("#0F172A")),
214
+ ('TEXTCOLOR', (0, 0), (-1, 0), colors.HexColor("#64748B")),
187
215
  ('BOTTOMPADDING', (0, 0), (-1, -1), 6),
188
216
  ('TOPPADDING', (0, 0), (-1, -1), 6),
189
217
  ('GRID', (0, 0), (-1, -1), 0.5, colors.HexColor("#CBD5E1")),
@@ -227,32 +255,32 @@ For environments leveraging HTML-to-PDF compilation via `weasyprint`, use strict
227
255
  }
228
256
  @bottom-right {
229
257
  content: "Page " counter(page) " of " counter(pages);
230
- font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
258
+ font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
231
259
  font-size: 8pt;
232
260
  font-weight: bold;
233
- color: #0F172A;
261
+ color: #64748B;
234
262
  }
235
263
  }
236
264
 
237
265
  body {
238
- font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
239
- color: #1E293B;
266
+ font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
267
+ color: #64748B;
240
268
  background-color: #FFFFFF;
241
269
  line-height: 1.5;
242
270
  font-size: 10pt;
243
271
  }
244
272
 
245
- /* 3-Color Minimum Gradient Accent Ribbon */
273
+ /* 4-Base-Color Theme Gradient Accent Ribbon (Theme T01) */
246
274
  .gradient-bar {
247
275
  height: 4px;
248
- background: linear-gradient(90deg, #1E3A8A 0%, #2563EB 50%, #60A5FA 100%);
276
+ background: linear-gradient(90deg, #8A4FD0 0%, #E8453C 33%, #F08A24 66%, #F7C948 100%);
249
277
  margin-bottom: 24px;
250
278
  border-radius: 2px;
251
279
  }
252
280
 
253
281
  h1 {
254
282
  font-size: 22pt;
255
- color: #0F172A;
283
+ color: #64748B;
256
284
  margin: 0 0 6px 0;
257
285
  font-weight: 700;
258
286
  }
@@ -271,7 +299,7 @@ table {
271
299
 
272
300
  th {
273
301
  background-color: #F1F5F9;
274
- color: #0F172A;
302
+ color: #64748B;
275
303
  font-weight: 600;
276
304
  text-align: left;
277
305
  padding: 8px 12px;
@@ -282,6 +310,7 @@ th {
282
310
  td {
283
311
  padding: 8px 12px;
284
312
  border: 1px solid #E2E8F0;
313
+ color: #64748B;
285
314
  font-size: 9pt;
286
315
  }
287
316
 
@@ -304,9 +333,12 @@ tr:nth-child(even) td {
304
333
  ## 5. Delivery & Verification Checklist
305
334
 
306
335
  Before releasing any executive PDF document:
307
- 1. **Zero Dark Theme Invariant**: Every page must have a pure white (`#FFFFFF`) or pearl (`#FAFAFA`) background. Zero dark covers, headers, or fills.
308
- 2. **3-Color Minimum Gradient Invariant**: Running header/footer ribbons, cover accents, or decorative dividers must use at least 3 gradient stops (e.g. Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA`).
309
- 3. **Table Header Fills**: Executive light tint (`#F1F5F9` or `#E2E8F0`) with crisp high-contrast dark text (`#0F172A`).
310
- 4. **Dynamic Pagination**: Footers must display dynamic `Page X of Y` computed over the actual document length.
311
- 5. **No Overflow / Clipping**: Verify tables and text blocks fit within page margins without trailing orphans or text clipping.
312
- 6. **Metadata Sanitization**: Check PDF properties with `pdfinfo` or Adobe Reader to ensure generator tags (`ReportLab`, `WeasyPrint`) are replaced with professional author and organization names.
336
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Every page must have a pure white (`#FFFFFF`) or pearl (`#FAFAFA`) background. Zero black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds).
337
+ 2. **Medium Slate `#64748B` Typography**: All typography strictly in `#64748B`.
338
+ 3. **Inter Typography Contract**: Inter font strictly used for headings and body.
339
+ 4. **4-Base-Color Theme Gradient**: Running header/footer ribbons, cover accents, or decorative dividers must use a 4-base-color gradient matching one of the 20 canonical themes (T01–T20) consistently.
340
+ 5. **Table Header Fills**: Executive light tint (`#F1F5F9`) with medium slate `#64748B` text and subtle `#CBD5E1` borders.
341
+ 6. **Dynamic Pagination**: Footers must display dynamic `Page X of Y` computed over the actual document length.
342
+ 7. **No Overflow / Clipping**: Verify tables and text blocks fit within page margins without trailing orphans or text clipping.
343
+ 8. **Metadata Sanitization**: Check PDF properties with `pdfinfo` or Adobe Reader to ensure generator tags (`ReportLab`, `WeasyPrint`) are replaced with professional author and organization names.
344
+ 9. **Mandatory Kage Review Gate**: Always run Kage review to verify zero-slop compliance, visual hierarchy, and 0% AI detection before delivery.
@@ -21,8 +21,29 @@ Use this reference whenever building, modifying, or styling presentations and sl
21
21
  ## 1. Zero-AI Slide Design Invariants
22
22
 
23
23
  When creating slide presentations:
24
- - **Strict Light Mode Invariant (Zero Dark Theme Style)**: Under NO circumstances generate, style, or refine slides with dark theme style. Dark slide backgrounds, black title slides, dark hero covers, dark header bars, and near-black card fills are STRICTLY FORBIDDEN. All slides must use pure white (`#FFFFFF`) or soft pearl white (`#F8FAFC`).
25
- - **3-Color Minimum Gradient for Covers, Headers, & Footers**: When visual color or decorative emphasis is needed for title slide covers, header bands, footer accents, or card divider rules, ALWAYS create a smooth multi-stop gradient with a MINIMUM of 3 colors (e.g. Executive Sapphire `#1E3A8A` → `#2563EB` → `#60A5FA`, Teal-to-Cyan-to-Mint `#0D9488` → `#06B6D4` → `#6EE7B7`, or Sunrise Amber `#9A3412` → `#F59E0B` → `#FDE68A`). Never use dark gradients or single flat dark blocks.
24
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances generate, style, or refine slides with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All slides must use pure white (`#FFFFFF`) or pearl (`#F8FAFC`), with text strictly in **medium slate `#64748B`**.
25
+ - **20 Canonical 4-Base-Color Themes**: When decorative color or visual emphasis is needed for title covers, headers, footers, card accent strips, or divider rules, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per deck and keeping it consistent throughout:
26
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
27
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
28
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
29
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
30
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
31
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
32
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
33
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
34
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
35
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
36
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
37
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
38
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
39
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
40
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
41
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
42
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
43
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
44
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
45
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
46
+ - **Strict Typography Contract**: PowerPoint strictly uses **Segoe UI Semibold or Georgia (headings) + Segoe UI or Calibri (body)** with consistent spacing, alignment, and visual hierarchy.
26
47
  - **The "Rule of One"**: Exactly 1 central thesis or key takeaway per slide.
27
48
  - **Strict Ban on AI Bullet Walls**: Never write slides with 4–6 generic bullet points of identical sentence length.
28
49
  - *Bad (AI)*: 5 bullets each starting with "Ensures that...", "Facilitates...", "Helps to optimize..."
@@ -30,8 +51,9 @@ When creating slide presentations:
30
51
  - **Stat Callouts as Visuals**: When presenting performance, savings, or metrics, render the number in massive 44–60pt bold font with a concise 12pt label below it.
31
52
  - **Asymmetric 2-Column Layouts**: Use 60/40 or 70/30 split layouts (e.g. left side big takeaway and key metrics, right side data table or architectural diagram).
32
53
  - **16:9 Widescreen Standard**: Always format for 16:9 widescreen (`layout: 'LAYOUT_16x9'` in pptxgenjs; `slide_width = Inches(13.333)`, `slide_height = Inches(7.5)` in python-pptx).
33
- - **Strict Zero Watermark Invariant**: Under NO circumstances should presentation slide decks contain watermarks, translucent "CONFIDENTIAL" / "DRAFT" diagonal stamps, or background evaluation watermarks.
54
+ - **Strict Zero Watermark Invariant**: Under NO circumstances should presentation slide decks contain watermarks, translucent stamps, or background evaluation watermarks.
34
55
  - **Metadata Scrubbing**: Set core presentation properties (`creator`, `lastModifiedBy`, `title`) to the human author or project name; remove `python-pptx` and `pptxgenjs` tags.
56
+ - **Mandatory Kage Review Gate**: Always use Kage review on every generated PPTX presentation.
35
57
 
36
58
  ---
37
59
 
@@ -20,8 +20,29 @@ Use this reference whenever generating, editing, or auditing Microsoft Excel (.x
20
20
  ## 1. Zero-AI Human Data Presentation Invariants
21
21
 
22
22
  When creating spreadsheets:
23
- - **Strict Light Mode Invariant (Zero Dark Style)**: Spreadsheets must strictly use pure light mode. Never apply dark theme fills, dark covers, dark header blocks, or black/near-black fills to cells, sheets, or tables. Backgrounds must be pure white (`#FFFFFF`) or soft pearl (`#F8FAFC`).
24
- - **3-Color Minimum Gradient Invariant**: When decorative accent styling is applied (such as top accent ribbons on table headers, summary cards, or KPI divider rows), use a smooth multi-stop gradient with a minimum of 3 colors (e.g., Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` or Emerald `#047857` → Teal `#0D9488` → Mint `#34D399`), never dark monotone fills.
23
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances create, generate, or style Excel workbooks with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All sheet backgrounds must be pure white (`#FFFFFF`) or pearl (`#F8FAFC`), with text strictly in **medium slate `#64748B`**.
24
+ - **20 Canonical 4-Base-Color Themes**: When decorative accent styling is applied (such as top accent ribbons on table headers, summary cards, or KPI divider rows), ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per document and keeping it consistent throughout:
25
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
26
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
27
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
28
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
29
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
30
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
31
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
32
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
33
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
34
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
35
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
36
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
37
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
38
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
39
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
40
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
41
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
42
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
43
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
44
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
45
+ - **Strict Typography Contract**: Excel spreadsheets strictly use **Calibri for both headings and body**, with crisp point sizing (Title: 16pt, Subtitle: 10pt, Headers/Data: 11pt, Totals: 11pt bold).
25
46
  - **Zero Raw Numbers**: Never leave bare floats (`0.3333333333`). Format currency as `$#,##0` or `$#,##0.00`, percentages as `0.0%` or `0%`, counts as `#,##0`.
26
47
  - **Formulas Over Hardcoded Values**: If a number is derived from other cells, calculate it via an Excel formula (`=SUM(C4:C12)`, `=C13-D13`), never paste pre-calculated static values into summary rows.
27
48
  - **Formula Casing**: Always write formula names in ALL CAPS (`SUM`, `AVERAGE`, `IF`, `XLOOKUP`, `INDEX`, `MATCH`). Lowercase formula names (`=sum(...)`) signal hasty robotic generation.
@@ -29,21 +50,23 @@ When creating spreadsheets:
29
50
  - **Visual Grid & Freeze Panes**: Explicitly enable `ws.views.sheetView[0].showGridLines = True` and freeze header rows (`ws.freeze_panes = 'A5'`).
30
51
  - **Strict Zero Watermark Invariant**: Under NO circumstances should generated, styled, or edited Excel workbooks contain watermarks, diagonal background stamps, sheet header watermark graphics, or evaluation marks.
31
52
  - **Metadata Scrubbing**: Set workbook author and properties to the human analyst / organization; remove `openpyxl` / `pandas` application tags.
53
+ - **Mandatory Kage Review Gate**: Every generated Excel workbook must undergo Kage review before completion.
32
54
 
33
55
  ---
34
56
 
35
57
  ## 2. Professional Enterprise Color Palettes (Pure Light Mode)
36
58
 
37
- Never use dark theme fills, harsh bright primary colors, or black header bars. Use refined business-class light palettes:
59
+ Never use black, dark gray, dark blue, or dark theme fills. Use refined business-class light palettes with text in medium slate `#64748B`:
38
60
 
39
- | Element | Executive Slate (Default) | Mint Sage Finance | Modern Azure Tech |
40
- |---|---|---|---|
41
- | **Header Background** | Executive Slate Tint `#F1F5F9` | Sage Mint Tint `#ECFDF5` | Ice Azure Tint `#F0F9FF` |
42
- | **Header Text** | Deep Slate `#0F172A` (Bold) | Deep Forest `#064E3B` (Bold) | Deep Navy `#0C4A6E` (Bold) |
43
- | **Header Accent Ribbon** | Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` | Pine `#047857` → Teal `#0D9488` → Mint `#34D399` | Cobalt `#1D4ED8` → Blue `#3B82F6` → Ice `#93C5FD` |
44
- | **Zebra Row Shading** | Pearl `#F8FAFC` | Mint Pearl `#F0FDF4` | Sky Pearl `#F8FAFC` |
45
- | **Total / Summary Row** | Top thin border `#CBD5E1`, double bottom `#0F172A` | Top thin border `#A7F3D0`, double bottom `#064E3B` | Top thin border `#BAE6FD`, double bottom `#0C4A6E` |
46
- | **Accent / KPI Highlight** | Indigo `#4F46E5` | Emerald `#10B981` | Cyan `#06B6D4` |
61
+ | Element | Specification & Values |
62
+ |---|---|
63
+ | **Sheet Background** | Pure White `#FFFFFF` or Pearl `#F8FAFC` |
64
+ | **Typography (Headings & Body)** | Medium Slate `#64748B` (Calibri font exclusively) |
65
+ | **Header Background** | Executive Slate Tint `#F1F5F9` |
66
+ | **Header Accent Ribbon** | 4-base-color gradient ribbon matching the chosen theme (T01–T20) |
67
+ | **Zebra Row Shading** | Pearl `#F8FAFC` |
68
+ | **Total / Summary Row** | Top thin border `#CBD5E1`, double bottom `#64748B`, text in `#64748B` (bold) |
69
+ | **Cell Borders** | Subtle light slate `#E2E8F0` / `#CBD5E1` |
47
70
 
48
71
  ---
49
72
 
@@ -63,20 +86,21 @@ ws.title = "Q3 Infrastructure ROI"
63
86
  # Enforce explicit gridlines
64
87
  ws.views.sheetView[0].showGridLines = True
65
88
 
66
- # Styling definitions (Pure Light Executive Class)
67
- font_title = Font(name="Calibri", size=16, bold=True, color="0F172A")
89
+ # Styling definitions (Pure Light Executive Class - Text strictly in #64748B, Zero dark colors)
90
+ font_title = Font(name="Calibri", size=16, bold=True, color="64748B")
68
91
  font_subtitle = Font(name="Calibri", size=10, italic=True, color="64748B")
69
- font_header = Font(name="Calibri", size=11, bold=True, color="0F172A")
70
- font_body = Font(name="Calibri", size=11, color="1E293B")
71
- font_total = Font(name="Calibri", size=11, bold=True, color="0F172A")
92
+ font_header = Font(name="Calibri", size=11, bold=True, color="64748B")
93
+ font_body = Font(name="Calibri", size=11, color="64748B")
94
+ font_total = Font(name="Calibri", size=11, bold=True, color="64748B")
72
95
 
73
96
  fill_header = PatternFill(start_color="F1F5F9", end_color="F1F5F9", fill_type="solid")
74
97
  fill_zebra = PatternFill(start_color="F8FAFC", end_color="F8FAFC", fill_type="solid")
75
98
 
76
- # 3-Color Minimum Gradient Accent Bar (Row 3)
77
- fill_accent_1 = PatternFill(start_color="1E3A8A", end_color="1E3A8A", fill_type="solid") # Sapphire
78
- fill_accent_2 = PatternFill(start_color="2563EB", end_color="2563EB", fill_type="solid") # Azure
79
- fill_accent_3 = PatternFill(start_color="60A5FA", end_color="60A5FA", fill_type="solid") # Sky
99
+ # 4-Base-Color Gradient Accent Ribbon (Theme T01 example: #8A4FD0, #E8453C, #F08A24, #F7C948)
100
+ fill_accent_1 = PatternFill(start_color="8A4FD0", end_color="8A4FD0", fill_type="solid")
101
+ fill_accent_2 = PatternFill(start_color="E8453C", end_color="E8453C", fill_type="solid")
102
+ fill_accent_3 = PatternFill(start_color="F08A24", end_color="F08A24", fill_type="solid")
103
+ fill_accent_4 = PatternFill(start_color="F7C948", end_color="F7C948", fill_type="solid")
80
104
 
81
105
  align_left = Alignment(horizontal="left", vertical="center")
82
106
  align_right = Alignment(horizontal="right", vertical="center")
@@ -84,7 +108,7 @@ align_center = Alignment(horizontal="center", vertical="center")
84
108
 
85
109
  border_thin = Side(style="thin", color="E2E8F0")
86
110
  border_header = Side(style="medium", color="CBD5E1")
87
- border_double = Side(style="double", color="0F172A")
111
+ border_double = Side(style="double", color="64748B")
88
112
  border_total = Border(top=border_thin, bottom=border_double)
89
113
  border_cell = Border(left=border_thin, right=border_thin, top=border_thin, bottom=border_thin)
90
114
 
@@ -94,14 +118,14 @@ ws["A1"].font = font_title
94
118
  ws["A2"] = "Prepared by Infrastructure SRE Team | Target Savings: $450,000/yr"
95
119
  ws["A2"].font = font_subtitle
96
120
 
97
- # 3-Color Gradient Accent Ribbon above table header
121
+ # 4-Color Gradient Accent Ribbon above table header (Theme T01)
98
122
  ws.row_dimensions[3].height = 4
99
123
  ws["A3"].fill = fill_accent_1
100
124
  ws["B3"].fill = fill_accent_1
101
125
  ws["C3"].fill = fill_accent_2
102
- ws["D3"].fill = fill_accent_2
103
- ws["E3"].fill = fill_accent_3
104
- ws["F3"].fill = fill_accent_3
126
+ ws["D3"].fill = fill_accent_3
127
+ ws["E3"].fill = fill_accent_4
128
+ ws["F3"].fill = fill_accent_4
105
129
 
106
130
  # Table Headers (Light Executive Tint)
107
131
  headers = ["Service Component", "Cluster Tier", "Old Monthly Cost", "New Monthly Cost", "Net Savings", "Delta %"]
@@ -206,11 +230,14 @@ wb.save("infrastructure_roi.xlsx")
206
230
  ## 4. Delivery & Verification Checklist
207
231
 
208
232
  Before shipping any spreadsheet:
209
- 1. **Zero Dark Theme Invariant**: Pure light mode strictly enforced. Background is pure white (`#FFFFFF`) or soft pearl (`#F8FAFC`). Zero dark header blocks or dark cells.
210
- 2. **3-Color Minimum Gradient Invariant**: Any decorative accent bars, top ribbons, or KPI highlights must use at least 3 gradient stops (e.g. Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA`).
211
- 3. **Table Header Fills**: Executive light tint (`#F1F5F9` / `#ECFDF5`) with bold dark high-contrast typography (`#0F172A`).
212
- 4. **Formula Accuracy**: Verify workbook opens in Excel/LibreOffice with 0 formula repair warnings (`#NAME?`, `#VALUE!`, `#REF!`).
213
- 5. **Formatting**: Verify all numbers have explicit number formatting (`$#,##0`, `0.0%`, `#,##0`).
214
- 6. **Freeze Panes & Gridlines**: Confirm freeze panes are set on the header row and gridlines are explicitly turned on (`showGridLines = True`).
215
- 7. **Auto-Fit**: Check column widths: no text is clipped and no numbers appear as `###`.
216
- 8. **Metadata**: Confirm metadata properties have been sanitized.
233
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Pure light mode strictly enforced. Background is pure white (`#FFFFFF`) or soft pearl (`#F8FAFC`). Zero dark headers, black cells, dark blue, or dark gray anywhere.
234
+ 2. **Medium Slate `#64748B` Typography**: All text (titles, headers, body, numbers, totals) strictly set in `#64748B`.
235
+ 3. **Calibri Typography Contract**: Calibri font strictly used for both headings and body text.
236
+ 4. **4-Base-Color Theme Gradient**: Decorative accent ribbons or KPI highlights strictly use a smooth 4-base-color gradient matching one of the 20 canonical themes (T01–T20) consistently.
237
+ 5. **Table Header Fills**: Executive light tint (`#F1F5F9`) with bold `#64748B` typography and subtle `#CBD5E1` borders.
238
+ 6. **Formula Accuracy**: Verify workbook opens in Excel/LibreOffice with 0 formula repair warnings (`#NAME?`, `#VALUE!`, `#REF!`). Formulas use UPPERCASE names (`SUM`, `AVERAGE`).
239
+ 7. **Formatting**: Verify all numbers have explicit number formatting (`$#,##0`, `0.0%`, `#,##0`).
240
+ 8. **Freeze Panes & Gridlines**: Confirm freeze panes are set on the header row and gridlines are explicitly turned on (`showGridLines = True`).
241
+ 9. **Auto-Fit**: Check column widths: no text is clipped and no numbers appear as `###`.
242
+ 10. **Metadata**: Confirm metadata properties have been sanitized.
243
+ 11. **Mandatory Kage Review Gate**: Always run Kage review to verify zero-slop compliance, visual hierarchy, and 0% AI detection before delivery.