본문으로 건너뛰기
cccskills
무료GitHub에 공개

avoid-feature-creep

Keeps a change scoped to what was asked. Flags extra features, refactors, and 'while we are here' edits, and moves them to a suggestions list instead of the diff. Use when a request is small and the agent is about to expand it, when a PRD grows beyond its problem statement, or when the user says 'just do what I asked'.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(4)

  • SKILL.md5.1 KB
  • agents/openai.yaml91 B
  • assets/large-logo.png3.2 KB
  • assets/small-logo.svg1.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Avoid feature creep

The request sets the scope. Everything the diff contains should trace back to a sentence in the ask. Anything else is a suggestion, not a change.

The core rule

Build what was asked. Not what would be nice, not what a senior engineer would also do, not what the codebase "should" have. If a line of the diff cannot be justified by the request, it does not belong in the diff.

This applies to product scope and to code scope. A PRD that grows past its problem statement has the same disease as a bug fix that ships with a refactor.

Signals that creep is starting

Stop when you notice any of these:

  • "While we're here" or "might as well" appears in your reasoning
  • Adding a config option, flag, or parameter for a case nobody asked about
  • Refactoring code adjacent to the change because it looked untidy
  • Adding a second feature to make the first one feel complete
  • Adding error handling for edge cases the user has never hit
  • Adding tests, types, or docs for code outside the change
  • Generalizing a one off into a reusable abstraction
  • Copying a competitor feature without a stated user need
  • A PRD section titled "Future" or "Nice to have" that keeps getting longer
  • The change touches a file the request never implied

Each of these might be a good idea. None of them are in scope unless the user says so.

What to do instead

  1. Finish the ask. Ship the smallest change that fully answers the request.
  2. Collect the extras as you go. Do not act on them.
  3. Put them in one place at the end:
    • In a chat or PR summary, under a Suggestions heading, one line each
    • In a PRD, under Out of scope with a one line reason
    • In a repo with a prds/ folder, append to the relevant PRD's Out of scope section
  4. Let the user pick. "The agent thought so" is not approval.

Suggestions are cheap to write and free to ignore. Unrequested code costs review time, adds bugs, and blurs what the change was for.

Stakeholders, including agents

Every feature request has a source: a PM, an exec, a user, a developer scratching an itch, or an AI coding agent. Treat them all the same way. Log the request, weigh it against the current scope, and defer it unless it solves the problem the work was started for.

AI agents are stakeholders now. They have opinions and they push. Common agent driven creep:

  • "Let me also add error handling for edge cases you haven't hit yet"
  • "This would be cleaner with a refactor"
  • "You should probably add tests for this"
  • "I added types for these additional scenarios"

If you are the agent, catch yourself doing this and move it to the suggestions list. If you are working with an agent, state the scope at the start of the session and treat its extras like any other stakeholder ask.

Before adding anything, ask:

  • Does this solve the problem the request named?
  • What is the smallest version that works?
  • What happens if we never build it?

If the first answer is no, it goes in suggestions.

Before and after

Request: "Add a deletedAt field to tasks and hide deleted tasks from the list query."

Before, the creeping version:

  • Added deletedAt to the schema
  • Added a by_user_and_deleted index
  • Rewrote list to use the index
  • Added softDelete, restore, and purgeDeleted mutations
  • Added a cron to purge after 30 days
  • Renamed list to listActive and updated three call sites
  • Added a showDeleted argument "for the admin view later"

After, the scoped version:

  • Added deletedAt: v.optional(v.number()) to the schema
  • Added the index and pointed list at it so deleted rows never load

Summary sent with the change:

Done: deletedAt field and list query now skips deleted tasks.

Suggestions
- A softDelete mutation to set deletedAt (nothing sets it yet)
- A restore mutation
- A cron to purge rows older than 30 days
- An admin flag on list to include deleted rows

Two lines of diff answered the request. Four lines of suggestions preserved every idea. The user decides what happens next.

PRDs

A PRD earns each section by pointing back to its problem statement. When a PRD grows:

  • Reread the problem statement. Cut anything that does not serve it.
  • Move cut items to Out of scope with one reason each.
  • If the cut items form a coherent feature, that is a second PRD, not a bigger first one.

Checklist

  • Every changed file is implied by the request
  • No new config options, flags, or parameters the request did not ask for
  • No refactors of adjacent code
  • No second feature added to round out the first
  • No tests, types, or docs added for code outside the change
  • Extras are listed under Suggestions in the summary or Out of scope in the PRD
  • The summary says what was done in one line before the suggestions
  • If the user said "just do what I asked", the diff contains only that

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

convex

무료

Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for scheduling. Use when a task mentions Convex and no more specific skill matches, or as the first stop before picking one.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

Builds AI agents on the Convex agent component: threads, messages, tools that call queries and mutations, streaming, RAG with vector search, and workflows for multi step jobs. Use when adding a chat assistant, tool calling agent, or retrieval feature to a Convex app.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

Production patterns for Convex apps and the rules the @convex-dev/eslint-plugin enforces: validators, indexes, idempotent mutations, avoiding OCC conflicts, thin function wrappers, error handling. Use when reviewing Convex code, asking whether a pattern is right, setting up ESLint, or fixing write conflicts and slow queries.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

Creates reusable Convex components with defineComponent, a clean client wrapper, their own schema, and an npm publish setup. Use when extracting a feature into a package, building something for the Convex component directory, or when a component's functions are not showing up in the parent app.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

Schedules work in Convex: cron jobs in convex/crons.ts, one off scheduled functions with runAfter and runAt, batching large jobs, and cancelling or inspecting the queue. Use when something needs to run on a timer, later, or in the background, or when a cron is not firing.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

Handles files in Convex: upload URLs, storing blobs from actions, serving with getUrl or an HTTP action, metadata from the _storage table, and deletion. Use when users upload images or documents, when an action fetches a file from a third party, or when a file URL expires unexpectedly.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

waynesutton/builder-skills4062026년 9월 28일 업데이트

waynesutton의 스킬 모두 보기

이 스킬의 문제 신고