Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/alwkala/tidyfactor-design/briefgit clone --depth 1 https://github.com/alwkala/tidyfactor-designWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/alwkala/tidyfactor-design/brief)<a href="https://agentmods.dev/commands/alwkala/tidyfactor-design/brief"><img src="https://agentmods.dev/badge/commands/alwkala/tidyfactor-design/brief.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.01281 |
| Opus 5 | $0.00000 | $0.00641 |
| Sonnet 5 | $0.00000 | $0.00256 |
| Haiku 4.5 | $0.00000 | $0.00128 |
Grade A, and why
brief scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 108 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Command: brief — Design Context Gate & Fit Test
Runtime entry point for establishing design context before any build begins. Part of the Discovery lifecycle phase.
When to use
- Always before
init,page,dashboard, orcomponents— the brief ensures the design has intention, not defaults. - After
studyif a reference was analyzed. - Whenever a design request lacks context ("build me a landing page" without audience/tone/purpose).
The 3-Question Design-Context Gate
Question 1: Audience
Who is the primary audience, and what is their emotional state when they arrive?
Why it matters: A B2B decision-maker comparing vendors arrives in evaluate mode (needs tables, specs, trust signals). A luxury buyer arrives in aspire mode (needs atmosphere, restraint, desire). The same "landing page" requires completely different design DNA.
Classify into:
| Mode | Characteristics | Design implications |
|---|---|---|
| Inspire | Browse, dream, aspirate | Atmospheric, generous whitespace, cinematic motion, minimal text |
| Evaluate | Compare, decide, justify | Data-forward, specs tables, social proof, clear pricing |
| Act | Purchase, sign up, convert | Friction-free, prominent CTA, trust signals, minimal distraction |
| Learn | Study, explore, understand | Content-rich, good typography, navigation, readable hierarchy |
Question 2: Use Case / Surface Type
What kind of surface is this?
| Surface | Layout suggestions | Foundation fit |
|---|---|---|
| Marketing landing page | film, story, minimal (from memory/13-layout-archetypes.md) |
native, tailwind |
| Product / e-commerce | product, store |
tailwind, daisyui |
| Dashboard / app screen | Use dashboard command |
native, shadcn |
| Documentation / content | Use page command with editorial school |
native, pico |
| Real estate / spatial | space |
tailwind |
| Personal brand / portfolio | creator |
native, pico |
Question 3: Tone / Design School
What emotional register should the design communicate?
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 108 lines · 0 tokens per session scan A 37c11e2ddbb9
brief is a command published in the GitHub repository alwkala/tidyfactor-design (5 stars, last pushed 1mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,281 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other commands, from other repositories
github-issue
Create a GitHub issue from a natural language description.
test
Hello world test command.
critique-screen
Run all seven visual critiques on a screen and output a prioritised fix list.
critique-ux
Run a focused UX critique on a screen — affordances, information density, and hierarchy — and output a prioritised fix list.
design-onboarding
Design a first-run experience end to end — activation path, progressive disclosure, and time to first value.
frame-problem
Structure an ambiguous design challenge into a clear problem definition with constraints and criteria.