shipsmooth

a simple, powerful coding workflow

shipsmooth is an AI assistant plugin that gives you a simple yet powerful workflow for coding.

The demo below shows how, using an actual session: 1. You discuss and ask it to make a plan 2. It breaks the plan into tasks 3. You launch the codegen 4. Oops. Something looks wrong! 5. You pause the codegen 6. You update the plan (agent updates tasks) 7. Resume execution 8. Stop and go home 😊 9. Come back the next day!

How to Install

For Claude Code:

  1. Inside your Claude Code session, type: 
    /plugin marketplace add bitkentech/claude-plugins
/plugin install shipsmooth@bitkentech
  2. Restart Claude Code, because the plugin needs to run some code at session start
  3. In the new Claude Code session type: 
    /shipsmooth:start
That's it! Happy planning, tasking and building 😊

For Gemini CLI:

$ gemini extensions install https://github.com/bitkentech/shipsmooth-gemini

FAQ

1. How is shipsmooth different?

It assumes you'll be coding against a plan file, but also accounts for the fact that the plan will keep evolving 😊! For example, see Version 1 of this plan where file-based task tracking was being added, but eventually that plan went on to Version 3, because the project's structure needed to be modified. It's impossible to come up with a perfect plan upfront!

2. How does it manage changes to a plan file?

Plan files are checked into version control after manual review. Each plan file update is also tagged in git for future lookups: plan-13-v1, plan-13-v3 etc. Fine-grained tasks are created from the plan, and execution begins. The status of these tasks is also stored in version control (or optionally a separate issue tracker).

3. How do you manage the churn in tasks when a plan is changed?

Since the tasks for a plan are tracked in an XML file (Linear is also supported), new tasks can be added and existing ones updated.

4. How to stop and resume a development session?

You just do a /shipsmooth:start in your new coding session. Since both plans and task state are being tracked, you'll resume from exactly where you'd left off.

5. Anything else?

Here's the full SKILL.md. shipsmooth brings in one opinionated aspect: tasks are generated with principles from Agile and Spiral model in mind. That means:

  • Tasks aim to be vertical slices of work / functionality.
  • You prefer to develop and validate a basic version of the feature before doubling down on code quality and test coverage.
  • You'll pick up the riskiest / unknown pieces of work first, in order to avoid nasty surprises down the line.