addyosmani avatar

Incremental Implementation

This is the discipline that prevents you from writing 500 lines across eight files and then spending two hours debugging which change broke everything. It forces you to build in thin vertical slices: implement the smallest complete piece, run the tests, verify it works, commit it, then move to the next slice. The source includes practical slicing strategies (vertical slices for full stack features, contract-first when backend and frontend develop in parallel, risk-first to validate uncertainty early) and hard rules like keeping the build green between increments and using feature flags for incomplete work. The increment checklist is straightforward: one thing per commit, tests pass, build succeeds, functionality verified. Most valuable when you're touching multiple files or feel tempted to write more than 100 lines before testing.

skills.sh installs
71K
GitHub stars
114.6K
last updated
Aug 21, 2026

Install

$ npx -y skills add addyosmani/agent-skills --skill incremental-implementation --agent claude-code

Installs into .claude/skills of the current project.

Files

Incremental Implementation

Overview

Build in thin vertical slices — implement one piece, test it, verify it, then expand. Avoid implementing an entire feature in one pass. Each increment should leave the system in a working, testable state. This is the execution discipline that makes large features manageable.

When to Use

  • Implementing any multi-file change
  • Building a new feature from a task breakdown
  • Refactoring existing code
  • Any time you're tempted to write more than ~100 lines before testing

When NOT to use: Single-file, single-function changes where the scope is already minimal.

The Increment Cycle

┌──────────────────────────────────────┐
│                                      │
│   Implement ──→ Test ──→ Verify ──┐  │
│       ▲                           │  │
│       └───── Commit ◄─────────────┘  │
│              │                       │
│              ▼                       │
│          Next slice                  │
│                                      │
└──────────────────────────────────────┘

For each slice:

Sponsors

Details

Repository
github.com/addyosmani/agent-skills
Category
AI & Agent Building
First seen
Apr 16, 2026

More from addyosmani/agent-skills

All 25
1addyosmani avataridea-refineaddyosmani/agent-skillsRefines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress68.3Kskills.sh installs
2addyosmani avatarshipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a 67.4Kskills.sh installs
3addyosmani avatarsource-driven-developmentaddyosmani/agent-skillsGrounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when buildi67.4Kskills.sh installs
4addyosmani avatarci-cd-and-automationaddyosmani/agent-skillsAutomates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test run67.3Kskills.sh installs
5addyosmani avatarinterview-meaddyosmani/agent-skillsExtracts what the user actually wants instead of what they think they should want. Achieves this through one-question-at-a-time interview until ~95% confidence 66.4Kskills.sh installs
6addyosmani avatardeprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when decid66.4Kskills.sh installs