Pebellslearn by building
0%
RoadmapsMatrixCoursesSandboxSign in
Refinement  ›  Capstone Project

New Feature or Structural Change

New Feature / Structural Change 15 minFor new features and structural changes, get a plan covering files, data changes, steps and risks before any code, then build in checked, saved steps and recheck the whole product.

New Feature or Structural Change

Pantry Pal's users want to save favourite dinners and see them on any device. That means accounts, a new database table, new server routes and new screens. Asked for in one line, it would produce a diff too large to review, and possibly a change to stored data that cannot be undone.

The rule

Plan it first, agree the plan, then build it in checked steps.

A change is structural when it touches several parts of the app at once, changes how data is stored, or changes something many features rely on. Most new features are structural. For these, ask the assistant for a plan before any code:

  • Which files and parts change, and which new ones appear.
  • What changes in the data — new tables, renamed fields — and what happens to the data that already exists.
  • The order of steps, each ending in something you can check.
  • The risks, and how each step could be undone.

Read the plan like a brief in reverse: does it match what you asked for, and is anything missing or surprising? Fixing a plan costs a sentence. Fixing built code costs an afternoon.

Data changes deserve extra care. A commit can roll back code, but user data that was deleted or reshaped may not come back. Back it up first, and try the change on a copy of the database before the real one.

Expect the plan to change as you build. If step 2 reveals something the plan missed, stop, update the plan and then continue. Do not let the assistant quietly improvise a different design halfway through.

The shortcut

Plan → approve → slice → check → save. It is the slicing habit from generation, applied to an app people already use.

Adding saved favouritesStep 1 of 4
  1. Ask for a plan, no code

    "Plan how to add favourites that appear on any device. List the files, data changes, steps and risks. Do not write code yet."

Drills

Answer fast — trust the rule.

quick drill

Which change is structural?

quick drill

Why ask for a plan before any code?

quick drill

Why do changes to stored data need extra care?

quick drill

The favourites feature is built. What best confirms it did not break the rest of Pantry Pal?

Remember

  • Plan it first, agree the plan, then build it in checked steps.
  • Plan → approve → slice → check → save. Data changes get a backup and a trial on a copy.
  • Trap: a one-line request for a structural change, producing a diff and a data change nobody reviewed.

Practice — level up

0/1 solved

Write your answer, then compare it with a rubric and a model answer.

ExplainReview the plan

Pantry Pal will let flatmates share one pantry. Explain why this is a structural change, list what you would want the assistant's plan to cover before any code is written, and describe how you would build and check it.