@installagent/sdk 0.1.0
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/dist/agent-templates.d.ts +90 -0
- package/dist/agent-templates.js +211 -0
- package/dist/client-build.d.ts +50 -0
- package/dist/client-build.js +155 -0
- package/dist/client-context.d.ts +40 -0
- package/dist/client-context.js +70 -0
- package/dist/client-drive.d.ts +67 -0
- package/dist/client-drive.js +278 -0
- package/dist/client-intake.d.ts +68 -0
- package/dist/client-intake.js +189 -0
- package/dist/client-linear.d.ts +30 -0
- package/dist/client-linear.js +85 -0
- package/dist/docs-search.d.ts +44 -0
- package/dist/docs-search.js +187 -0
- package/dist/doctor.d.ts +43 -0
- package/dist/doctor.js +425 -0
- package/dist/env-file.d.ts +25 -0
- package/dist/env-file.js +69 -0
- package/dist/env-fill.d.ts +43 -0
- package/dist/env-fill.js +161 -0
- package/dist/env-push.d.ts +37 -0
- package/dist/env-push.js +137 -0
- package/dist/env-registry.d.ts +49 -0
- package/dist/env-registry.js +230 -0
- package/dist/exec.d.ts +14 -0
- package/dist/exec.js +16 -0
- package/dist/fathom-webhook.d.ts +44 -0
- package/dist/fathom-webhook.js +123 -0
- package/dist/fs-utils.d.ts +9 -0
- package/dist/fs-utils.js +34 -0
- package/dist/gcp-service-account-key.d.ts +37 -0
- package/dist/gcp-service-account-key.js +66 -0
- package/dist/gemini-api-key.d.ts +47 -0
- package/dist/gemini-api-key.js +132 -0
- package/dist/git.d.ts +16 -0
- package/dist/git.js +29 -0
- package/dist/github-token.d.ts +24 -0
- package/dist/github-token.js +30 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +28 -0
- package/dist/init.d.ts +47 -0
- package/dist/init.js +101 -0
- package/dist/linear-project.d.ts +81 -0
- package/dist/linear-project.js +192 -0
- package/dist/new-client.d.ts +32 -0
- package/dist/new-client.js +89 -0
- package/dist/ping.d.ts +6 -0
- package/dist/ping.js +7 -0
- package/dist/portal-admin.d.ts +133 -0
- package/dist/portal-admin.js +144 -0
- package/dist/sync-templates.d.ts +58 -0
- package/dist/sync-templates.js +109 -0
- package/dist/template-sync.d.ts +55 -0
- package/dist/template-sync.js +90 -0
- package/dist/templates.d.ts +19 -0
- package/dist/templates.js +24 -0
- package/dist/wizard.d.ts +78 -0
- package/dist/wizard.js +213 -0
- package/package.json +30 -0
- package/templates/env.example +60 -0
- package/templates/workspace-root/.claude/settings.json +39 -0
- package/templates/workspace-root/AGENT.md +205 -0
- package/templates/workspace-root/AGENTS.md +11 -0
- package/templates/workspace-root/CLAUDE.md +63 -0
- package/templates/workspace-root/GEMINI.md +24 -0
- package/templates/workspace-root/ONBOARDING.md +164 -0
- package/templates/workspace-root/README.md +67 -0
- package/templates/workspace-root/skills/CLAUDE.md +79 -0
- package/templates/workspace-root/skills/client-deliverables/SKILL.md +131 -0
- package/templates/workspace-root/skills/client-deliverables/references/package-layout.md +103 -0
- package/templates/workspace-root/skills/client-facing-docs/SKILL.md +131 -0
- package/templates/workspace-root/skills/client-facing-docs/references/doc-structures.md +81 -0
- package/templates/workspace-root/skills/client-llm-setup/SKILL.md +97 -0
- package/templates/workspace-root/skills/client-llm-setup/references/guide-template.md +87 -0
- package/templates/workspace-root/skills/client-workflow-diagram/SKILL.md +141 -0
- package/templates/workspace-root/skills/client-workflow-diagram/references/excalidraw-format.md +140 -0
- package/templates/workspace-root/skills/contract-tech-agnostic/SKILL.md +99 -0
- package/templates/workspace-root/skills/contract-tech-agnostic/references/Install_Agent_SOW_Template.docx +0 -0
- package/templates/workspace-root/skills/design-system/SKILL.md +118 -0
- package/templates/workspace-root/skills/design-system/references/tokens.md +139 -0
- package/templates/workspace-root/skills/engagement-spec/SKILL.md +272 -0
- package/templates/workspace-root/skills/engagement-spec/references/spec-templates.md +220 -0
- package/templates/workspace-root/skills/house-voice/SKILL.md +158 -0
- package/templates/workspace-root/skills/house-voice/references/source-copy.md +173 -0
- package/templates/workspace-root/skills/ia-cli/SKILL.md +87 -0
- package/templates/workspace-root/skills/installagent-brand-kit/SKILL.md +112 -0
- package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-logo.svg +1 -0
- package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-mark.svg +1 -0
- package/templates/workspace-root/skills/installagent-brand-kit/references/brand-tokens.md +71 -0
- package/templates/workspace-root/skills/installagent-brand-kit/references/branded-pdf.md +66 -0
- package/templates/workspace-root/skills/installagent-brand-kit/references/excalidraw-red-theme.md +73 -0
- package/templates/workspace-root/skills/installagent-brand-kit/scripts/brand.py +175 -0
- package/templates/workspace-root/skills/linear/SKILL.md +186 -0
- package/templates/workspace-root/skills/tech-call-prep/SKILL.md +141 -0
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
# Source copy — installagent.com/get-started
|
|
2
|
+
|
|
3
|
+
Verbatim extraction of the live get-started page, section by section. This is
|
|
4
|
+
the **corpus** the `house-voice` skill's patterns were pulled from — when a
|
|
5
|
+
pattern in `SKILL.md` cites an example, it's quoting this file. If the page
|
|
6
|
+
copy changes, re-pull it and update both files in the same pass; if this
|
|
7
|
+
drifts far enough from the live page, the skill drifts with it.
|
|
8
|
+
|
|
9
|
+
Snapshot date: 2026-07-27. Source: `https://installagent.com/get-started`
|
|
10
|
+
(redirects to `www.installagent.com/get-started`).
|
|
11
|
+
|
|
12
|
+
## Meta
|
|
13
|
+
|
|
14
|
+
- Title: "Install Agent: Your Fractional AI Technician, Backed by a Full Team"
|
|
15
|
+
- Description: "A dedicated, qualified AI technician who learns your business
|
|
16
|
+
top to bottom and automates your admin, backed by a team with experience
|
|
17
|
+
from IBM, Amazon, Google, and Meta. At a fraction of the cost of a
|
|
18
|
+
full-time hire."
|
|
19
|
+
|
|
20
|
+
## Hero
|
|
21
|
+
|
|
22
|
+
- Trust badge: "Trusted by 150+ business owners" · "5 out of 5 stars" ·
|
|
23
|
+
"Business Owners & Operators"
|
|
24
|
+
- Headline: "**Fractional AI Partner**" / "**Can Change Your Business**" (full
|
|
25
|
+
reads as "See How A Fractional AI Partner Can Change Your Business")
|
|
26
|
+
- Subhead: "Automate the busywork that's draining your hours and your
|
|
27
|
+
payroll."
|
|
28
|
+
- Primary CTA: "Book Your Discovery Call"
|
|
29
|
+
- Secondary: "Watch what we do. 2 min."
|
|
30
|
+
|
|
31
|
+
## What we do (opening pitch)
|
|
32
|
+
|
|
33
|
+
"Install Agent gives you a dedicated AI technician with a full team of
|
|
34
|
+
engineers behind them. They learn how your business runs, then automate your
|
|
35
|
+
busywork inside the tools you already use."
|
|
36
|
+
|
|
37
|
+
"The result: hours back every week, work that finishes itself, and expert AI
|
|
38
|
+
help without the six-figure salary. We design it, build it, run it, and keep
|
|
39
|
+
it sharp. You don't lift a finger."
|
|
40
|
+
|
|
41
|
+
Differentiator card:
|
|
42
|
+
- "A dedicated technician, not a rotating help desk"
|
|
43
|
+
- "Built inside your existing tools"
|
|
44
|
+
- "White-glove service, month to month, no lock-in"
|
|
45
|
+
|
|
46
|
+
## The problem
|
|
47
|
+
|
|
48
|
+
"You're still doing manual admin, and it's compounding."
|
|
49
|
+
|
|
50
|
+
"If you stop responding, parts of your business stop moving."
|
|
51
|
+
|
|
52
|
+
Symptom tags: "Inbox volume grows" · "Follow-ups slip" · "Invoices, updates,
|
|
53
|
+
and approvals pile up" · "Manual processes never get rebuilt"
|
|
54
|
+
|
|
55
|
+
"Revenue increases. Complexity increases."
|
|
56
|
+
|
|
57
|
+
"But your internal systems stay the same, and hiring someone to fix it means
|
|
58
|
+
a six-figure salary and months of ramp-up before real output."
|
|
59
|
+
|
|
60
|
+
## Who does the work
|
|
61
|
+
|
|
62
|
+
"A dedicated AI technician who becomes part of your team"
|
|
63
|
+
|
|
64
|
+
"Not software you configure yourself. Not a ticket queue. One qualified
|
|
65
|
+
technician who learns your business from top to bottom and builds alongside
|
|
66
|
+
you, at a fraction of the cost of a full-time hire."
|
|
67
|
+
|
|
68
|
+
**They learn your business**
|
|
69
|
+
- "Understand how you actually operate, end to end"
|
|
70
|
+
- "Work inside your processes and the tools you already trust"
|
|
71
|
+
- "Carry more context, and add more value, the longer you work together"
|
|
72
|
+
|
|
73
|
+
**They build and advise**
|
|
74
|
+
- "Build your automations and explain exactly how each one works"
|
|
75
|
+
- "Proactively find new opportunities to save you time"
|
|
76
|
+
|
|
77
|
+
## Backed by a full bench
|
|
78
|
+
|
|
79
|
+
"One technician in front. A world-class team behind."
|
|
80
|
+
|
|
81
|
+
"Your technician is not working alone. Behind every build is a team of
|
|
82
|
+
experienced engineers and technicians who have worked at IBM, Amazon, Google,
|
|
83
|
+
and Meta, with hundreds of automation builds already under our belt."
|
|
84
|
+
|
|
85
|
+
"Big-tech engineering standards, applied to your back office"
|
|
86
|
+
- "Every automation reviewed by our operations team before it goes live"
|
|
87
|
+
- "We live and breathe AI every single day, so you don't have to track a
|
|
88
|
+
field that changes every few months"
|
|
89
|
+
|
|
90
|
+
## A common question — "Why not just hire in-house?"
|
|
91
|
+
|
|
92
|
+
| Hiring in-house | An Install Agent partnership |
|
|
93
|
+
|---|---|
|
|
94
|
+
| A six-figure salary, plus benefits and overhead | A qualified technician, up to speed in weeks, at a fraction of the cost |
|
|
95
|
+
| Months of ramp-up before real output | A structured internal AI system |
|
|
96
|
+
| One person's knowledge, with hiring and turnover risk | An extensive team and big-tech experience behind them |
|
|
97
|
+
| Hard to stay current as tools change every few months | Hundreds of builds already under our belt / Always current: we re-tune and upgrade as AI evolves |
|
|
98
|
+
|
|
99
|
+
## A structured internal AI system
|
|
100
|
+
|
|
101
|
+
"We install and configure internal AI agents trained on your workflows and
|
|
102
|
+
connected to your core systems."
|
|
103
|
+
|
|
104
|
+
- **Communication Layer** — "Email triage, routing, escalation rules, and
|
|
105
|
+
structured draft replies to cut inbox load and response delays."
|
|
106
|
+
- **Scheduling & Follow-Up Layer** — "Automated booking, reminders,
|
|
107
|
+
follow-through sequences, and meeting recaps to eliminate manual
|
|
108
|
+
coordination."
|
|
109
|
+
- **Knowledge & Delegation Layer** — "Internal AI trained on your SOPs and
|
|
110
|
+
documentation, so repetitive questions stop landing on your desk."
|
|
111
|
+
|
|
112
|
+
## Optional on-site installation
|
|
113
|
+
|
|
114
|
+
"Want It Fully In-House? We Fly to You." / "Optional on-site installation,
|
|
115
|
+
anywhere in the U.S."
|
|
116
|
+
|
|
117
|
+
"For teams that want tighter control, we offer an optional on-site
|
|
118
|
+
installation: a dedicated technician flies to your location and deploys your
|
|
119
|
+
entire AI infrastructure on hardware you own, inside your own walls."
|
|
120
|
+
|
|
121
|
+
Steps: "Deploy the server" → "Integrate the workflows" → "Hand over and
|
|
122
|
+
train"
|
|
123
|
+
|
|
124
|
+
- "Your technician configures the server you own and brings your self-hosted
|
|
125
|
+
platform fully online."
|
|
126
|
+
- "Every prepared automation is connected and brought live in your
|
|
127
|
+
environment, end to end."
|
|
128
|
+
- "Hands-on, in-person training so your team can operate, monitor, and trust
|
|
129
|
+
the system before we leave."
|
|
130
|
+
|
|
131
|
+
"You leave the day fully up and running: a working system on your own
|
|
132
|
+
hardware, in your own environment, fully under your control. If data
|
|
133
|
+
control, security posture, or compliance is a priority, this is the path
|
|
134
|
+
that keeps everything in-house."
|
|
135
|
+
|
|
136
|
+
## FAQ — "Questions, answered"
|
|
137
|
+
|
|
138
|
+
**Do I need technical people on my team?**
|
|
139
|
+
No. Your dedicated technician builds everything and shows your team how to
|
|
140
|
+
use it. White-glove means we handle it end to end.
|
|
141
|
+
|
|
142
|
+
**Do you work in the tools we already use?**
|
|
143
|
+
Yes. We build inside the systems you already trust: CRM, email, accounting,
|
|
144
|
+
Slack, spreadsheets. We recommend new tools only when they are genuinely
|
|
145
|
+
better.
|
|
146
|
+
|
|
147
|
+
**How fast do we see value?**
|
|
148
|
+
Most clients have their first automations live within the first several
|
|
149
|
+
weeks, and your first workflow is delivered during onboarding in week one.
|
|
150
|
+
|
|
151
|
+
**Is my data secure?**
|
|
152
|
+
We work within the accounts you already control, access only what each
|
|
153
|
+
automation needs, and review every automation before go-live. Nothing is a
|
|
154
|
+
black box. If you want everything fully in-house, our optional on-site
|
|
155
|
+
installation deploys it all on hardware you own.
|
|
156
|
+
|
|
157
|
+
**Can you install everything at our location?**
|
|
158
|
+
Yes. On-site installation is an optional add-on. A dedicated technician
|
|
159
|
+
flies anywhere in the U.S. and brings your entire system live on your own
|
|
160
|
+
hardware, with hands-on training before we leave.
|
|
161
|
+
|
|
162
|
+
**What does it cost?**
|
|
163
|
+
Partnerships are tailored to your business and scoped together on your
|
|
164
|
+
discovery call, always at a fraction of the cost of a full-time hire.
|
|
165
|
+
|
|
166
|
+
## Closing CTA
|
|
167
|
+
|
|
168
|
+
"Start Your Infrastructure Rollout" / "Start your infrastructure rollout"
|
|
169
|
+
|
|
170
|
+
"Tell us where time is leaking. We'll pair you with a fractional AI
|
|
171
|
+
partner."
|
|
172
|
+
|
|
173
|
+
"Your direct line for ideas, questions, and guidance"
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ia-cli
|
|
3
|
+
description: >-
|
|
4
|
+
Route work through the `ia` CLI (team-tools) instead of hand-rolling it —
|
|
5
|
+
the decision map from task to command, plus setup/repair via `ia wizard`
|
|
6
|
+
and `ia doctor`. Use this WHENEVER a task matches an existing `ia`
|
|
7
|
+
operation: answering "what's the status / context on client [slug]?"
|
|
8
|
+
(don't grep repos or draft Airtable/Drive/Linear API calls — `ia client`,
|
|
9
|
+
`ia client-build`, `ia client-drive`, `ia client-linear` already do it
|
|
10
|
+
read-only), starting a new client engagement, building an n8n automation
|
|
11
|
+
(check the bank first), minting a credential, administering the portal,
|
|
12
|
+
searching the team docs, or setting up / fixing a technician's
|
|
13
|
+
environment ("set me up", "my env vars are missing", "clone the
|
|
14
|
+
workspace", onboarding a new machine). Reach for it before writing any
|
|
15
|
+
custom script against GitHub, Airtable, Linear, Drive, n8n, or the
|
|
16
|
+
portal — if an `ia` command covers it, use the command.
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# ia-cli — use the team CLI, don't reinvent it
|
|
20
|
+
|
|
21
|
+
`ia` (built in `team-tools/`) is the guardrailed way to do Install Agent
|
|
22
|
+
internal operations. Every command is also an MCP tool (server:
|
|
23
|
+
`team-tools/apps/mcp`), so agents can call the same operations directly when
|
|
24
|
+
the MCP server is registered. **Default to `ia` over custom scripts**: the
|
|
25
|
+
commands are tested, read-only where they should be, and refuse the
|
|
26
|
+
foot-guns (overwriting work, writing to the registry/Airtable, storing
|
|
27
|
+
secrets).
|
|
28
|
+
|
|
29
|
+
## Decision map
|
|
30
|
+
|
|
31
|
+
| The task is… | Run |
|
|
32
|
+
|---|---|
|
|
33
|
+
| Set up a machine from nothing / onboard a technician | `ia wizard <dir>` (clones every team repo + root docs + `.env`) |
|
|
34
|
+
| Converge an existing workspace with the canonical one | `ia wizard <dir> --update` (ff-only pulls + refresh drifted root docs) |
|
|
35
|
+
| "Is my environment OK?" / missing env vars / broken setup | `ia doctor [-w <dir>]` — every gap comes with a fix-it line |
|
|
36
|
+
| Who is client X / latest calls / what shipped? | `ia client <slug>` |
|
|
37
|
+
| What's in client X's build repo docs? | `ia client-build <slug> [query]` |
|
|
38
|
+
| Find a client's call transcript / Drive deliverable | `ia client-drive <slug> [query]` |
|
|
39
|
+
| Open Linear issues for a client | `ia client-linear <slug> [query]` |
|
|
40
|
+
| Open issues in an internal Linear project | `ia linear-project <project> [query]` |
|
|
41
|
+
| Start a new client engagement | `ia client-intake <slug> --name <name>` (or bare `ia new-client <slug>`) |
|
|
42
|
+
| Client repos drifted from client-template's lint/CI files | `ia template-sync [--apply]` |
|
|
43
|
+
| Search the team docs site | `ia docs search "<query>"` |
|
|
44
|
+
| Building an n8n automation | `ia agent templates` FIRST (the bank), then `ia agent create <template>`; bank the result back with `ia agent save` |
|
|
45
|
+
| Mint a GCP SA key / Gemini key / Fathom webhook | `ia secrets mint <kind> …` |
|
|
46
|
+
| Portal org/agent admin (create org, passwords, run sync) | `ia portal <cmd>` — CLI-only, never via MCP |
|
|
47
|
+
|
|
48
|
+
Flags, inputs, and required env vars per command: the generated reference at
|
|
49
|
+
`team-tools/docs/reference/cli.md` (MCP twins: `mcp-tools.md`). That
|
|
50
|
+
reference is regenerated on every change — trust it over any hand-written
|
|
51
|
+
list, including this one.
|
|
52
|
+
|
|
53
|
+
## Guardrails you inherit (and must not work around)
|
|
54
|
+
|
|
55
|
+
- The `client*` family, `docs search`, `agent templates`, and `linear-*`
|
|
56
|
+
are **read-only**. Nothing in `ia` ever writes to the team-clients
|
|
57
|
+
registry or Airtable.
|
|
58
|
+
- `ia secrets mint *` and `ia portal set-password` print the secret **once**
|
|
59
|
+
(stdout is exactly the secret) and store nothing — save it to the client's
|
|
60
|
+
1Password vault immediately.
|
|
61
|
+
- Anything touching existing files skips or refuses; nothing overwrites
|
|
62
|
+
silently. The root `.env` is never overwritten, not even by
|
|
63
|
+
`wizard --update`.
|
|
64
|
+
- Portal mutations and `client-intake` are deliberately CLI-only (no MCP
|
|
65
|
+
twin) — don't script agents around that.
|
|
66
|
+
|
|
67
|
+
## Environment
|
|
68
|
+
|
|
69
|
+
- Every `ia` command auto-loads the workspace root `.env` (walk-up from
|
|
70
|
+
cwd; shell-exported vars win). If a command reports a missing var, run
|
|
71
|
+
`ia doctor` — don't scatter exports into `~/.zshrc`; fill the root `.env`
|
|
72
|
+
from 1Password. New var names appear in `.env.example`.
|
|
73
|
+
- No `ia` on PATH yet? The CLI lives in `team-tools/`:
|
|
74
|
+
`pnpm install && pnpm -r build`, then `node apps/cli/dist/index.js …`
|
|
75
|
+
(bootstrap order for a from-scratch machine is in root `ONBOARDING.md`).
|
|
76
|
+
- Cloning InstallAgent repos requires GitHub SSH access; on shared machines
|
|
77
|
+
the identity may be directory-scoped — if a clone fails with auth errors,
|
|
78
|
+
say so rather than retrying with other credentials.
|
|
79
|
+
|
|
80
|
+
## When NOT to use ia
|
|
81
|
+
|
|
82
|
+
- The operation doesn't exist yet → build it *into* team-tools (skill:
|
|
83
|
+
`add-sdk-operation` in `team-tools/.claude/skills/`), don't one-off it.
|
|
84
|
+
- Deep portal backfills → the portal repo's break-glass script, not
|
|
85
|
+
`sync-runs`.
|
|
86
|
+
- Registry writes (new lead profiles) → the `team-new-lead` n8n workflow
|
|
87
|
+
owns those; nothing else writes there.
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: installagent-brand-kit
|
|
3
|
+
description: >-
|
|
4
|
+
The official Install Agent brand kit for deliverables — the canonical palette
|
|
5
|
+
(deep red #d11a1a on white / signal red #ff2d2d, white foreground), the official logo
|
|
6
|
+
assets, and copy-paste recipes that apply them to Excalidraw diagrams (house
|
|
7
|
+
RED theme) and client PDFs (SOW, proposal, overview, onboarding, one-pagers).
|
|
8
|
+
Use this WHENEVER a diagram or document needs to look on-brand — triggers
|
|
9
|
+
include "make it on-brand", "use our brand color/red", "add our logo",
|
|
10
|
+
"official logo not a generic one", "branded PDF", "SOW/proposal PDF", "red
|
|
11
|
+
excalidraw", "match our theme", or any client-facing visual. Reach for it even
|
|
12
|
+
if the user never says "skill". It mirrors the single brand source
|
|
13
|
+
(team-web/packages/ui/theme.css) and ships scripts/brand.py so generators
|
|
14
|
+
never hard-code a hex or re-draw the logo. Pairs with client-workflow-diagram,
|
|
15
|
+
engagement-spec, and contract-tech-agnostic — this one governs BRAND, those
|
|
16
|
+
govern content/layout.
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# Install Agent brand kit — branded diagrams & PDFs
|
|
20
|
+
|
|
21
|
+
Make any deliverable look like it came from Install Agent: the right red, the
|
|
22
|
+
real logo, consistent type. This skill is the **brand layer** — it doesn't
|
|
23
|
+
decide what a diagram or document *says* (that's `client-workflow-diagram`,
|
|
24
|
+
`engagement-spec`, `contract-tech-agnostic`); it makes sure whatever you ship
|
|
25
|
+
carries the official color and logo instead of an ad-hoc accent or a
|
|
26
|
+
re-created glyph.
|
|
27
|
+
|
|
28
|
+
The brand is defined in exactly one place — `team-web/packages/ui/theme.css`.
|
|
29
|
+
This skill mirrors it as data (`scripts/brand.py`) and assets (`assets/`), so a
|
|
30
|
+
generator imports one module and is automatically on-brand.
|
|
31
|
+
|
|
32
|
+
## The brand at a glance
|
|
33
|
+
|
|
34
|
+
- **Deep red `#d11a1a`** is the brand on white — the primary accent for
|
|
35
|
+
documents. **`#ff2d2d`** (the full Signal Red) is a bright secondary for
|
|
36
|
+
attention (and the primary on dark surfaces). Foreground on red is white. Red
|
|
37
|
+
is the *only* brand hue — no blues/greens.
|
|
38
|
+
- **Official logo** in `assets/`: `installagent-logo.svg` (icon + wordmark) and
|
|
39
|
+
`installagent-mark.svg` (icon only). Always the real logo, never a generic
|
|
40
|
+
glyph.
|
|
41
|
+
- Full token table, typography, and logo rules:
|
|
42
|
+
[`references/brand-tokens.md`](references/brand-tokens.md).
|
|
43
|
+
|
|
44
|
+
## What it produces
|
|
45
|
+
|
|
46
|
+
| Deliverable | Recipe | Output |
|
|
47
|
+
|---|---|---|
|
|
48
|
+
| **Branded Excalidraw** (red theme) | [`references/excalidraw-red-theme.md`](references/excalidraw-red-theme.md) | editable `.excalidraw` in the house red theme |
|
|
49
|
+
| **Branded PDF** (SOW, proposal, overview, one-pager) | [`references/branded-pdf.md`](references/branded-pdf.md) | client PDF with the official logo + brand red |
|
|
50
|
+
|
|
51
|
+
Both are driven by [`scripts/brand.py`](scripts/brand.py) — palette constants,
|
|
52
|
+
`logo_svg()`, an `Excalidraw` builder, and `pdf_css()` / `pdf_hero()` /
|
|
53
|
+
`render_pdf()` for WeasyPrint.
|
|
54
|
+
|
|
55
|
+
## How to use it
|
|
56
|
+
|
|
57
|
+
### Branded Excalidraw (red)
|
|
58
|
+
|
|
59
|
+
Build with `brand.Excalidraw()` so every element gets valid Excalidraw fields
|
|
60
|
+
and the right defaults (version 2, `roughness 0`, `fontFamily 2`). Map colors
|
|
61
|
+
per the table in `excalidraw-red-theme.md`: brand-red centerpiece, bright-red
|
|
62
|
+
attention/loops, neutral data boxes, brand-red table headers. Direction/status
|
|
63
|
+
ride on glyphs + weight, not a second color. For **layout** (stage columns,
|
|
64
|
+
emoji node names, client-vs-internal split) follow `client-workflow-diagram`;
|
|
65
|
+
this skill just supplies the skin.
|
|
66
|
+
|
|
67
|
+
### Branded PDF
|
|
68
|
+
|
|
69
|
+
`brand.pdf_hero(...)` emits the official logo (full lockup in the hero, icon in
|
|
70
|
+
the running header) and `brand.pdf_css()` supplies page setup, brand-red section
|
|
71
|
+
rules, brand-red table headers, callouts, and a running footer with page
|
|
72
|
+
numbers. Then `brand.render_pdf(body, out)` rasterizes via WeasyPrint. Content
|
|
73
|
+
discipline stays with `engagement-spec` (overviews/onboarding) and
|
|
74
|
+
`contract-tech-agnostic` (SOWs) — this skill only guarantees the brand.
|
|
75
|
+
|
|
76
|
+
### Verify before shipping
|
|
77
|
+
|
|
78
|
+
- Excalidraw: `python -m json.tool file.excalidraw` parses; opens at
|
|
79
|
+
excalidraw.com.
|
|
80
|
+
- PDF: render pages to PNG (`pdftoppm -png -r 110 out.pdf page`) and eyeball —
|
|
81
|
+
the official logo renders, the accent is brand red (not a stray blue), nothing
|
|
82
|
+
spills onto a near-empty page.
|
|
83
|
+
|
|
84
|
+
## Quality rules
|
|
85
|
+
|
|
86
|
+
- **Deep red `#d11a1a` (signal `#ff2d2d` for attention), official logo, every
|
|
87
|
+
time.** Never a generic glyph or an off-brand accent color. If you catch a
|
|
88
|
+
deliverable using a placeholder logo or a non-brand blue, fix it with this kit.
|
|
89
|
+
- **One hue.** Red + bright-red + neutrals only; carry semantics with glyphs and
|
|
90
|
+
weight.
|
|
91
|
+
- **Pull from the source, don't retype.** Import `scripts/brand.py`; never paste
|
|
92
|
+
a raw hex or re-draw the logo. If the brand changes, it changes in
|
|
93
|
+
`theme.css` → mirror here in the same pass.
|
|
94
|
+
- **No secrets / customer data / PII** in any diagram label or document
|
|
95
|
+
(root `AGENT.md`).
|
|
96
|
+
|
|
97
|
+
## Updating the brand
|
|
98
|
+
|
|
99
|
+
If `team-web/packages/ui/theme.css` changes the brand value, update
|
|
100
|
+
`scripts/brand.py` (the `BRAND` / `BRAND_BRIGHT` constants) and
|
|
101
|
+
`references/brand-tokens.md` in the same change, and re-export any committed
|
|
102
|
+
images. The logo assets here are copies of
|
|
103
|
+
`team-web/apps/docs/public/installagent-logo.svg` — re-copy if the logo changes.
|
|
104
|
+
|
|
105
|
+
## Before you finish — checklist
|
|
106
|
+
|
|
107
|
+
- [ ] Accent is deep red `#d11a1a` (signal `#ff2d2d` only for attention); no
|
|
108
|
+
other hue.
|
|
109
|
+
- [ ] Official logo used (PDF hero + running header); no generic glyph.
|
|
110
|
+
- [ ] Generator imports `scripts/brand.py` — no hard-coded hexes.
|
|
111
|
+
- [ ] Excalidraw validates / opens; PDF previewed as PNG.
|
|
112
|
+
- [ ] No secrets or customer data in labels; branding says Install Agent.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 182.975 39.98" overflow="visible"><g><g><defs><linearGradient id="installagent-logo-gradient" x1="0" x2="1" y1="0.4975124378109453" y2="0.5024875621890547"><stop offset="0" stop-color="rgb(155,5,6)" stop-opacity="1"/><stop offset="1" stop-color="rgb(253,34,33)" stop-opacity="1"/></linearGradient></defs><path d="M 58.404 6.675 C 58.158 3.373 55.17 0.553 51.861 0.421 C 36.914 -0.14 21.966 -0.14 7.018 0.421 C 3.707 0.553 0.72 3.373 0.473 6.675 C -0.158 15.541 -0.158 24.44 0.473 33.305 C 0.72 36.608 3.707 39.427 7.016 39.56 C 21.964 40.121 36.912 40.121 51.861 39.56 C 55.172 39.427 58.16 36.608 58.404 33.305 C 59.035 24.429 59.035 15.551 58.404 6.675 Z M 53.125 30.823 C 52.955 32.768 51.349 34.286 49.391 34.358 C 46.047 34.479 42.704 34.571 39.36 34.632 C 35.77 34.697 32.835 31.79 32.867 28.214 L 32.867 28.134 C 32.876 27.357 33.508 26.731 34.288 26.727 C 36.562 26.718 38.836 26.703 41.111 26.682 C 44.873 26.647 47.905 23.597 47.9 19.849 L 47.9 19.712 C 47.896 15.968 44.862 12.934 41.104 12.897 C 33.326 12.821 25.55 12.821 17.771 12.897 C 14.013 12.934 10.979 15.968 10.975 19.712 L 10.975 19.849 C 10.971 23.597 14.002 26.647 17.763 26.682 C 20.039 26.703 22.315 26.718 24.592 26.727 C 25.371 26.73 26.004 27.357 26.01 28.134 L 26.01 28.214 C 26.043 31.79 23.11 34.697 19.519 34.632 C 16.174 34.571 12.828 34.479 9.482 34.358 C 7.525 34.286 5.918 32.766 5.748 30.823 C 5.117 23.615 5.117 16.366 5.748 9.158 C 5.918 7.212 7.525 5.692 9.482 5.621 C 13.11 5.488 16.737 5.397 20.364 5.338 C 20.964 5.327 21.499 5.723 21.665 6.297 L 22.147 7.971 C 22.41 8.881 23.245 9.509 24.196 9.51 L 34.675 9.51 C 35.626 9.51 36.462 8.882 36.724 7.971 L 37.206 6.297 C 37.372 5.721 37.905 5.327 38.507 5.338 C 42.134 5.397 45.761 5.49 49.389 5.621 C 51.346 5.692 52.953 7.212 53.123 9.158 C 53.754 16.366 53.754 23.615 53.123 30.823 Z M 32.514 19.99 C 35.604 19.99 37.922 17.682 37.922 14.603 C 37.922 17.682 40.24 19.99 43.33 19.99 C 40.24 19.99 37.922 22.299 37.922 25.377 C 37.922 22.299 35.604 19.99 32.514 19.99 Z M 26.361 19.99 C 23.271 19.99 20.953 22.299 20.953 25.377 C 20.953 22.299 18.636 19.99 15.545 19.99 C 18.636 19.99 20.953 17.682 20.953 14.603 C 20.953 17.682 23.271 19.99 26.361 19.99 Z" fill="url(#installagent-logo-gradient)"/></g><path d="M 72.246 2.897 L 76.674 2.897 L 76.674 18.721 L 72.246 18.721 Z M 90.085 18.721 L 83.134 7.716 L 83.134 18.721 L 78.706 18.721 L 78.706 2.897 L 85.343 2.897 L 92.274 13.882 L 92.274 2.897 L 96.702 2.897 L 96.702 18.721 Z M 98.715 18.721 L 98.715 14.729 L 109.348 14.729 C 110.225 14.729 110.339 14.316 110.339 13.958 L 110.339 13.762 C 110.339 13.518 110.286 13.334 110.177 13.192 C 110.081 13.071 109.968 13.012 109.821 13.012 L 103.195 13.012 C 101.7 13.012 100.496 12.64 99.616 11.908 C 98.723 11.166 98.272 10.075 98.272 8.671 L 98.272 7.81 C 98.272 6.345 98.728 5.147 99.629 4.249 C 100.533 3.351 101.731 2.897 103.193 2.897 L 114.319 2.897 L 114.319 6.864 L 103.708 6.864 C 102.811 6.864 102.696 7.277 102.696 7.636 L 102.696 7.851 C 102.696 8.095 102.746 8.29 102.844 8.429 C 102.896 8.505 102.995 8.603 103.243 8.603 L 109.858 8.603 C 111.342 8.603 112.541 8.975 113.418 9.708 C 114.311 10.449 114.762 11.532 114.762 12.923 L 114.762 13.803 C 114.762 15.262 114.308 16.458 113.409 17.358 C 112.51 18.26 111.316 18.718 109.858 18.718 L 98.71 18.718 Z M 121.971 18.721 L 121.971 6.866 L 115.142 6.866 L 115.142 2.897 L 133.239 2.897 L 133.239 6.866 L 126.397 6.866 L 126.397 18.721 Z M 145.494 18.721 L 144.322 16.414 L 135.751 16.414 L 134.579 18.721 L 129.612 18.721 L 137.656 2.897 L 142.416 2.897 L 150.461 18.721 Z M 142.285 12.447 L 140.031 8.008 L 137.759 12.447 Z M 150.898 18.721 L 150.898 2.897 L 155.324 2.897 L 155.324 14.732 L 166.526 14.732 L 166.526 18.721 Z M 167.345 18.721 L 167.345 2.897 L 171.773 2.897 L 171.773 14.732 L 182.975 14.732 L 182.975 18.721 Z M 113.296 35.284 L 112.257 33.24 L 104.66 33.24 L 103.619 35.284 L 99.217 35.284 L 106.347 21.258 L 110.565 21.258 L 117.696 35.284 L 113.294 35.284 Z M 110.452 29.723 L 108.453 25.788 L 106.438 29.723 L 110.45 29.723 Z M 121.855 35.284 C 120.559 35.284 119.494 34.877 118.691 34.079 C 117.89 33.279 117.482 32.221 117.482 30.927 L 117.482 25.614 C 117.482 24.316 117.888 23.253 118.691 22.458 C 119.494 21.662 120.559 21.258 121.855 21.258 L 132.931 21.258 L 132.931 24.775 L 122.305 24.775 C 122.019 24.775 121.803 24.853 121.644 25.01 C 121.484 25.168 121.408 25.384 121.408 25.668 L 121.408 30.873 C 121.408 31.145 121.487 31.353 121.648 31.512 C 121.81 31.671 122.026 31.747 122.305 31.747 L 128.632 31.747 C 128.907 31.747 129.116 31.671 129.274 31.512 C 129.433 31.353 129.509 31.142 129.509 30.871 L 129.509 30.014 L 124.642 30.014 L 124.642 26.497 L 133.433 26.497 L 133.433 30.925 C 133.433 32.223 133.03 33.286 132.233 34.082 C 131.436 34.877 130.376 35.282 129.079 35.282 L 121.858 35.282 Z M 134.944 35.284 L 134.944 21.26 L 148.794 21.26 L 148.794 24.777 L 138.866 24.777 L 138.866 26.499 L 147.973 26.499 L 147.973 30.016 L 138.866 30.016 L 138.866 31.749 L 148.794 31.749 L 148.794 35.284 Z M 160.335 35.284 L 154.173 25.532 L 154.173 35.284 L 150.249 35.284 L 150.249 21.26 L 156.131 21.26 L 162.275 30.995 L 162.275 21.26 L 166.199 21.26 L 166.199 35.284 Z M 172.986 35.284 L 172.986 24.777 L 166.934 24.777 L 166.934 21.26 L 182.975 21.26 L 182.975 24.777 L 176.913 24.777 L 176.913 35.284 Z M 72.246 27.318 L 99.219 27.318 L 99.219 29.223 L 72.246 29.223 Z" fill="currentColor"/></g></svg>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 59.5 39.98" overflow="visible"><defs><linearGradient id="installagent-mark-gradient" x1="0" x2="1" y1="0.4975124378109453" y2="0.5024875621890547"><stop offset="0" stop-color="rgb(155,5,6)" stop-opacity="1"/><stop offset="1" stop-color="rgb(253,34,33)" stop-opacity="1"/></linearGradient></defs><path d="M 58.404 6.675 C 58.158 3.373 55.17 0.553 51.861 0.421 C 36.914 -0.14 21.966 -0.14 7.018 0.421 C 3.707 0.553 0.72 3.373 0.473 6.675 C -0.158 15.541 -0.158 24.44 0.473 33.305 C 0.72 36.608 3.707 39.427 7.016 39.56 C 21.964 40.121 36.912 40.121 51.861 39.56 C 55.172 39.427 58.16 36.608 58.404 33.305 C 59.035 24.429 59.035 15.551 58.404 6.675 Z M 53.125 30.823 C 52.955 32.768 51.349 34.286 49.391 34.358 C 46.047 34.479 42.704 34.571 39.36 34.632 C 35.77 34.697 32.835 31.79 32.867 28.214 L 32.867 28.134 C 32.876 27.357 33.508 26.731 34.288 26.727 C 36.562 26.718 38.836 26.703 41.111 26.682 C 44.873 26.647 47.905 23.597 47.9 19.849 L 47.9 19.712 C 47.896 15.968 44.862 12.934 41.104 12.897 C 33.326 12.821 25.55 12.821 17.771 12.897 C 14.013 12.934 10.979 15.968 10.975 19.712 L 10.975 19.849 C 10.971 23.597 14.002 26.647 17.763 26.682 C 20.039 26.703 22.315 26.718 24.592 26.727 C 25.371 26.73 26.004 27.357 26.01 28.134 L 26.01 28.214 C 26.043 31.79 23.11 34.697 19.519 34.632 C 16.174 34.571 12.828 34.479 9.482 34.358 C 7.525 34.286 5.918 32.766 5.748 30.823 C 5.117 23.615 5.117 16.366 5.748 9.158 C 5.918 7.212 7.525 5.692 9.482 5.621 C 13.11 5.488 16.737 5.397 20.364 5.338 C 20.964 5.327 21.499 5.723 21.665 6.297 L 22.147 7.971 C 22.41 8.881 23.245 9.509 24.196 9.51 L 34.675 9.51 C 35.626 9.51 36.462 8.882 36.724 7.971 L 37.206 6.297 C 37.372 5.721 37.905 5.327 38.507 5.338 C 42.134 5.397 45.761 5.49 49.389 5.621 C 51.346 5.692 52.953 7.212 53.123 9.158 C 53.754 16.366 53.754 23.615 53.123 30.823 Z M 32.514 19.99 C 35.604 19.99 37.922 17.682 37.922 14.603 C 37.922 17.682 40.24 19.99 43.33 19.99 C 40.24 19.99 37.922 22.299 37.922 25.377 C 37.922 22.299 35.604 19.99 32.514 19.99 Z M 26.361 19.99 C 23.271 19.99 20.953 22.299 20.953 25.377 C 20.953 22.299 18.636 19.99 15.545 19.99 C 18.636 19.99 20.953 17.682 20.953 14.603 C 20.953 17.682 23.271 19.99 26.361 19.99 Z" fill="url(#installagent-mark-gradient)"/></svg>
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Install Agent brand tokens
|
|
2
|
+
|
|
3
|
+
The single source of truth for the brand is
|
|
4
|
+
`team-web/packages/ui/theme.css`. The values below mirror it — if they ever
|
|
5
|
+
disagree, `theme.css` wins, and this file (plus `scripts/brand.py`) should be
|
|
6
|
+
updated in the same change.
|
|
7
|
+
|
|
8
|
+
## Color
|
|
9
|
+
|
|
10
|
+
The brand is the **Design System v1.0 Signal Red**. Documents live on white, so
|
|
11
|
+
the primary uses the system's *deep* red (legible on white); the full Signal Red
|
|
12
|
+
is the bright attention accent.
|
|
13
|
+
|
|
14
|
+
| Token | Hex | Use |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| **Brand red (deep)** | `#d11a1a` | The brand on white — headers, rules, the centerpiece, CTAs. (`--color-accent-deep`.) |
|
|
17
|
+
| Brand red (signal) | `#ff2d2d` | The full Signal Red (`--color-accent`). On documents, use sparingly for **attention/secondary** accents (alerts, "needs review", a second arrow); it's the primary on dark surfaces. |
|
|
18
|
+
| Brand foreground | `#ffffff` | Text/icons on top of brand red. |
|
|
19
|
+
| Brand tint | `#fdeaea` | Light red fill for callouts and header bands. (Derived, not in theme.css.) |
|
|
20
|
+
| Row tint | `#fbf2f2` | Zebra rows in tables. |
|
|
21
|
+
|
|
22
|
+
**Document neutrals** (text and lines on a white page). The dark neutrals in
|
|
23
|
+
`theme.css` (`#08080b`, etc.) are for the always-dark marketing site — **do not**
|
|
24
|
+
use them for client PDFs or diagrams.
|
|
25
|
+
|
|
26
|
+
| Token | Hex | Use |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| Ink | `#1f2430` | Headings, strong text. |
|
|
29
|
+
| Body | `#2b3440` | Body copy. |
|
|
30
|
+
| Muted | `#5b6675` | Secondary text. |
|
|
31
|
+
| Faint | `#8a93a0` | Captions, footers, placeholders. |
|
|
32
|
+
| Line | `#cfd5dd` | Card borders. |
|
|
33
|
+
| Grid | `#e8ebef` | Table gridlines. |
|
|
34
|
+
| Hairline | `#e4e8ee` | Section rules. |
|
|
35
|
+
| Soft | `#f4f6f9` | Neutral fills. |
|
|
36
|
+
|
|
37
|
+
**Rule of thumb:** red is the *only* brand color. Don't introduce a second hue
|
|
38
|
+
(no blues/greens) for semantics — use deep-red + signal-red + neutrals, and
|
|
39
|
+
lean on glyphs (↑ ↓ → ✓) and weight to carry meaning.
|
|
40
|
+
|
|
41
|
+
## Typography
|
|
42
|
+
|
|
43
|
+
- **Display + body**: `Hanken Grotesk`, then
|
|
44
|
+
`-apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif`. Hanken does
|
|
45
|
+
both — there's no separate display face.
|
|
46
|
+
- **Mono / eyebrow**: `JetBrains Mono` (`FONT_MONO`), for kickers and code-like
|
|
47
|
+
labels.
|
|
48
|
+
- Font files are loaded per-app; in a sandbox render they fall back to a system
|
|
49
|
+
sans/mono. That's fine — the weights/sizes/spacing carry the look.
|
|
50
|
+
- The full screen-side spec (sizes, weights, tracking) lives in the
|
|
51
|
+
`design-system` skill (`references/tokens.md`).
|
|
52
|
+
|
|
53
|
+
## Logo
|
|
54
|
+
|
|
55
|
+
Two official assets live in `../assets/` (copied from
|
|
56
|
+
`team-web/apps/docs/public/installagent-logo.svg`):
|
|
57
|
+
|
|
58
|
+
- **`installagent-logo.svg`** — full lockup (icon + "InstallAgent" wordmark).
|
|
59
|
+
The icon carries the red gradient (`rgb(155,5,6)` → `rgb(253,34,33)`); the
|
|
60
|
+
wordmark is `currentColor`, so set the surrounding text color (ink on light,
|
|
61
|
+
white on dark).
|
|
62
|
+
- **`installagent-mark.svg`** — icon only, for tight spaces / running headers /
|
|
63
|
+
favicons.
|
|
64
|
+
|
|
65
|
+
Rules:
|
|
66
|
+
- **Use the official logo, never a generic glyph or re-creation.**
|
|
67
|
+
- Keep clear space around it; don't recolor the icon gradient or stretch it.
|
|
68
|
+
- On a brand-red fill, use the wordmark in white (`#ffffff`).
|
|
69
|
+
|
|
70
|
+
`scripts/brand.py` exposes all of the above as constants plus `logo_svg()`,
|
|
71
|
+
so generators never hard-code a hex or re-draw the logo.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Branded PDFs — SOW, proposal, overview, one-pagers
|
|
2
|
+
|
|
3
|
+
How to produce client-facing PDFs that carry the official Install Agent logo and
|
|
4
|
+
brand red — not a generic glyph or an off-brand accent color. Rendering is
|
|
5
|
+
HTML/CSS → PDF via **WeasyPrint** (clean print CSS, real page numbers, running
|
|
6
|
+
header).
|
|
7
|
+
|
|
8
|
+
## Build with `scripts/brand.py`
|
|
9
|
+
|
|
10
|
+
```python
|
|
11
|
+
import sys; sys.path.append("<repo>/skills/installagent-brand-kit/scripts")
|
|
12
|
+
import brand
|
|
13
|
+
|
|
14
|
+
body = brand.pdf_hero(
|
|
15
|
+
kicker="Statement of Work & Proposal",
|
|
16
|
+
title="CarVision Pricing Agent — Phase 1",
|
|
17
|
+
sub="A daily used-car repricing co-pilot.",
|
|
18
|
+
meta_html='<div class="kicker" style="color:#8a93a0">June 16, 2026 · Confidential</div>',
|
|
19
|
+
)
|
|
20
|
+
body += "<h2><span class='n'>1</span>Summary</h2><p>…</p>" # your content
|
|
21
|
+
brand.render_pdf(body, "client-<slug>/.../Proposal.pdf")
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
- `pdf_hero()` emits the **official logo** (full lockup in the hero, icon-only in
|
|
25
|
+
the running header) — no generic mark. The wordmark is set to ink on white.
|
|
26
|
+
- `pdf_css()` provides page setup (Letter, margins), a running footer with
|
|
27
|
+
`Install Agent · Confidential` + `Page X of Y`, the brand-red `h2` rule and
|
|
28
|
+
`.kicker`, brand-red table headers, `.call.info` callouts, and signature
|
|
29
|
+
lines. Pass `accent=` only if a one-off needs a different accent (rare).
|
|
30
|
+
- `render_pdf()` sets `base_url` to the assets dir so the inline logo resolves.
|
|
31
|
+
|
|
32
|
+
## What "on-brand" means here
|
|
33
|
+
|
|
34
|
+
| Element | Before (generic) | Now (brand kit) |
|
|
35
|
+
|---|---|---|
|
|
36
|
+
| Logo | invented network glyph | official `installagent-logo.svg` |
|
|
37
|
+
| Accent | a blue (`#1d4ed8`) | deep red `#d11a1a` (signal `#ff2d2d`) |
|
|
38
|
+
| Table header | grey | brand red, white text |
|
|
39
|
+
| Headings | system bold | Hanken Grotesk, brand-red section rule |
|
|
40
|
+
|
|
41
|
+
## Page mechanics (handled by `pdf_css`)
|
|
42
|
+
|
|
43
|
+
- `@page` Letter, ~16–17 mm margins, running header (`element(rhead)`), footer
|
|
44
|
+
margin boxes for confidentiality + page numbers; `@page:first` hides the
|
|
45
|
+
running header on the cover.
|
|
46
|
+
- Convert from a self-contained HTML string; keep all CSS in `<style>` (no
|
|
47
|
+
external sheets) so the PDF is reproducible.
|
|
48
|
+
- Fonts: Hanken Grotesk (display + body) / JetBrains Mono when installed, else a
|
|
49
|
+
system fallback — the layout doesn't depend on the exact face.
|
|
50
|
+
|
|
51
|
+
## Install / render notes
|
|
52
|
+
|
|
53
|
+
- WeasyPrint: `pip install weasyprint --break-system-packages`.
|
|
54
|
+
- Preview before shipping: render pages to PNG (`pdftoppm -png -r 110 out.pdf
|
|
55
|
+
page`) and eyeball alignment, the logo, and that no block spills onto a near-
|
|
56
|
+
empty page.
|
|
57
|
+
|
|
58
|
+
## Quality rules
|
|
59
|
+
|
|
60
|
+
- **Official logo + brand red, every time.** Never the generic glyph or an
|
|
61
|
+
off-brand accent.
|
|
62
|
+
- Client-facing wording follows **contract-tech-agnostic** (SOWs) and
|
|
63
|
+
**engagement-spec** (overviews/onboarding) — this skill governs *brand*, those
|
|
64
|
+
govern *content*.
|
|
65
|
+
- Flag placeholders (`[legal entity]`, `[signatory]`) so they're filled before
|
|
66
|
+
sending.
|
package/templates/workspace-root/skills/installagent-brand-kit/references/excalidraw-red-theme.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Branded Excalidraw — the red house theme
|
|
2
|
+
|
|
3
|
+
How to produce `.excalidraw` diagrams in Install Agent's red theme. This pairs
|
|
4
|
+
with the **client-workflow-diagram** skill (which owns *layout* — left-to-right
|
|
5
|
+
stage columns, emoji node names). This file owns the *brand skin*: the palette
|
|
6
|
+
and the element conventions so the JSON opens cleanly and looks on-brand.
|
|
7
|
+
|
|
8
|
+
## Build with `scripts/brand.py`
|
|
9
|
+
|
|
10
|
+
Don't hand-write element JSON or invent colors — use the `Excalidraw` builder,
|
|
11
|
+
which sets every required field and the right defaults:
|
|
12
|
+
|
|
13
|
+
```python
|
|
14
|
+
import sys; sys.path.append("<repo>/skills/installagent-brand-kit/scripts")
|
|
15
|
+
import brand
|
|
16
|
+
from brand import BRAND, BRAND_BRIGHT, INK, MUTED, SOFT, WHITE, BRAND_TINT
|
|
17
|
+
|
|
18
|
+
d = brand.Excalidraw()
|
|
19
|
+
d.text(60, 24, "Diagram title", size=26, color=INK, bold=True)
|
|
20
|
+
d.rect(60, 80, 300, 64, stroke=brand.LINE, bg=SOFT) # neutral box
|
|
21
|
+
d.text(76, 96, "Step 1", size=13, color=BRAND, bold=True)
|
|
22
|
+
d.rect(60, 200, 560, 92, stroke=BRAND, bg=BRAND) # centerpiece
|
|
23
|
+
d.text(60, 224, "Scoring engine", size=16, color=WHITE, bold=True, align="center", w=560)
|
|
24
|
+
d.arrow([(360, 112), (360, 200)]) # connector
|
|
25
|
+
d.dump("<scratch>/<system>.excalidraw") # deck/legacy only — client repos use HTML diagrams in docs/
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
`dump()` writes valid Excalidraw JSON (version 2, `roughness 0`, `fontFamily 2`,
|
|
29
|
+
`source installagent.com`) and validates it parses.
|
|
30
|
+
|
|
31
|
+
## Color mapping (what gets which token)
|
|
32
|
+
|
|
33
|
+
| Element | Stroke | Fill | Text |
|
|
34
|
+
|---|---|---|---|
|
|
35
|
+
| **Centerpiece** (the "brain"/main step) | `BRAND` | `BRAND` | `WHITE` |
|
|
36
|
+
| Primary output (worklist, result) | `BRAND_BRIGHT` | `WHITE` | `BRAND` |
|
|
37
|
+
| Header band / container title | `BRAND` | `BRAND_TINT` | `BRAND` |
|
|
38
|
+
| Neutral step / data box | `LINE` | `SOFT` or `WHITE` | `INK` + `MUTED` sub |
|
|
39
|
+
| Table header row | `BRAND` | `BRAND` | `WHITE` |
|
|
40
|
+
| Zebra rows | `GRID` | `WHITE` / `ROW_TINT` | `INK` |
|
|
41
|
+
| Connectors | `MUTED` | — | — |
|
|
42
|
+
| Feedback / learning loop | `BRAND_BRIGHT`, **dashed** | — | `BRAND_BRIGHT` |
|
|
43
|
+
| Attention / "review" | `BRAND_BRIGHT` | — | `BRAND_BRIGHT` |
|
|
44
|
+
|
|
45
|
+
Direction and status ride on **glyphs + weight**, not extra colors:
|
|
46
|
+
`↑ +$700` (raise, ink bold), `↓ −$500` (drop, brand red), `→ hold` (muted),
|
|
47
|
+
`review` (bright red).
|
|
48
|
+
|
|
49
|
+
## Branded vs unbranded
|
|
50
|
+
|
|
51
|
+
- **Unbranded chart** (the usual ask for an editable working diagram): no logo,
|
|
52
|
+
no footer — just the flow in the red theme. Title text is fine; it's the
|
|
53
|
+
subject, not branding.
|
|
54
|
+
- **Branded board**: add the official mark via an exported PNG header, or pair
|
|
55
|
+
the `.excalidraw` with a branded PDF cover (see `branded-pdf.md`). Excalidraw
|
|
56
|
+
itself can't embed an SVG logo cleanly, so keep logos to the PDF/export layer.
|
|
57
|
+
|
|
58
|
+
## Tables and mock-ups
|
|
59
|
+
|
|
60
|
+
Sheet/email mock-ups (the "hero" pattern) are just rectangles + gridlines +
|
|
61
|
+
text: a `BRAND`-filled header row, `GRID` lines between columns/rows, `ROW_TINT`
|
|
62
|
+
zebra. Right-align money, center short codes, left-align names/notes. Keep the
|
|
63
|
+
`±`/decision columns colored per the table above.
|
|
64
|
+
|
|
65
|
+
## Quality rules
|
|
66
|
+
|
|
67
|
+
- Validate: `python -m json.tool <file>.excalidraw` parses; it opens at
|
|
68
|
+
excalidraw.com.
|
|
69
|
+
- Brand red is the only accent — no second hue.
|
|
70
|
+
- Use `brand.py` constants; never paste a raw hex.
|
|
71
|
+
- No real customer data / VINs / PII in labels — use illustrative samples.
|
|
72
|
+
- For layout/stage-column conventions and emoji node names, follow
|
|
73
|
+
**client-workflow-diagram**.
|