From 8316c8a1bf306e9942c7cfb2e5b442a5fafbfe26 Mon Sep 17 00:00:00 2001 From: Gabriel Brown Date: Thu, 5 Nov 2026 16:51:31 -0500 Subject: [PATCH] Drop the rule that left starting dev servers to the user --- user/agents/AGENTS.md | 2 -- user/agents/skills/prototype/SKILL.md | 10 ++++------ 2 files changed, 4 insertions(+), 8 deletions(-) diff --git a/user/agents/AGENTS.md b/user/agents/AGENTS.md index 02f1241..0b54d97 100644 --- a/user/agents/AGENTS.md +++ b/user/agents/AGENTS.md @@ -18,8 +18,6 @@ I wanted to share some of my preferences here so we can be more aligned as we wo - Tests are good! Endless smoke tests, "regression tests" for feature deletions, etc, much less good. Tests should be focused. Not slop. - Comments are a great way to clarify functionality & how code is used. Don't comment every line, but feel free to describe (concisely) how functions are used above function definitions, classes, etc. - Keep all comments and documentation up to date! When making changes, it is important to keep everything in sync. -- Avoid starting long running dev servers by default; assume the user may already have one running unless the task requires otherwise. - - If the user does not have a dev server running, or if you need to restart the dev server, ask the user to do so. ## TypeScript Preferences diff --git a/user/agents/skills/prototype/SKILL.md b/user/agents/skills/prototype/SKILL.md index cbff206..d613521 100644 --- a/user/agents/skills/prototype/SKILL.md +++ b/user/agents/skills/prototype/SKILL.md @@ -40,16 +40,14 @@ an implementation with extra steps. routing and file conventions; invent no new top-level structure. 2. **Trivial to run.** A UI prototype is one URL. A logic demo is one file that opens on a double-click. No thinking required to start it. -3. **Do not start a dev server yourself.** Assume one may already be running. Where the prototype - needs a server that is not up, or needs a restart, ask rather than starting it. -4. **No persistence by default.** State lives in memory. Persistence is usually the thing being +3. **No persistence by default.** State lives in memory. Persistence is usually the thing being *checked*, not something to depend on. Where the question genuinely involves the database, point at a scratch one named so nobody mistakes it. -5. **Skip the polish.** No tests, no error handling beyond what makes it run, no abstractions. A +4. **Skip the polish.** No tests, no error handling beyond what makes it run, no abstractions. A prototype that needs tests has stopped being a prototype. -6. **Surface the state.** After every action, or on every variant switch, render the full relevant +5. **Surface the state.** After every action, or on every variant switch, render the full relevant state so the change is visible. -7. **Answer one question.** No "what if we also wanted X later". +6. **Answer one question.** No "what if we also wanted X later". ## Capture it when the answer arrives