@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.
Files changed (94) hide show
  1. package/dist/agent-templates.d.ts +90 -0
  2. package/dist/agent-templates.js +211 -0
  3. package/dist/client-build.d.ts +50 -0
  4. package/dist/client-build.js +155 -0
  5. package/dist/client-context.d.ts +40 -0
  6. package/dist/client-context.js +70 -0
  7. package/dist/client-drive.d.ts +67 -0
  8. package/dist/client-drive.js +278 -0
  9. package/dist/client-intake.d.ts +68 -0
  10. package/dist/client-intake.js +189 -0
  11. package/dist/client-linear.d.ts +30 -0
  12. package/dist/client-linear.js +85 -0
  13. package/dist/docs-search.d.ts +44 -0
  14. package/dist/docs-search.js +187 -0
  15. package/dist/doctor.d.ts +43 -0
  16. package/dist/doctor.js +425 -0
  17. package/dist/env-file.d.ts +25 -0
  18. package/dist/env-file.js +69 -0
  19. package/dist/env-fill.d.ts +43 -0
  20. package/dist/env-fill.js +161 -0
  21. package/dist/env-push.d.ts +37 -0
  22. package/dist/env-push.js +137 -0
  23. package/dist/env-registry.d.ts +49 -0
  24. package/dist/env-registry.js +230 -0
  25. package/dist/exec.d.ts +14 -0
  26. package/dist/exec.js +16 -0
  27. package/dist/fathom-webhook.d.ts +44 -0
  28. package/dist/fathom-webhook.js +123 -0
  29. package/dist/fs-utils.d.ts +9 -0
  30. package/dist/fs-utils.js +34 -0
  31. package/dist/gcp-service-account-key.d.ts +37 -0
  32. package/dist/gcp-service-account-key.js +66 -0
  33. package/dist/gemini-api-key.d.ts +47 -0
  34. package/dist/gemini-api-key.js +132 -0
  35. package/dist/git.d.ts +16 -0
  36. package/dist/git.js +29 -0
  37. package/dist/github-token.d.ts +24 -0
  38. package/dist/github-token.js +30 -0
  39. package/dist/index.d.ts +25 -0
  40. package/dist/index.js +28 -0
  41. package/dist/init.d.ts +47 -0
  42. package/dist/init.js +101 -0
  43. package/dist/linear-project.d.ts +81 -0
  44. package/dist/linear-project.js +192 -0
  45. package/dist/new-client.d.ts +32 -0
  46. package/dist/new-client.js +89 -0
  47. package/dist/ping.d.ts +6 -0
  48. package/dist/ping.js +7 -0
  49. package/dist/portal-admin.d.ts +133 -0
  50. package/dist/portal-admin.js +144 -0
  51. package/dist/sync-templates.d.ts +58 -0
  52. package/dist/sync-templates.js +109 -0
  53. package/dist/template-sync.d.ts +55 -0
  54. package/dist/template-sync.js +90 -0
  55. package/dist/templates.d.ts +19 -0
  56. package/dist/templates.js +24 -0
  57. package/dist/wizard.d.ts +78 -0
  58. package/dist/wizard.js +213 -0
  59. package/package.json +30 -0
  60. package/templates/env.example +60 -0
  61. package/templates/workspace-root/.claude/settings.json +39 -0
  62. package/templates/workspace-root/AGENT.md +205 -0
  63. package/templates/workspace-root/AGENTS.md +11 -0
  64. package/templates/workspace-root/CLAUDE.md +63 -0
  65. package/templates/workspace-root/GEMINI.md +24 -0
  66. package/templates/workspace-root/ONBOARDING.md +164 -0
  67. package/templates/workspace-root/README.md +67 -0
  68. package/templates/workspace-root/skills/CLAUDE.md +79 -0
  69. package/templates/workspace-root/skills/client-deliverables/SKILL.md +131 -0
  70. package/templates/workspace-root/skills/client-deliverables/references/package-layout.md +103 -0
  71. package/templates/workspace-root/skills/client-facing-docs/SKILL.md +131 -0
  72. package/templates/workspace-root/skills/client-facing-docs/references/doc-structures.md +81 -0
  73. package/templates/workspace-root/skills/client-llm-setup/SKILL.md +97 -0
  74. package/templates/workspace-root/skills/client-llm-setup/references/guide-template.md +87 -0
  75. package/templates/workspace-root/skills/client-workflow-diagram/SKILL.md +141 -0
  76. package/templates/workspace-root/skills/client-workflow-diagram/references/excalidraw-format.md +140 -0
  77. package/templates/workspace-root/skills/contract-tech-agnostic/SKILL.md +99 -0
  78. package/templates/workspace-root/skills/contract-tech-agnostic/references/Install_Agent_SOW_Template.docx +0 -0
  79. package/templates/workspace-root/skills/design-system/SKILL.md +118 -0
  80. package/templates/workspace-root/skills/design-system/references/tokens.md +139 -0
  81. package/templates/workspace-root/skills/engagement-spec/SKILL.md +272 -0
  82. package/templates/workspace-root/skills/engagement-spec/references/spec-templates.md +220 -0
  83. package/templates/workspace-root/skills/house-voice/SKILL.md +158 -0
  84. package/templates/workspace-root/skills/house-voice/references/source-copy.md +173 -0
  85. package/templates/workspace-root/skills/ia-cli/SKILL.md +87 -0
  86. package/templates/workspace-root/skills/installagent-brand-kit/SKILL.md +112 -0
  87. package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-logo.svg +1 -0
  88. package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-mark.svg +1 -0
  89. package/templates/workspace-root/skills/installagent-brand-kit/references/brand-tokens.md +71 -0
  90. package/templates/workspace-root/skills/installagent-brand-kit/references/branded-pdf.md +66 -0
  91. package/templates/workspace-root/skills/installagent-brand-kit/references/excalidraw-red-theme.md +73 -0
  92. package/templates/workspace-root/skills/installagent-brand-kit/scripts/brand.py +175 -0
  93. package/templates/workspace-root/skills/linear/SKILL.md +186 -0
  94. 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.
@@ -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**.