Personalize module

[bpmct]

A discussion dedicated to the Personalize module. Share your thoughts, questions, and feedback here.

Module Scorecard

Presentation & Onboarding	Credential Hygiene	Restricted-Environment Readiness	Engineering Quality	Overall
8 / 25	N/A	N/A	7 / 10	43 / 100

Drilldown

Presentation & Onboarding — 8 / 25

Criterion	Max	Score	Notes
Configuration-mode examples	12	6	Single basic example provided showing minimal usage with count, source, version, and agent_id. No examples of different configuration modes or customization of path or log_path variables. Earns half credit.
Coder-context framing	8	2	README states "Run a script on workspace start that allows developers to run custom commands to personalize their workspace" but does not explain what this adds on top of Coder's base functionality or how Coder fits in the flow. Minimal context. Earns quarter credit (rounded to 2).
Visual preview	5	0	No image, GIF, or video present in README. Icon reference does not count.

Credential Hygiene — N/A

No credentials or secrets are used by this module. All criteria in this theme are N/A.

Restricted-Environment Readiness — N/A

This module downloads or installs nothing; it only executes a user-provided script via coder_script. All download-related criteria (Mirrorable artifact source, Bring-your-own binary, Egress transparency) are N/A. The run.sh script never invokes sudo and runs entirely as the user, but since the module has no installation or download concerns, Runs without sudo is also N/A per the rubric's construction-based exclusion logic.

Engineering Quality — 7 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All three variables (agent_id, path, log_path) have clear descriptions and sensible defaults. agent_id is required as expected. No validation blocks present, but none are strictly necessary for these string inputs. Full credit.
Test coverage	4	1	TypeScript test in main.test.ts covers one end-to-end scenario (warns without personalize script). No .tftest.hcl file present. Minimal coverage of business logic (does not test executable script path, actual script execution, or log output). Earns quarter credit (rounded to 1).

Overall — 43 / 100

Raw 15 / 35 → round(15 / 35 × 100) = 43

---

Scored against SCORECARD.md on 2026-08-03 with claude-sonnet-4-5.